HP XC System Software Administration Guide Version 3.1

The qselantestp tool also parses each node's output file and reports any errors it finds.
19.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
terminates 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.
-v
Specifies verbose output, which is required to identify which component or location is
causing errors.
-t timeout
Specifies the timeout value (in seconds), that is, the length to wait for any test to finish.
The default value is 300.
-N nodes Enables you to run the qsnet2_level_test on only a subset of nodes. The argument
nodes is a comma-separated list, for example: n1,n2,n4. The default operation is to
run the qsnet2_level_test utility on all nodes.
-clean
Clears out the directories if you are doing a test. It clears out all log files in the directory
for the level specified. This action is useful because if the file already exists, the old
data is deleted before the new test is run, thereby ensuring that the data is fresh from the
current run.
This utility uses qsnet2_dmatest to sanitize and test individual links in the network. The
qsnet2_dmatest also reports bandwidth for small and large data transfers as it ramps up. It automatically
examines and reports if any errors were detected by the system interconnect during the test. The log files
for qsnet2_dmatest are written to the directory specified in the command line.
The qsneterr Utility 225