Oracle Hardware Certification Test Suite: 5.7 User Guide


Table of Contents

Chapter 3

Installing Oracle HCTS

Before installing Oracle HCTS, ensure that the Oracle Solaris 10 OS or Oracle Solaris 11 OS is installed and running. You might need to do a few configurations when installing Oracle Solaris 10 OS or the Oracle Solaris 11 OS. This chapter explains the installation and configuration of OS and Oracle HCTS for certifying various types of devices.

This chapter covers the following sections.

Configuring the Oracle Solaris 10 OS Installation

For Oracle Solaris 10 installation details, see the Oracle Solaris 10 Release and Installation Collection web page.

While installing the Oracle Solaris 10 OS, partition the disk to satisfy the requirements mentioned in Chapter 2, System Requirements.

To verify whether you are running the Oracle Solaris 10 OS or the Oracle Solaris 11 OS, type the following command.

# cat /etc/release

While installing the Oracle Solaris 10 OS, you must make the following customization in the GUI prompt.

  • Select None for Name Service.

  • Select Initial Install for Upgrade or Initial Install.

  • Select Custom Install and then select Developer group or above. You must perform at least a Developer group installation. See the Oracle Solaris 10 Package List for a list of what you get with different types of installations.

You might have to backup your test systems and reinstall the Oracle Solaris OS before you install and run Oracle HCTS.

Configuring the Oracle Solaris 11 OS Installation

While installing the Oracle Solaris 11 OS, partition the disk to satisfy the requirements mentioned in Chapter 2, System Requirements.

For the Oracle Solaris 11 OS installation details, see the Oracle Solaris 11 OS Installation Guide.

Installing the Oracle HCTS Application

For certifying system, network, InfiniBand, WiFi, network performance and serial I/O devices, install Oracle HCTS on both TM and SUT.

For certifying USB, storage, CD/DVD, audio, and video devices or testing CPU/Memory, storage performance, Suspend/Resume, install Oracle HCTS on SUT.

For certifying External Storage devices, install Oracle HCTS on four machines. For more information, see Chapter 5, External Storage Certification.

For Solaris 10 OS, the Oracle HCTS 5.7 archive is a tar file from which you need to extract the contents.

For Oracle Solaris 11 OS, there are two methods to install Oracle HCTS 5.7. The first is similar to Solaris 10 OS where Oracle HCTS 5.7 archive is a tar file from which you need to extract the contents. The second one is installing Oracle HCTS from the Image Packaging System (IPS) repository as shown in To Install from IPS Repository.

This section describes the following topics.

To Extract the Oracle HCTS File Content

  • To extract the Oracle HCTS contents, type the following command.
    # gzip -cd hcts.5.7.tar.gz | tar xvf -
    • If you are working on the SPARC platform the package is hcts.5.7-sparc.tar.gz. To extract the contents of this package, type the following command. 
      # gzip -cd hcts.5.7-sparc.tar.gz | tar xvf -

      The contents are extracted to a directory called hcts.5.7 or hcts.5.7-sparc, which is placed in the directory where you downloaded Oracle HCTS. This hcts.5.7 or hcts.5.7-sparc directory contains the following files.

      • Oracle HCTS 5.7 README

      • Oracle HCTS 5.7 Release notes

      • Oracle HCTS 5.7 ThirdPartyLicenseReadMe

      • SUNWhcts package

    Note - Be sure to read the Oracle HCTS 5.7 README and Oracle HCTS 5.7 Release notes in the /hcts_extract_dir/hcts.5.7 directory before you install Oracle HCTS.

    Installation verifies that no previous version of Oracle HCTS exists on your system. If Oracle HCTS is already installed on the system, uninstall the existing version using procedures mentioned in Uninstalling Oracle HCTS

To Install Oracle HCTS

  1. Log in as a root by using the su command.
    # su
  2. To add the Oracle HCTS package, type the following command.
    # /usr/sbin/pkgadd -d . SUNWhcts

    Watch for any questions or error messages and respond accordingly. The Oracle HCTS installation performs the following functions.

    • Verifies that no version of Oracle HCTS is already installed on the system.

    • Installs the package SUNWhcts in the /opt directory.

    • Installs the x11perf binary file in the /usr/X11/demo/ directory.

    • Installs the x11perf.1x man page file in the /usr/X11/share/man/man1 directory for the video test case.

    • Creates a /docs directory in the /opt/SUNWhcts directory.

To Install from IPS Repository

The steps to use the HCTS ISO file for installing SUNWhcts package are as follows. Note that platformD represents the platform of your system (for example, SPARC or X64) and versionN represents the HCTS version number.

  1. Log in as a root by using the su command.
    # su
  2. Mount the ISO image as a filesystem by using any one of the following command.
    # mount -F hsfs <full_path_to>/hcts-platformD-versionN.iso /mnt

    or

    # mount -F hsfs -o ro `lofiadm -a <full_path_to>/hcts-platformD-versionN.iso` /mnt
  3. Add an additional origin to the existing Solaris publisher.
    # pkg set-publisher -g file:///mnt/repo hcts
  4. Perform the installation of HCTS packages.
    # pkg install pkg://hcts/diagnostic/SUNWhcts
  5. Before starting HCTS, ensure to run these steps without exception.
    # umount -f  /mnt
