UnixWare 7 HBA Testsuites (hbacert)












UnixWare 7 HBA Testsuites

The hbacert package contains test and certification suites used to test SDI HBA and target drivers with their associated hardware.

For current information about the entire UnixWare/OpenServer Hardware Development Kit (HDK) release, see the HDK Release Notes.

Note: Documentation references on this page link to the Product Documentation. They are also available on your local system when the BASEman, HDKdoc, and HDKman packages are installed.

System requirements

The hbacert suite requires a UnixWare 7 system with the following packages installed:

base
Base Operating System, commands and utilities
acp
Enhanced Application Compatibility
uccs
UDK Optimizing C Compilation System

Individual tests have additional prerequisites for the hardware being tested; see For more information.

This package cannot be installed on OpenServer systems. Similar test suites are provided for OpenServer SCSI drivers in the O5hbacert package.

Installation

To install the package from:

downloaded files

  1. Log in as root.
  2. Download the package to an installation directory; for example, /tmp.
  3. Use the pkgadd(1M) command to install it by entering:
    pkgadd  -d  /tmp/hbacert

media distribution

  1. Log in as root.
  2. Insert the CD-ROM in the drive
  3. Use the pkgadd(1M) command to install it by entering:
    pkgadd  -d  cdrom1  hbacert

Major revisions

The major changes since HDK Release 7.0.0:

  • The HBA Certification Requirements Checklist, which provides a clear process for IHVs to follow in getting their drivers certified, is included under the testsuites/doc directory (under the hbacert $HOME directory, which is by default /home/hbacert). The online documentation describes the new process and how to use the checklist. Even those vendors not seeking formal certification by are advised to follow the requirements checklist when testing drivers for SCO platforms. Since this is a new process, we recommended that you check the HDK web site for updates to the checklist.
  • All tests have been revised for this release to address customer reported problems and improve performance.
  • The SCSI pass-through tests now use the library interface (new to UnixWare 7 Release 7.1.0).
  • The test source code is included in the hbacert installation directory. This test source is included for reference purposes only and is not intended to allow customers to build the tests. See the individual test directories under the hbacert $HOME/testsuites directory for the scripts used to run the tests.

Known limitations

Please observe the following limitations when running the hbacert software:
  • Running more than one invocation of any of the Certification Test Suites on the same machine may lead to unexpected and unpredictable results.
  • Only the HDK 7.1 CDROM should be used as the input test pattern CD for the cdrom tests. The HDK 7.1 CDROM test pattern will not work with older (pre-7.1) versions of hbacert.
  • We recommend 150M tape drive for the multiple-volume cpio test. High capacity drives (e.g., DLT drives) are not recommended at this time because of performance issues.

For more information

For complete information on configuring and running the HBA certification tests, refer to the SCOhelp documentation on your local system ( Testing and debugging HBA drivers) or on the Product Documentation web site ( Testing and debugging HBA drivers). A copy of the SCOhelp HDK documentation is also available for browsing directly off the HDK CD; see the top-level files on the CD for more information.