HP XC System Software Administration Guide Version 4.0

-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.
# qsnet2_level_test level1 -d \
/hptc_cluster/adm/logs/diag/quadrics -r 0 -clean -v
Example 2
The following example tests level3. Both nodes specified, n1 and n2, save their log files to the
global directory /hptc_cluster/adm/logs/diag/quadrics in the directory named level3.
Running the qsnet2_level_test diagnostic tool on only two nodes is useful because you can
verify that a failing route has been repaired without affecting the use of the rest of the system.
The timeout value is 180 seconds and is specified with the -t option; if a node does not complete
within 180 seconds, the qsnet2_level_test diagnostic tool indicates it is a broken link. Also,
the corresponding processes are ended. As in the preceding example, the test is run on rail 0
with the -clean option, to remove data from a previous test that can corrupt the test results.
# qsnet2_level_test level3 -d \
/hptc_cluster/adm/logs/diag/quadrics \
-N n1,n2 -r 0 -clean -v -t 180
Example 3
The following example displays the output of this diagnostic test, run on three nodes, when the
timeout expires.
# qsnet2_level_test level3 -d \
/hptc_cluster/adm/logs/diag/quadrics/ \
-c -N n1,n2,n3 -t 180
Starting Level 3 Test
Testing on: n1,n2,n3
Warning: timelimit expired
244 Using Diagnostic Tools