Chapter 1 Hardware Certification Test Suite Installation
This installation guide provides the steps necessary to install the Hardware
Certification Test Suite (HCTS) application on your system. The instructions are broken
down into the following sections:
Note –
If you have already downloaded the HCTS package and extracted the package
contents, you can skip to Installing the HCTS Application.
Downloading the HCTS Package
Download the HCTS 2.3 package from the following web site:
http://www.sun.com/bigadmin/hcl/hcts
This site provides a link to the Sun Download Center, which enables you to register
and download the HCTS package.
Before downloading the HCTS 2.3 package, create a download directory on the
test machine on which you want to install HCTS. When prompted for the download location,
provide the name of this directory.
Extracting the HCTS Package Contents
The HCTS 2.3 package is a tar file from which you need
to extract the package contents. The name of the downloaded file is hcts.2.3.tar.gz.
How to Extract HCTS Package Contents
Step
-
Extract the HCTS package contents.
$ gzip -cd hcts.2.3.tar.gz|tar
xvf -
The package contents are extracted into a directory called hcts.2.3, which is placed in the directory where you downloaded the HCTS
package. This hcts.2.3 directory contains the following:
-
install.hcts script
-
uninstall.hcts script
-
hcts.2.3.README
-
hcts.2.3.ReleaseNotes
-
SUNWhcts package
-
SUNWstaf package
Note –
You must copy the downloaded hcts.2.3.tar.gz file
to each machine that you want to test. For network and serial I/O controllers, copy
the file to both the single-processor and dual-processor test machines (System Configuration
I and System Configuration II). For storage controllers, copy the file to the dual-processor
test system configured for your technology. For more information, refer to the test
plan for your type of controller. Perform the installation instructions provided below
on each machine that you want to test.
Installing the HCTS Application
Use the following procedure to install the HCTS application on your test system.

Caution –
Installing HCTS on your test machine creates a security issue. During
the installation process, the installation script executes an xhost + command
that opens up access to your system. HCTS should only be installed on a non-production
system on a private network.
How to Install HCTS
Steps
-
Change to the hcts.2.3 directory.
-
Become superuser.
$ su
-
Run the installation script.
# ./install.hcts
-
Press Enter when prompted by the installation script.
Watch
for any error messages and respond to any prompts accordingly.
The installation
script verifies that no previous version of HCTS is on your system. If an old version
of HCTS is installed, go to Uninstalling the HCTS Application.
What Happens During the Installation Process
The installation script performs a number of actions while installing HCTS on
your system. Some of these actions includes the following:
-
Verifying that no previous version of HCTS is installed on the system
-
Installing the packages SUNWhcts and SUNWstaf into the /opt directory
-
Setting up an anonymous FTP server for the network tests carried out
during System and Network controller certification testing
-
Creating a /docs directory within the /opt/SUNWhcts directory
Where to Go From Here
After you have successfully installed HCTS on your test system, you can start
certifying your system. Refer to the following materials to perform the certification
tasks:
-
Hardware Certification Test Suite Release Notes (hcts.2.3.ReleaseNotes file in the hcts.2.3 directory)
-
Hardware Certification
Test Suite 2.3 User’s Guide
-
Certification Test Plans (/opt/SUNWhcts/docs/TestPlans)
-
Automated Test ReadMe files (/opt/SUNWhcts/docs/ReadMes)
All of these documents provide information about various steps in the certification
process. For complete information about the SolarisTM Operating
System x86 Platform Edition Certification Program, go to the
HCTS web site:
http://www.sun.com/bigadmin/hcl/hcts
Note –
Before beginning any network controller certification, you must disable
NIS.
Note –
After the completing the certification process, reinstall your test system
to its original configuration to remove any changes that might have been introduced
by the certification process.
Uninstalling the HCTS Application
Use the following procedure to uninstall HCTS (Version 2.0 or 2.3) from your
test system.
How to Uninstall HCTS
Steps
-
Become superuser
$ su
-
Change to directory where the uninstall.hcts command
is located.
-
Run the uninstall.hcts script.
# ./uninstall.hcts