HP XC System Software Administration Guide Version 3.0

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 in which the logs should be placed. 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.
Level3 of the qsnet2_dmatest tests the links between the QM502 card and the QM501 rear switch
cards through the midplane. If the QM502 cards are not installed, the test spawns across the nodes, then
waits for the timeout period and reports all the nodes as "failed to complete".
Example 1
The following example tests level1. All the nodes write their log files to the directory named level1,
which is a subdirectory of the global directory /hptc_cluster/adm/logs/diag/quadrics. The -r
0 option specifies that the test is run on rail 0; if there is only one Quadrics adapter in each node, then rail
0 is the only allowable option. The -clean option is specified so that the qsnet2_level_test utility
deletes the contents of the level1 directory to ensure that data from previous tests is removed. The -v
option ensures verbose output.
Example 1 155