C H A P T E R

C H A P T E R 60

Sun Fire Link Interconnect Test (wrsmtest)

The wrsmtest verifies the functionality of the Sun Fire trademark Link Interconnect by checking the cluster networking hardware.

Note - For this test to be meaningful, the cluster must be configured before the test is run.

For details on how to configure the cluster before running wrsmtest , refer to the cluster network administration documentation that is shipped with the product.

The wrsmtest uses the Internet Control Message Protocol (ICMP) that is based on the Data Link Protocol Interface (DLPI) to test the connections between cluster nodes.

First, wrsmtest determines the target cluster nodes to use for testing. You can specify the target hosts in the wrsmtest Test Parameter menu, or if no targets are specified, wrsmtest sends an ICMP broadcast from the private cluster network to find them. If it fails to find the necessary targets, it performs an RPC broadcast to the RPC port mapper daemon.

After finding the cluster nodes (targets), wrsmtest performs the following subtests:

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 where all byte patterns (0 to 0xFF) are used.

Note - wrsmtest is a scalable test. The maximum number of instances is two per WIB card.

Note - The wrsmtest is only supported in a 64-bit operating environment.

wrsmtest 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 60-1 wrsmtest Test Parameter Options Dialog Box

TABLE 60-1 `wrsmtest` Options
`wrsmtest` Options	Description
Target Host	Specifies one or more cluster node targets for testing. Target host entries can be either a host name or an Internet address for the `wrsmd` interface, for example, target1+target2+target3. When no target host is specified, the test finds the necessary targets through broadcasting. The default setting leaves this field empty.
Test Type	Specifies which subtests to run: 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 where all byte patterns (0 to 0xFF) are used. All subtests are selected by default.
Number of Packets	Specifies the number of packets to use for testing. The default is 256.
Receive Timeout	Specifies the receive timeout value in seconds. Specify a number between 0-600 seconds. The default is 120 seconds.
Number of Retries	Sets the number of retries before an error is flagged. Specify a number between 0-128. The default is 3.
Print Warning	Choose Enable to see warning errors, such as `retry on timeout` errors. Disabled by default.
Link Max Error Limit	Upper threshold limit for peak link errors per second for a test to pass. If the test reports peak link errors that exceed this limit, the device being tested will fail and report an error message.
Link Average Error Limit	Threshold limit for average link errors per hour for a test to pass. If the test reports average link errors that exceed this limit, the device being tested will fail and report an error message. The default is 40 errors per hour.

wrsmtest Test Modes

Connection, and Functional modes are supported by wrsmtest . Different test schemes are performed on the cluster interconnect device based on the test mode you select.

TABLE 60-2 `wrsmtest` Test Modes
Test Mode	Supported?	Description
Connection	Yes	`wrsmtest` checks if the device is connected. It searches through DLPI `wrsmd` interfaces for the specified device name. If `wrsmtest` finds the device not connected, the test fails, otherwise, it returns the following message: `device is connected` .
Functional (Offline	Yes	`wrsmtest` performs all three subtests (Random test, Incremental test, and Pattern test) sequentially. It allows you to specify options in such a way that `wrsmtest` performs a very stressful test.

wrsmtest Command-Line Syntax

/opt/SUNWvts/bin/wrsmtest standard_arguments -o dev= interface ,test= type ,packets= n ,pattern= hex ,delay= seconds , timeout= seconds ,retry= n ,warn= E|D,maxerr =n ,avgerr =n

TABLE 60-3 `wrsmtest` Command-Line Syntax
Argument	Description
`dev=` interface	Identifies the cluster network interface name. The default value is `wrsmd0` for DLPI cluster networks.
`test=` type	Specifies which subtests to run. Specify `random` , `increment` , or `pattern` . Use a `+` symbol to list multiple subtests. The default value is `random+increment+pattern` .
`packets=` n	Specifies the 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 `1` second.
`retry=` n	Indicates the number of test timeout retries. The default is three retries.
`warn` =E\|D	When enabled, prints warning messages.
`maxerr =n`	Upper threshold limit for peak link errors per second for a test to pass. If the test reports peak link errors that exceed this limit, the device being tested will fail and report an error message.
`avgerr` =n	Threshold limit for average link errors per hour for a test to pass. If the test reports average link errors that exceed this limit, the device being tested will fail and report an error message. The default is 40 errors per hour.

Note 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.