System Requirements
The system requirements for certification by using Oracle HCTS depends on the hardware or the system to be tested. This chapter explains in detail the hardware and software requirements for each type of system and hardware certification.
This chapter contains the following information.
Certifying System, Network, InfiniBand, InfiniBand SR-IOV Virtual Functions, Suspend/Resume, Network Performance Serial I/O Devices and NIC FMA Devices
To certify system, network, InfiniBand, Suspend/Resume, network performance and serial I/O devices, configure two test machines, TM and SUT. This section explains the hardware and software requirements to certify system, network, InfiniBand, and serial I/O devices.
Hardware Requirements
TM and SUT systems must meet the following hardware requirements.
Network - Both systems must be nonproductive systems on an isolated network segment. Network certification might generate a flood of traffic on other systems in the network.
Free space - Each system must have at least (number-of-network-ports) x (1.5 GB) free space in the /export/home directory.
Type the following command to verify this requirement.
# df -h
Serial cable - For serial I/O testing only. A serial cable must connect the serial port of the TM with that of the SUT.
InfiniBand switch - For InfiniBand and InfiniBand SR-IOV Virtual Functions testing only. An InfiniBand cable must connect the InfiniBandHCA ports of the TM and SUT systems to the InfiniBand switch. InfiniBand SR-IOV Virtual Functions testing requires primary domain as SUT and logical domain as TM. InfiniBand SR-IOV Virtual Functions need to be added in primary domain and logical domain before testing. For more information on how to use InfiniBand SR-IOV Virtual Functions, see Using InfiniBand SR-IOV Virtual Functions in Oracle VM Server for SPARC 3.1 Administration Guide.
SUT should satisfy the following hardware requirements.
Floating point - The SUT must have hardware floating point support. To check whether the SUT processor has floating point support, type psrinfo -v in the terminal. If the output sentence contains the phrase, and has an i387 compatible floating point processor, the processor has the floating point support.
Free space - With the free space requirement for both systems, the SUT must have the following free space:
Swap space of at least 1/8 the physical memory size (a minimum 512 Mbytes).
At least 4 Gbytes of free space in any single Oracle Solaris slice or a non reserved hard disk larger than 16 GBytes.
Type the following command to check free space.
# df -h
A non reserved disk does not contain any slice mounted to the following directories, /, /usr, /opt, /var, or /export/home*.
Network - The SUT must have at least one port. Each port on the SUT must be connected to the TM system. For InfiniBand HCA certification, at least one port on the SUT must be connected to the TM system.
Network Performance - The SUT must have meet the Uperf tool requirement.
At least one USB storage disk, an audio play and record device, and one USB or built-in web camera attached to the SUT machine.
Caution - For system certification, if the SUT 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 waits for 60 seconds and prompts you to stop the certification if you do not want the disk to be formatted.
TM should satisfy the following hardware requirements.
Network - The TM system must have one functional network port for each network port on the SUT. The TM system must have at least as many network ports as that of the SUT. Each port on the SUT must be connected to the TM system. The TM system must not have more than five ports than that of the SUT. For InfiniBand HCA certification, at least one port on the SUT must be connected to the TM system.
Network Performance - The TM system must have meet the Uperf tool requirement.
You also require an InfiniBand switch for testing InfiniBand. The Infiniband switch is required to connect the InfiniBand HCA port of the TM to that of the SUT.
Software Requirements
For certifying the system, network, InfiniBand, Suspend/Resume, network performance and serial I/O devices, configure TM and SUT.
You can choose any of the following configurations.
The test environment must consist of only one TM system and a SUT in an isolated network segment. Additional systems must be tested separately.
If your TM system or your SUT matches the following description, you must disable NIS.
The Oracle Solaris OS is installed on the machine and you do not reinstall the Oracle Solaris OS before running Oracle HCTS.
NIS is set up and enabled on the machine.
You disconnect the machine from another network and reconnect it to the isolated network segment of the test environment.
In the above mentioned conditions, if you do not disable NIS, the system behaves abnormally due to inconsistent network settings.
Type the following command to disable NIS.
# /usr/lib/netsvc/yp/ypstop
This command disables NIS until the next reboot.
To permanently disable NIS, type the following command.
# svcadm disable svc:/network/nis/client:default
Ensure that XWindows is running on the SUT.
If you are certifying either your system, network, Suspend/Resume, network performance, or serial I/O, ensure that the TM system is correctly connected to the SUT in the following manner.
All the ports in the SUT must be correctly connected to the TM system. No port should be left unconnected on the SUT. For the network component certification, all the ports of the network component must be connected to the TM System. For serial I/O certification, at least one port must be connected to the TM System.
Connect TM and SUT back-to-back by using a crossover cable or a private switch. Oracle HCTS assigns a particular range of IP addresses to the TM system and a different range of IP addresses to the SUT system. Network devices on the TM system must allow their IP addresses to be temporarily changed to 10.10.n.11/24, where n is 10, 11, 12... for multiple ports. Network devices on the SUT must allow their IP addresses to be temporarily changed to 10.10.n.10/24, where n is 10, 11, 12... for multiple ports. All the network devices between the TM system and the SUT must allow these IP addresses.
If you have routers, intelligent switches, gateways, or VLAN between the TM system and the SUT, configure them to enable the IP addresses that are specified above.
For serial I/O certification, set up the serial ports. Ensure that at least one pair of serial ports is connected between the TM system and the SUT.
Note - For the tests that require TM, make sure the following services are available on both SUT and TM.
svc:/network/physical:default svc:/network/shell:default svc:/network/ftp:default svc:/network/rpc/spray:default svc:/network/nfs/client:default svc:/network/nfs/mapid:default
Use svcs command to check the service availability, use pkg command to install the missing services. For the package names of the missing services, refer to the following mapping table.
svc name
Package name
svc:/network/physical:default
system/network
svc:/network/shell:default
service/network/legacy-remote-utilities
svc:/network/ftp:default
service/network/ftp
svc:/network/rpc/spray:default
service/network/spray
svc:/network/nfs/client:default
system/file-system/nfs
svc:/network/nfs/mapid:default
system/file-system/nfs
Make sure that the TM system is properly connected to the SUT. If you are doing InfiniBand HCA certification, TM is connected to SUT through the network and InfiniBand switch.
Make sure that the TM system is correctly connected to the SUT in the following manner.
Each port of the InfiniBand HCA to be certified must have one dedicated InfiniBand switch to connect. Each InfiniBand switch involved in the test process must connect to one port of the TM system.
At least one network port on the SUT must be connected to a port on the TM system.
Note - In this release of Oracle HCTS, InfiniBand HCA certification can certify only one InfiniBand HCA at a time. If more than one InfiniBand HCA has a driver in Oracle Solaris, none of them can be certified.
The Oracle Solaris 11 OS is required for the Suspend/Resume test. You need to perform both manual and the automatic tests and fill the test results in the Suspend/Resume Checklist in the Appendix B.
If you are testing network performance, please make sure uperf is installed on the System Under Test (SUT) and the Test Manager system (TM).
Also, a configuration file must be generated to show where the uperf is installed on SUT and TM. The expected format of the file is as follows.
sut_uperf_install_path tm_uperf_install_path
For example, /opt/uperf /opt/uperf
The configuration file must be saved as /opt/SUNWhcts/etc/uperf_path.conf
Make sure the system configuration meets the uperf requirement. For detailed description for uperf, refer uperf website.
If you are testing NIC FMA test, please make sure the Test Manager system (TM) must be able to be rsh as root.
Certifying USB, Storage, Storage performance, CD/DVD, CPU or Memory, Audio, Tape Drive, Video, Performance Monitor and Storage FMA Devices
For certifying USB, storage, CD/DVD, CPU or memory, audio, tape drive and video devices, only the SUT is required. This section explains the hardware and the software requirements for certifying USB, storage, CD/DVD, CPU/Memory, audio, and video devices.
Hardware Requirements
SUT should satisfy the following hardware requirements.
Hardware floating point support.
The SUT must have at least the following amount of free space.
Swap space is at least 1/8 of the physical memory size, minimum 512 Mbyte.
At least 4 Gbyte of free space on any Oracle Solaris system slice or a non reserved hard disk that is greater than 16 Gbyte.
Type the following command to check free space.
# df -h
A non reserved disk is a disk which does not contain any slice mounted to the /, /usr, /opt, /var, or /export/home* directory.
For USB device certification, the SUT must meet the following hardware requirements.
For USB hard disk, solid state storage device, and multimedia card reader certification, the device to be certified must have at least 128 Mbyte of free space.
For USB CD/DVD reader certification, a mixed-mode CD must be used. You can use the make_mixed_mode_cd utility under the /opt/SUNWhcts/bin directory to create a mixed-mode CD that can be used for the certification. See the Oracle HCTS man page for more information.
For USB CD writer certification, a rewritable CD should be inserted in the drive under test. For USB DVD writer certification, any supported rewritable media should be inserted.
For USB CD/DVD writer certification, a minimum of 600 Mbyte of free space is needed in the /export/home directory for each device to be certified.
For performance monitor test, make sure the SUT has at least one non-reserved disk.
For Storage FMA test, please make sure there are at least 2 storage controllers and 2 disks, where one disk is running Oracle Solaris OS under one storage controller which can NOT test against, and the other disk is under the other storage controller which is test against.
Caution - To certify storage devices, USB hard disk, and solid state storage, if the SUT contains more than one disk drive, any disk that does not have a slice mounted to /, /usr, /opt, /var, or /export/home* is formatted. All the 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 disk that is inserted in the writer is erased during testing and all the data on the disk is lost. Ensure that you use a disk that does not contain any data for this certification.
Caution - The USB web cam functional test takes pictures during testing. These pictures are packed in the Oracle HCTS result package for auditing. Adjust the web cam for moderate brightness and visibility.
Software Requirements
SUT must have the following OS installed and running.
Oracle Solaris 10 OS or Oracle Solaris 11 OS
Any Oracle Solaris 10 release or Oracle Solaris 11 release can be used to run the Oracle HCTS 5.7 application. You need at least Oracle Solaris 10 version 6/06 to certify CD-RW or DVD-RW devices.
If your system is already running the Oracle Solaris 10 OS or the Oracle Solaris 11 OS, you might want to perform a fresh reinstall before you install Oracle HCTS.
For USB CD/DVD reader certification and USB CD/DVD writer certification, at least Oracle Solaris OS version 6/06 must be installed on the SUT. Use the latest Oracle Solaris release.
For the USB web cam certification, the latest release of the Oracle Solaris 11 OS must be installed on SUT.
Oracle HCTS
Before you download the Oracle HCTS 5.7 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 Oracle HCTS from the Downloads web page.
Note - Before invoking Oracle HCTS, ensure that XWindows is running on the test system.
If you are testing storage performance tuning tool, make sure the SUT has storage performance tool installed and meets the tool requirement (default storage performance tool is vdbench).
Note - Make sure vdbench is installed on the System Under Test (SUT) if the user wants to use it as a performance tool. Also, a configuration file must be generated and saved as /opt/SUNWhcts/etc/vdbench_path.conf. Make sure the system configuration meets the vdbench requirements. For detailed description for vdbench, refer vdbench website.
Before running Oracle HCTS performance tuning tool, the user has to provide three key files as input to the tool, they are: it:storage_per.conf, vdbench.cfg, and vdbench.rule. storage_per.conf and vdbench.rule must be stored in ${HCTS_HOME}/etc directory (${HCTS_HOME} is the HCTS installed home directory).
- storage_per.conf
It is the main vdbench configuration file. It has the following four sections:
perf_tool_argument – Defines the location of vdbench executable file.
perf_tool_argument – This value cannot be NULL. This parameter defines the location of vdbench.cfg file for vdbench.
driver_name – Provides the driver on which vdbench will run. It is an optional section.
driver_parameter – Defines the driver name which needs to be tuned while Oracle HCTS Storage performance tuning tool is running. Oracle HCTS picks up all driver_parameter possible values and modifies the driver configuration file one by one, and then runs several instances of vdbench. The driver_parameter is an optional section, but if the user defines this parameter, then the driver_name parameter must also been defined.
- vdbench.cfg
This configuration file stores the vdbench arguments. The user has to define each vdbench argument in this file. Oracle HCTS provides a macro [DISK] for these parameters, which the user can use to define the name of the raw disk, tape, or file system for the argument lun in the parameter file. This macro will be replaced by the real disk, tape, or file system name which the user selected from the UI when vdbench was invoked.
- vdbench.rule
This is a CSV (comma separated) file, which is used to store column names for vdbench. This file is used to investigate storage performance.
Oracle HCTS provides examples of storage_per.conf,vdbench.cfg, and vdbench.rule in ${HCTS_HOME}/etc directory (${HCTS_HOME} is the HCTS installed home directory).
Certifying FCoE on Converged Network Adapter (CNA)
To certify FCoE on Converged Network Adapter (CNA), both storage and network certification test results are required for HCL submission. For more information on certifying FCoE on CNA, see the hardware and software requirements of certifying storage and network devices. After completing the Network and Storage controller certification testing, please complete the submission form, choosing Networking for 'Type of', and Converged Network Adapter for 'Technology Type', and enter both network and storage driver names.