Q-Logic IB6054601-00 D manual Ipathcheckout

Q

C – Troubleshooting Useful Programs and Files for Debugging

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.

IB6054601-00 D C-33