# /opt/SUNWhcts/bin/reconfigure

Installing the Oracle HCTS InfiniBand HCA Application

This section describes the following topics.

To certify an InfiniBand Host Channel Adapter (HCA), you must install the Oracle HCTS InfiniBand HCA application and the Oracle HCTS application on the TM and SUT systems.

Extracting the Oracle HCTS InfiniBand HCA File Content

The Oracle HCTS 5.7 IB HCA archive is a tar file from which you need to extract the contents. The name of the downloaded file is hcts.5.7.ib-${ARCH}.tar.gz. The ${ARCH} value represents the processor type, that is SPARC or i386. For example, the IB HCA package for x86 platform is named as hcts.5.7.ib-i386.tar.gz.

To extract the Oracle HCTS InfiniBand HCA file content, type the following command on each machine.

# gzip -cd hcts.5.7.ib-$(ARCH).tar.gz | tar xvf -

The contents are extracted to a directory called hcts.5.7.ib-${ARCH}, which is placed in the directory where you have downloaded the Oracle HCTS InfiniBand HCA.

The hcts.5.7.ib-${ARCH} directory contains the following files.

  • hcts.5.7.ib.README

  • SUNWstc-infiniband-ibtf package

  • SUNWstc-dtet package

Installing the SUNWstc-infiniband-ibtf Package

Be sure to read the hcts.5.7.ib.README in the /hcts_extract_dir/hcts.5.7.ib-${ARCH} directory before you install the SUNWstc-infiniband-ibtf package. Installation verifies that no previous version of the SUNWstc-infiniband-ibtf exists on your system. If SUNWstc-infiniband-ibtf is already installed on the system, uninstall the existing version.

On each system, perform the following steps to install the SUNWstc-infiniband-ibtf package.

  1. Log in as a root by using the su command.

    # su

  2. Add the SUNWstc-infiniband-ibtf package.

    # /usr/sbin/pkgadd -d . SUNWstc-infiniband-ibtf

Watch for any questions or error messages from the installation and respond accordingly. The SUNWstc-infiniband-ibtf installation performs the following actions.

  • Verifies that no version of the SUNWstc-infiniband-ibtf is already installed on the system.

  • Installs the package SUNWstc-infiniband-ibtf into the /opt directory.

Installing the SUNWstc-dtet Package

Be sure to read hcts.5.7.ib.README in the /hcts_extract_dir/hcts.5.7.ib-${ARCH} directory before you install the SUNWstc-dtet package. Installation verifies that no previous version of the SUNWstc-dtet is on your system. If SUNWstc-dtet is already installed on this system, uninstall the existing version manually.

On each system, perform the following steps to install the SUNWstc-dtet package.

  1. Log in as a root by using the su command.

    # su

  2. Add the SUNWstc-dtet package.

    # /usr/sbin/pkgadd -d . SUNWstc-dtet

Watch for any questions or error messages from the installation and respond accordingly. The SUNWstc-dtet installation performs the following actions.

  • Verifies that no version of the SUNWstc-dtet is already installed on the system.

  • Installs the package SUNWstc-dtet into the /opt directory.

Installing the Oracle HCTS SCSI Test For External Storage Certification

You should install the Oracle HCTS SCSI test package and the Oracle HCTS application on both the TM and the SUT systems to certify External Storage. This section describes the following procedures.

Extracting the Oracle HCTS SCSI Test File Content

The Oracle HCTS 5.7 SCSI test archive is a tar file from which you need to extract the contents. The name of the downloaded file is hcts.5.7.tscsi-${ARCH}.tar.gz. The ${ARCH} value represents the processor type, that is SPARC or x86. For example, the SCSI test package for x86 platform is named as hcts.5.7.tscsi-x86.tar.gz.

To extract the Oracle HCTS SCSI test file content, type the following command on each machine.

# gzip -cd hcts.5.7.tscsi-${ARCH}.tar.gz | tar xvf -

The contents are extracted to a directory called SUNWtscsi, which is placed in the directory where you have downloaded the Oracle HCTS SCSI test package. The SUNWtscsi directory contains the SUNWtscsi package.

Installing the SUNWtscsi Package

Installing the SUNWtscsi package verifies that no previous version of the SUNWtscsi package exists on your system. If SUNWtscsi is already installed on the system, uninstall the existing version.

On each system, perform the following steps to install the SUNWtscsi package.

  1. Log in as a root by using the su command.

    # su

  2. Add the SUNWtscsi package.

    # /usr/sbin/pkgadd -d . SUNWtscsi

