Using Oracle HCTS CLI

Language:

There are two commands in the Oracle HCTS CLI environment listed as follows.

hctscli: This command is used to certify the system and component in the CLI mode.
hctsclid: This command is used to create and run the custom test plan in the CLI mode.

Certifying Systems and Components Using CLI

For certifying systems and components, you need to use the hctscli command. As described in the previous chapters, you need to use TM and SUT for certifying the system, network, InfiniBand, WiFi, and serial I/O devices.

To start the Oracle HCTS for setting up the systems, certifying systems, and components, use the hctscli command. See the hctscli(1M) man page for more information.

To set up the TM system, type the following command.

# /usr/bin/hctscli setup-tm

To certify the SUT as a system, type the following command.

# /usr/bin/hctscli certify System

To list certifiable network devices of the SUT, type the following command.

# /usr/bin/hctscli list-device Network

To certify the network of the SUT using the IPv4 protocol, type the following command.

# /usr/bin/hctscli certify [ -d device_id_from_the_list-device_output] Network

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

To list the serial devices of the SUT, type the following command.

# /usr/bin/hctscli list-device Serial

To certify the serial I/O component of the SUT, type the following command.

# /usr/bin/hctscli certify Serial

If no device is specified for the certify Serial command, then all serial devices are tested one by one.

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

To run the storage certification test suite, type the following command.

# /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.

For more information on the names of component certification test suites that you can run and more examples, see the man pages.

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

Creating the Custom Test Plan Using CLI

To create and run the custom test plan in the Oracle HCTS CLI, use the hctsclid command. Refer hctsclid.1m man page for more information.

Example 1 Creating a Custom Test Plan

To list all the available test categories under the Custom Test Plan, type the following command.

sut# hctsclid list-category

1: USB_Keyboard
2: CPU
3: Video
4: IPv6
5: Memory
6: Audio
7: CD-RW_DVD-RW
8: Storage
9: Network

To set the test category, type the following command.

sut# hctsclid set-category Storage
Category Storage is added.

To add a new group, type the following command.

sut# hctsclid add-group 1
Group 1 added to Custom Test Plan.

To list all the available test cases for the selected category, type the following command.

sut# hctsclid list-testcase Storage

1: bonnie
2: misabuf
3: fs_stress
4: dd
5: mode_sense
6: mpflip

To list all the devices supported by the bonnie test, type the following command.

sut# hctsclid list-device bonnie
Test Case Device List for bonnie
1: c1d0         Driver : N/A

To add the test case to the created group, type the following command.

sut# hctsclid add-testcase -g 1 -d 1 bonnie
Test Case bonnie   id=1 executed on "c1d0" added to group 1.

To create another group, type the following command.

sut# hctsclid add-group 2
Group 2 added to Custom Test Plan.

To list all the devices supported by the Fs_Stress test, type the following command.

sut# hctsclid list-device Fs_stress
Test Case Device List for Fs_stress:
       1 : c1d0      Driver : N/A

To add the test case to the created group, type the following command.

sut# hctsclid add-testcase -g 2 -d 1 Fs_stress
Test case Fs_stress  id=2 executed on  "c1d0" added to group 2.

To list the available tunable options for the Fs_stress test, type the following command.

sut# hctsclid list-option Fs_stress
 Option Description : Enter runtime in seconds(minimum is 600, default is 3600):
        Option Type : TextArgument
        Option Name  : run_time
        Option Value : value

To set the tunable option, type the following command.

sut# hctsclid set -p run_time=610 -g 2 2
Set tunable options into TestcaseId2 Fs_stress successfully.

To enable you to view the custom test plan, type the following command.

sut# hctsclid show-testplan
  Category : Storage
         Group : 1
         Test Case Id : 1
         Test Case Name: bonnie
         Device: c1d0
         Group : 2
         Test Case Id : 2
         Test Case Name: Fs_stress
         Device: c1d0
         Option Name : run_time    Value : 610

To run the test plan, type the following command.

sut# hctsclid run-testplan
Test is active!(Press Ctrl+C to stop the test!)
       System Under Test: 64

Bit Mode!
       System configuration in progress...
       Progress: 0%...1%...11%...21%...31%...41%...100%
       Result: Pass!
       Review report: /var/hcts/reports
       Review test logs: /var/hcts/logs 
       Note: Customization test is invalid for submission.