SitefinderOracle and Sun

Oracle HCTS System Administration Portal
HCTS 4.0 Getting Started Guide
Print-friendly VersionPrint-friendly Version

HCTS 4.0 Getting Started Guide


3. USB, Storage, CD/DVD, CPU/Memory, Floppy, Audio, and Video Test Environment Setup

Table of Contents

In this chapter:


Machine Requirement

USB, Storage, CD/DVD, floppy, audio, and video component testing requires one test machine.


Hardware Requirements

To use HCTS, the test system must meet the following hardware requirements:

  • Floating point — The test system must have hardware floating point support.

  • Free space — The test system must have at least the following amount of free space:

    • Swap space is at least 1/8 of physical memory size (Minimum 512MB).

    • At least 4 GB of free space in any single Solaris slice or a non-reserved hard disk larger than 16 GB.

      Use the following command to check free space:

      $ df -h

    A non-reserved disk does not contains any slice mounted to/, /usr, /var, or /export/home*.

For USB device certification, the test system must meet the following hardware requirements:

  • For USB hard disk and solid state storage device certification, the device to be certified must have at least 128 MB of free space.

  • For USB CD/DVD reader certification, a mixed-mode CD must be utilized. You can use make_mixed_mode_cd utility (Available under /opt/SUNWhcts/bin) to create one mixed-mode CD that qualifies for helping the certification. See the HCTS man page for more information.

  • For USB CD writer certification, a re-writable CD should be inserted in the drive under test. For USB DVD writer certification, any supported re-writable media should be inserted.

  • For USB CD/DVD writer certification, a minimum of 600 MB of free space is needed in /export/home directory for each device to be certified.

Caution - For Storage certification, USB hard disk and solid state storage certification, if the test system contains more than one disk drive, any disk that does not have any slice mounted to /, /usr, /opt, /var, or /export/home* is formatted. All data on such a disk is lost. During the test initialization process, any disk that is scheduled to be formatted is listed. The initialization process pauses for 60 seconds and prompts you to stop the certification if you do not want the disk to be formatted.

Caution - For CD/DVD writer certification and USB CD/DVD writer certification, the disc inserted into the writer will be erased during testing and all data on the disc will be lost. Make sure you use a disc that does not contain any data for this certification.


Software Requirements

The test system must be running the following software:

Solaris OS

Any Solaris 10 release or Solaris Express Developer Edition release can be used with HCTS 4.0. The Solaris 10 6/06 or later release is required if you want to certify CD-RW or DVD-RW devices.

If your system is already running the Solaris 10 OS or the Solaris Express Developer Edition OS, you might want to perform a fresh reinstall before you install the HCTS.

For USB device certification, the test system must meet the following software requirements:

  • For USB CD/DVD reader certification and USB CD/DVD writer certification, Solaris OS 6/06 or later version must be installed on SUT. Latest Solaris OS release is recommended.

HCTS

Before you download the HCTS 4.0 archive file, create a download directory on the test system. When you are prompted for the download location, provide the name of this directory that you created.

You can download HCTS from http://www.oracle.com/webfolder/technetwork/hcl/hcl/hcts/index.html#download.


One-System Setup

Make sure Xwindows is running on the test system.


Installing the Solaris OS

For Solaris 10 installation details, see the Release and Installation Collection for the particular Solaris 10 release that you want to install. Start with the Installation Guide: Basic Installations. For Solaris Express Developer Edition installation details, see Solaris Express Developer Edition Installation Guide. For additional help with Solaris OS installation, see the Solaris OS Install web site.

Use the following command to verify that you are running the Solaris 10 OS or the Solaris Express Developer Edition OS:

% cat /etc/release

If you are installing the Solaris 10 OS, you must make the following customization:

  • Select “None” for “Name Service”.

  • Select 'Initial Install” for “Upgrade or Initial Install”.

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

For Solaris 10 installation or Solaris Express Developer Edition installation, partition the disk to satisfy the Hardware Requirements stated above.

You might want to back up your test systems and reinstall the Solaris OS before you install and run the HCTS.


Installing the HCTS Application

Extracting the HCTS File Content

The HCTS 4.0 archive is a tar file from which you need to extract the contents. The name of the downloaded file is hcts.4.0.tar.gz.

Enter the following command to extract the HCTS contents:

$ gzip -cd hcts.4.0.tar.gz | tar xvf -

