opaverifyhosts (8) - Linux Man Pages



Verifies basic node configuration and performance by running FF_HOSTVERIFY_DIR/hostverify.sh on all specified hosts.

NOTE: Prior to using opaverifyhosts, copy the sample file /usr/lib/opa-ff/samples/hostverify.sh to FF_HOSTVERIFY_DIR and edit it to appropriate configuration and performance expectations and select which tests to run by default. On the first run for a given node, use the -c option so that hostverify.sh gets copied to each node.

FF_HOSTVERIFY_DIR defines both the location of hostverify.sh and the destination of the hostverify.res output file. FF_HOSTVERIFY_DIR is configured in the /etc/sysconfig/opa/opafastfabric.conf file.

A summary of results is appended to the FF_RESULT_DIR/verifyhosts.res file. A punchlist of failures is also appended to the FF_RESULT_DIR/punchlist.csv file. Only failures are shown on stdout.


opaverifyhosts [-kc] [-f hostfile] [-u upload_file] [-d upload_dir]
[-h hosts] [-T timelimit] [ test...]


Produces full help text.

At start and end of verification, kills any existing hostverify or xhpl jobs on the hosts.

Copies hostverify.sh to hosts first, useful if you have edited it.

-f hostfile
File with hosts in cluster. Default is /etc/sysconfig/opa/hosts.

-h hosts
List of hosts to ping.

-u upload_file
Filename to upload hostverify.res to after verification to allow backup and review of the detailed results for each node. The default upload destination file is hostverify.res. If -u '' is specified, no upload occurs.

-d upload_dir
Directory to upload result from each host to. Default is uploads.

-T timelimit
Time limit in seconds for host to complete tests. Default is 300 seconds (5 minutes).

One or more specific tests to run. See /usr/lib/opa-ff/samples/hostverify.sh for a list of available tests.


opaverifyhosts -c
opaverifyhosts -h 'arwen elrond'
HOSTS='arwen elrond' opaverifyhosts

Environment Variables

List of hosts, used if -h option not supplied.

File containing list of hosts, used in absence of -f and -h.

Directory to upload to, used in absence of -d.

Maximum concurrent operations.