Check for any questions or error messages from the installation and respond accordingly. The SUNWtscsi installation performs the following actions.

  • Verifies that no version of the SUNWtscsi is already installed on the system.

  • Installs the package SUNWtscsi into the /opt directory.

Installing the Oracle HCTS FMA Test Packages

You should install the Oracle HCTS FMA test packages on the SUT system, and the Oracle HCTS application on both the TM and the SUT systems to test FMA. The Oracle HCTS FMA test packages include SUNWstc-os-ldfma, SUNWstc-tetlite and SUNWstc-netperf2 packages. The SUNWstc-os-ldfma and SUNWstc-tetlite packages are for storage or NIC FMA test, and the SUNWstc-netperf2 package is for NIC FMA test. This section describes the following topics:

Extracting the Oracle HCTS FMA Test File Content

The Oracle HCTS 5.7 FMA test archive is a tar file from which you need to extract the contents. The name of the downloaded file is hcts.5.7.fma-${ARCH}.tar.gz. The ${ARCH} value represents the processor type, that is, SPARC or x86. For example, the FMA test package for x86 platform is named as hcts.5.7.fma-x86.tar.gz.

To extract the contents of Oracle HCTS FMA test file, type the following command on the SUT system:

# gzip -cd hcts.5.7.fma-${ARCH}.tar.gz | tar xvf -

The contents are extracted to a directory called hcts.5.7.fma-${ARCH}, which is placed in the directory where you have downloaded the Oracle HCTS FMA test package.

The hcts.5.7.fma-${ARCH} directory contains the following files.

  • SUNWstc-os-ldfma package

  • SUNWstc-tetlite package

  • SUNWstc-netperf2 package

Installing the SUNWstc-os-ldfma Package

Installing the SUNWstc-os-ldfma package verifies that no previous version of the SUNWstc-os-ldfma package exists on your system. If SUNWstc-os-ldfma package is already installed on the system, uninstall the existing version.

On each system, perform the following steps to install the SUNWstc-os-ldfma package.

  1. Log in as a root. Type:

    # su

  2. Add the SUNWstc-os-ldfma package. Type:

    # /usr/sbin/pkgadd -d . SUNWstc-os-ldfma

    The SUNWstc-os-ldfma package is installed in the /opt directory.

Check for any questions or error messages from the installation and respond accordingly. The SUNWstc-os-ldfma installation performs the following actions.

  • Verifies that no version of the SUNWstc-os-ldfma is already installed on the system.

  • Installs the package SUNWstc-os-ldfma into the /opt directory.

Installing the SUNWstc-tetlite Package

Installing the SUNWstc-tetlite package verifies that no previous version of the SUNWstc-tetlite package exists on your system. If SUNWstc-tetlite package is already installed on the system, uninstall the existing version.

On each system, perform the following steps to install the SUNWstc-tetlite package.

  1. Log in as a root. Type:

    # su

  2. Add the SUNWstc-tetlite package. Type:

    # /usr/sbin/pkgadd -d . SUNWstc-tetlite

    The SUNWstc-tetlite package is installed in the /opt directory.

Check for any questions or error messages from the installation and respond accordingly. The SUNWstc-tetlite installation performs the following actions.

  • Verifies that no version of the SUNWstc-tetlite is already installed on the system.

  • Installs the package SUNWstc-tetlite into the /opt directory.

Installing the SUNWstc-netperf2 Package

Installing the SUNWstc-netperf2 package verifies that no previous version of the SUNWstc-netperf2 package exists on your system. If SUNWstc-netperf2 package is already installed on the system, uninstall the existing version.

On each system, perform the following steps to install the SUNWstc-netperf2 package.

  1. Log in as a root. Type:

    # su

  2. Add the SUNWstc-netperf2 package. Type:

    # /usr/sbin/pkgadd -d . SUNWstc-netperf2

    The SUNWstc-netperf2 package is installed in the /opt directory.

Check for any questions or error messages from the installation and respond accordingly. The SUNWstc-netperf2 installation performs the following actions.

  • Verifies that no version of the SUNWstc-netperf2 is already installed on the system.

  • Installs the package SUNWstc-netperf2 into the /opt directory.

Uninstalling Oracle HCTS

Before you put the test systems back into production use, you might want to reconfigure your test system to its original configuration. If you choose not to reinstall your test systems, you must uninstall Oracle HCTS.

Perform the following steps to uninstall Oracle HCTS from your system.

  1. Log in as a root by using the su command.

    # su

  2. If Oracle HCTS was installed by IPS repository, remove the SUNWhcts package by typing the following command.

    # /usr/bin/pkg uninstall SUNWhcts

    If Oracle HCTS was installed by tar file, remove the SUNWhcts package by typing the following command.

    # /usr/sbin/pkgrm SUNWhcts

    E-mail this page E-mail this page    Printer View Printer View