Q-Logic IB6054601-00 D Switch User Manual


 
C – Troubleshooting
Useful Programs and Files for Debugging
IB6054601-00 D C-33
Q
C.9.8
ipath_checkout
ipath_checkout is a bash script used to verify that the installation is correct and
that all the nodes of the network are functioning and mutually connected by the
InfiniPath fabric. It is to be run on a front end node, and requires specification of a
hosts file:
$ ipath_checkout [options] hostsfile
where hostsfile designates a file listing the hostnames of the nodes of the cluster,
one hostname per line. The format of hostsfile is as follows:
hostname1
hostname2
...
ipath_checkout performs the following seven tests on the cluster:
1. ping all nodes to verify all are reachable from the frontend.
2. ssh to each node to verify correct configuration of ssh.
3. Gather and analyze system configuration from nodes.
4. Gather and analyze RPMs installed on nodes.
5. Verify InfiniPath hardware and software status and configuration.
6. Verify ability to mpirun
jobs on nodes.
7. Run bandwidth and latency test on every pair of nodes and analyze results.
The possible options to ipath_checkout are:
-h, --help
Displays help messages giving defined usage.
-v, --verbose
-vv, --vverbose
-vvv, --vvverbose
These specify three successively higher levels of detail in reporting results of tests.
So, there are four levels of detail in all, including the case of where none these
options are given.
-c, --continue
When not specified, the test terminates when any test fails. When specified, the
tests continue after a failure, with failing nodes excluded from subsequent tests.