README Oracle Solaris[TM] Operating System Oracle Hardware Certification Test Suite (Oracle HCTS) Version 5.8 ---------------------------------------------- This README file provides the following information about the Oracle Hardware Certification Test Suite (Oracle HCTS) version 5.8: o Oracle HCTS 5.8 Application Overview o Documentation o Oracle HCTS System Setup and Installation o Certification Process o Contact Information Note - Before you use Oracle HCTS, be sure to check whether the system that you want to test is already on the Oracle Solaris Operating System (OS) Hardware Compatibility List (HCL). The HCL is available at http://www.oracle.com/webfolder/technetwork/hcl/index.html. Oracle HCTS 5.8 Application Overview -------------------------- The Oracle Hardware Certification Test Suite (Oracle HCTS) application is a set of test suites that can be used to test and certify your system hardware, components, and virtual platforms for the Oracle Solaris OS compatibility on SPARC and x86 platforms. This test suite can be used by independent hardware vendors (IHVs), hardware manufacturers, system integrators, and end users. All the hardware components that pass the Oracle HCTS test are eligible to be included in Hardware Compatibility List (HCL) at http://www.oracle.com/webfolder/technetwork/hcl/index.html. Hardware certification services exists for the Oracle Solaris 10 OS, Oracle Solaris 11 OS, and all their corresponding updated releases. When you invoke the test, Oracle HCTS gathers information about your system hardware that is to be tested and prepares the test environment. If no error is detected, Oracle HCTS proceeds with the test process. After the hardware passes the certification test, submit the test results for an audit. For more information on the submission process, see the Oracle HCTS webpage at http://www.oracle.com/webfolder/technetwork/hcl/hcts/index.html. For system, network, WiFi, InfiniBand HCA, and serial I/O testing, suspend/resume tests and network performance tests, use the following test machines: 1) System Under Test - System to certify, or the system that has the device to certify. 2) Test Manager System - System that is used by System Under Test to test system, network, WiFi, InfiniBand, network performance, suspend and resume feature on Oracle Solaris 11 OS, and serial I/O devices. Test Manager System should be a system that is already listed on the HCL as Certified. 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 and the 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/diagnostic/spray svc:/network/nfs/client:default system/file-system/nfs svc:/network/nfs/mapid:default system/file-system/nfs For external storage certification, refer to online help or user guide for detailed information. For ethernet network switch certification, refer to online help or user guide for detailed information. For all the other tests, use only the System Under Test machine. Oracle HCTS performs the following types of certification tests: o System certification test - Runs for approximately 12 hours, depending on the devices that are detected. If the System Under Test includes multiple storage components, the certification run time is an additional three hours for each additional storage component. o Network certification test - Runs for approximately five hours. o WiFi card certification test - Runs for approximately four hours. See the User Guide and the WiFi card certification manual test guideline for more information how to set up the WiFi card certification test environment. o Serial I/O certification test - Runs for approximately six hours. At least one pair of serial ports must be connected between the Test Manager system and System Under Test. The connected serial ports must be able to communicate with each other. o Storage certification test - Runs for approximately three hours for each storage component. If System Under Test 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 data on such a disk is lost. During the test initialization process, any disk that is scheduled to be formatted is listed by the system. The initialization process pauses for 60 seconds and prompts you to stop the certification if you do not need the disk to be formatted. o External storage certification test - Runs for approximately 10 hours. See the User Guide for more information on how to setup the external storage certification test environment. o InfiniBand (IB) HCA (Host Channel Adapter) certification test - Runs for approximately 1.5 hours for the two ports IB HCA; 45 minutes for one port IB HCA. See the User Guide or more information on how to setup the InfiniBand HCA certification test environment. o Audio certification test - Runs for approximately 10 minutes. o CD/DVD reader certification test - Runs for approximately 0.5 hour. o CD/DVD writer certification test - Runs for approximately one hour. Caution - For CD/DVD writer certification, the disk inserted into the writer is erased during the test process and all data on the disk is lost. Ensure that the disk you use for this certification does not contain any data. o USB CD/DVD reader certification test - Runs for approximately 0.5 hour. o USB CD/DVD writer certification test - Runs for approximately one hour. Caution - For USB CD/DVD writer certification, the disk inserted into the writer is erased during the test process and all data on the disk is lost. Ensure that the disk you use for this certification does not contain any data. o USB keyboard certification test - Runs for approximately five minutes. o USB storage certification test - Runs for approximately two hours. If the USB hard disk or solid-state storage device to be certified does not have any slice mounted to /, /usr, /opt, /var, or /export/home*, the disk is formatted during testing. All the data on such a disk is lost. During the test initialization process, any disk that is scheduled to be formatted is listed by the system. The initialization process pauses for 60 seconds and prompts you to stop the certification if you do not want the disk to be formatted. o USB multimedia card reader certification test - Runs for approximately two hours for each device. If the USB multimedia card reader device to be certified does not have any slice mounted to /, /usr, /opt, /var, or /export/home*, the device is formatted during testing. All the data on such a device is lost. During the test initialization process, any device that is scheduled to be formatted is listed by the system. The initialization process pauses for 60 seconds and prompts you to stop the certification if you do not want the device to be formatted. o USB webcam certification test - Runs for approximately 0.5 hour. o Video certification test - Runs for approximately one hour. o Tape_Drive certification test - Runs for approximately one hour. o FCoE certification test - Runs for approximately 8 hours; Network and Storage certification are required to certify FCoE component. See the User Guide for more information on how to setup the FCoE certification test environment. o Ethernet network switch test - Runs four testcases separately; Jumbo Frame test case runs for approximately 15 minutes, Switch Link Aggregation test case runs for approximately 8 minutes, Switch Link Speed test case runs for approximately 30 minutes, Switch port mirroring test case runs for approximately 8 minutes. See the HCTS User Guide for more information on how to setup the ethernet network switch certification test environment. For the runtime of other Oracle HCTS tests, see the online help for the GUI or the hctsclid(1M) manpage. Documentation ------------- Documentation is available within the online help facility of the Oracle HCTS application. In addition to the online help, the following documentation is provided: o README file o Release Notes o User Guide available at: http://www.oracle.com/webfolder/technetwork/hcl/hcts/guides/StartGuide.html o Man page to certify a system and a component using CLI: hctscli.1m o Man page to create and run the Custom Test Plan using CLI: hctsclid.1m o FAQ available at: http://www.oracle.com/webfolder/technetwork/hcl/hcts/faq.html Oracle HCTS System Setup and Installation ----------------------------------- Before you download Oracle HCTS, check the system requirements in the User Guide available at http://www.oracle.com/webfolder/technetwork/hcl/hcts/guides/StartGuide.html. The Oracle HCTS 5.8 download is an archive file from which you need to extract the contents. The procedure to install Oracle HCTS is as follows: 1. To extract the contents of the Oracle HCTS archive file, execute the following command in the terminal: $ gzip -cd hcts.5.8.tar.gz|tar xvf - In case you are working on the SPARC platform, execute the following: $ gzip -cd hcts.5.8-sparc.tar.gz|tar xvf - Extracting the tar file creates a directory called hcts.5.8 or hcts.5.8-sparc, in case you have downloaded the SPARC package. 2. Navigate to the directory hcts.5.8 or hcts.5.8-sparc by using the cd command. The directory contains the following files: o HCTS_5.8_ThirdPartyLicenseReadMe.txt o hcts.5.8.README o hcts.5.8.ReleaseNotes o SUNWhcts package 3. Log in as a root by using the su command. 4. To install the Oracle HCTS application, execute the following command in the terminal: # pkgadd -d . SUNWhcts Note: Before installing the Oracle HCTS 5.8 package, remove any previous versions of Oracle HCTS on the system. See the User Guide available at http://www.oracle.com/webfolder/technetwork/hcl/hcts/guides/StartGuide.html for the installation and uninstallation procedures for the specific components. Certification Process --------------------- Once your hardware has passed the certification tests, save the test results archive file generated by Oracle HCTS in the /var/hcts/packages directory. See the submission section of the http://www.oracle.com/webfolder/technetwork/hcl/hcts/index.html website to submit your results for an audit. We will make a reasonable effort to add your hardware to the HCL. Note - Reinstall your system after you run the Oracle HCTS. Contact Information ------------------- If you have general questions or suggestions about the certification program, send an email to hcts-support_ww_grp@oracle.com Copyright (c) 2004, 2016, Oracle and/or its affiliates. All rights reserved. License Restrictions Warranty/Consequential Damages Disclaimer This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. Warranty Disclaimer The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. Restricted Rights Notice If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable: U.S.GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065. Hazardous Applications Notice This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications. Trademark Notice Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc.AMD,Opteron, theAMDlogo, and theAMDOpteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group in the United States and other countries. Third Party Content, Products, and Services Disclaimer This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services.Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.