HP XC System Software Administration Guide Version 4.0

-r rail
Specifies the rail number. The default is 0.
-clean
Clears out the log file directory. This ensures that if the file already
exists, the old data is deleted before the new test is run, to ensure that
the data is fresh from the current run.
HP recommends using this option.
-N nodes
Specifies that you want to run this test only on a subset of nodes; the
nodes parameter is a comma-separated list of nodes. The default is to
run this test on all nodes.
Enter the following command on the head node as superuser to begin this diagnostic:
# qselantestp -clean
The qselantestp tool also parses each node's output file and reports any errors it finds.
20.4.2.3 The qsnet2_level_test Diagnostic Tool
The qsnet2_level_test utility is a useful tool for diagnosing the Quadrics system interconnect.
This utility uses the pdsh command to execute itself (that is, the qsnet2_level_test utility)
on all nodes simultaneously.
Each node has a specific path through the network that the node is responsible for testing. This
path is derived from the node's physical position in the Quadrics network. The
qsnet2_level_test can be run through the various levels to test that path. Therefore, it is
important to run level1 first, then level2, level3, and so on, up to the maximum level on
your machine topology. If a node fails at level1, then the node will fail on all the other levels
because it sends data through level1 to reach the higher levels. Ensure that level1 passes
before testing level2.
Note:
This diagnostic tool uses the adapter and the link 100 percent of the time during the test and, as
a result, has great affect on machine performance.
You must run the qsnet2_level_test utility as superuser from the head node.
If all the nodes have not completed their tests after a timeout period elapses, the
qsnet2_level_test stops and the incomplete processes on any remaining nodes are killed.
The format of the qsnet2_level_test utility is shown here:
qsnet2_level_test levels [-d dir] [-parse|-noparse ] [-v] [-t timeout] [-N nodes] [-r
rail] [-clean]
On the command line, you specify the number of fabric levels you want to test. The
qsnet2_level_test utility creates a new directory with the level name in the directory specified
automatically on the command line. If the directory already exists, the qsnet2_level_test
utility continues and uses the existing directory. Acceptable values for the levels parameter
are level1, level2, level3, level, level, and ALL. Test the levels in ascending order.
The options are defined as follows:
-d dir
Specifies the directory to place the logs in. This directory must be visible to all
nodes in the HP XC system.
-parse
Parses the existing logs instead of running tests. This can help to identify slow,
erratic, or broken links.
-noparse Enables you to run the qsnet2_level_test to record the log files into the
chosen directory, but does not parse the log files to find and report errors
automatically. This is particularly useful during drain-time testing, when you
have only a 20- to 30-minute period in which to perform preventive maintenance
testing. You can use the -parse option to verify the results at a later time.
20.4 Using the System Interconnect Diagnostic Tools 243