47 - C H A P T E R -

C H A P T E R 47

Sun Enterprise Cluster 2.0 Network Hardware Test (scitest)

scitest verifies the functionality of the Sun Enterprise Cluster 2.0 by checking the networking hardware. For this test to be meaningful, the cluster must already be configured before the test is run. For details on how to configure the cluster, refer to Sun Enterprise Cluster 2.0 Hardware Site Preparation, Planning, and Installation Guide.

scitest reads the /etc/sma.ip file to determine the target nodes in the cluster. scitest mainly uses the Internet Control Message Protocol (ICMP) to test the connections between cluster nodes.

After finding the cluster nodes (targets), scitest performs the following tests:

Random test--sends out 256 packets with random data length and random data.

Incremental test--sends out packets with length from minimum to maximum packet size using incremental data.

Pattern test--sends 256 packets of maximum length, where each packet contains one test pattern and all byte patterns (0 to 0xFF) are used.

Note - scitest is a scalable test. The maximum number of instances is two per SCI card.

scitest Options

To reach the dialog box below, right-click on the test name in the System Map and select Test Parameter Options. If you do not see this test in the System Map, you might need to expand the collapsed groups, or your system may not include the device appropriate to this test. Refer to the SunVTS User's Guide for more details.

FIGURE 47-1 scitest Test Parameter Options Dialog Box

Screenshot of the scitest Test Parameter Options dialog box.

TABLE 47-1 `scitest` Options
`scitest` Options	Description
Target Host	Not used.
Receive Timeout field	Specify a number between 0-600 seconds. The default is 120 seconds.
Number of Retries field	The number of retries before an error is flagged. Specify a number between 0-128.
Print Warning	Disabled by default. Choose Enable to see warning errors, such as `retry on timeout` errors.

scitest Test Modes

Connection, Functional, and Online modes are supported by scitest. Different test schemes are performed on the network device based on the mode selected.

TABLE 47-2 `scitest` Supported Test Modes
Test Mode	Description
Connection	`scitest` checks if the device is connected. It searches through all the network interfaces for the specified device name. `scitest` finds the device not connected the test fails, otherwise, it returns `device is connected`.
Functional (Offline)	`scitest` performs all three tests (Random test, Incremental test, and Pattern test) sequentially. It allows you to specify an option in such a way that `scitest` performs a very stressful test.
Online	Performs the full set of tests.

scitest Command-Line Syntax

/opt/SUNWvts/bin/scitest standard_arguments -o dev=interface,test=type,packets=n,pattern=hex,delay=seconds, timeout=seconds,retry=n,warn

TABLE 47-3 `scitest` Command-Line Syntax
Argument	Description
`dev=`interface	Network interface name. The default value is `le0` for Ethernet networks.
`test=`type	The test type. Specify `random`, `increment`, or `pattern`. The default value is random+increment+pattern to run.
`packets=`n	Number of random/pattern packets. The default is 256.
`pattern=`hex	Specifies a data pattern in hexadecimal form. The default is all patterns from `0` to `0xff`.
`delay=`seconds	Indicates the time between subtests in seconds. The default is 30 seconds.
`timeout=`seconds	Indicates the number of seconds to wait before a timeout. The default is 20 seconds.
`retry=`n	Indicates the number of test timeout retries. The default is three retries.
`warn`	When enabled, prints warning messages.

Note - 64-bit tests are located in the sparcv9 subdirectory: /opt/SUNWvts/bin/sparcv9/testname. If a test is not present in this directory, then it may only be available as a 32-bit test. For more information refer to 32-Bit and 64-Bit Tests.