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:

• Downloading the HCTS Package

• Extracting the HCTS Package Contents

• Installing the HCTS Application

• Uninstalling the HCTS Application

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

1. 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.

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

1. Change to the hcts.2.3 directory.

2. Become superuser.

   $ su

3. Run the installation script.

   # ./install.hcts

4. 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 Solaris^TM Operating System x86 Platform Edition Certification Program, go to the HCTS web site:

http://www.sun.com/bigadmin/hcl/hcts

Before beginning any network controller certification, you must disable NIS.

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

1. Become superuser

   $ su

2. Change to directory where the uninstall.hcts command is located.

3. Run the uninstall.hcts script.

   # ./uninstall.hcts