The contents are extracted into a directory called hcts.4.0, which is placed in the directory where you downloaded HCTS. This hcts.4.0 directory contains the following files:

  • hcts.4.0.README

  • hcts.4.0.ReleaseNotes

  • SUNWhcts package

Installing HCTS

Be sure to read the hcts.4.0.README and hcts.4.0.ReleaseNotes documents in the /hcts_extract_dir/hcts.4.0 directory before you install HCTS.

Installation verifies that no previous version of HCTS is on your system. If HCTS is already installed on this system, uninstall the existing version.

Perform the following steps to install HCTS:

% su
# /usr/sbin/pkgadd -d . SUNWhcts

Watch for any questions or error messages and respond accordingly.

The HCTS installation performs the following actions:

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

  • Installs the package SUNWhcts into the /opt directory.

  • Installs the x11perf binary file into /usr/X11/demo/.

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

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


Running the HCTS Application

If you are going to certify your CD-ROM or DVD-ROM drive for compatibility with the Solaris OS, insert a mixed-mode CD into the drive of the test system. Use the make_mixed_mode_cd utility to create a mixed-mode CD.

If you are going to test your CD-RW or DVD-RW drive for compatibility with the Solaris OS, insert a CD-RW, DVD-RW, DVD+RW, or DVD-RAM disc into the drive of the test system.

If you are going to test your floppy drive for compatibility with the Solaris OS, insert a writable floppy diskette into the drive of the test system.

If you are going to certify/test a USB device, make sure to connect it to SUT and power it according to the instructions provided in the device's user guide.

If you are going to certify a USB CD/DVD reader, insert a mixed-mode CD before you start the certification. You can use make_mixed_mode_cd utility to create a mixed-mode CD. See HCTS 4.0 man page for more information.

If you are going to certify a USB CD/DVD writer, prepare all types of re-writable media supported by the device, certify them one by one and then submit all your results.

Using the GUI

To start the HCTS GUI, use the HCTS command:

$ /usr/bin/hcts

On the Test Manager system, if you are prompted to select a Mode for this machine, click the Test Manager button. HCTS will set up the network environment to make this system an HCTS Test Manager System.

On the System Under Test, if you are prompted to select a Mode for this machine, click the System Under Test button.

Click the Certification Center tab and then the Component Certification tab. Select Storage (Network and Serial testing require a Test Manager system as well as a System Under Test). Click the Start button.

The Component Certification Page

When testing is finished, click the Results tab and click the Latest Certification Result tab. Click the name of the test in the table to view the detailed results for that test. Click the View Summary File link to view the summary of the results of all tests listed in the table.

To test a component but not certify the component, click the Certification Center tab and then click the Component Tests tab. Select CPU/Memory, USB Audio or Floppy. Click the Start button.

Component Tests Page

To run other tests, click the Certification Center tab and then click the Custom Test Plan tab. Select the test you want to run. Click the Start button.

Custom Test Plan Page

Using the CLI

To start the HCTS command line interface, use the hctscli command. See the hctscli(1M) man page for more information.

Enter the following command to run the storage certification test suite:

# /usr/bin/hctscli certify Storage

If no device is specified for the certify storage command, then all storage devices are certified at the same time.

See the man page for the names of component certification test suites that you can run and more examples.

Note - After you complete all testing, uninstall HCTS. Before you put the test systems back into production use, you might want to reinstall your test system to its original configuration.


Global Options

In HCTS 4.0, there are three global options that you can use in GUI and CLI. These global options are:

  • Exit On Error - When this option is set, HCTS exits immediately when any test case fails. The test environment will not be cleaned.

  • Manual Network Setup - When this options is set, user should configure the IP addresses for the network interfaces to be tested before starting the HCTS test. See the HCTS 4.0 man page for more information.

  • Diagnosis - When this option is set, a few DTrace scripts run in parallel with test cases to collect information for debugging. This option should only be used for failure analysis. Certification with this option set is not qualified for HCL submission.


Custom Test Plan

The Custom Test Plan feature provides an interface for creating test plans which may provide additional failure diagnostics information. Custom Test Plan results are not valid for HCL submission.

Tunable Options permit the customization of various predefined test arguments. By modifying the values of these options, you can control the exposed runtime attributes for the Test Case operating on the associated device.

For more information, see the Custom Test Plan online help page under Certification Center > Custom Test Plan.


Unless otherwise licensed, code in all technical manuals herein (including articles, FAQs, samples) is provided under this License.


Oracle - The Information Company