Man page - opaverifyhosts(8)

Packages contains this manual

Package:  opa-fastfabric
apt-get install opa-fastfabric

Manuals in package:
• opafabricanalysis(8)
• opatop(8)
• opaextractperf2(8)
• opaxmlfilter(8)
• opashowallports(8)
• opaextractsellinks(8)
• opafindgood(8)
• opaextracterror(8)
• opacabletest(8)
• opaesmanalysis(8)
• opaextractbadlinks(8)
• opagentopology(8)
• opareports(8)
• opapingall(8)
• opacaptureall(8)
• opaextractstat(8)
• opaallanalysis(8)
• opaenableports(8)
• opaxmlgenerate(8)
• opaexpandfile(8)
• opagenchassis(8)
• opafirmware(8)
• opasorthosts(8)
• opachassisanalysis(8)
• opareport(8)
• opaswenableall(8)
• opa2rm(8)
• opadisablehosts(8)
• opafmconfigcheck(8)
• opaextractstat2(8)
• opasetupssh(8)
• opalinkanalysis(8)
• opadownloadall(8)
• opauploadall(8)
• opahostsmanalysis(8)
• opaxmlextract(8)
• opaxlattopology(8)
• opaswdisableall(8)
• opaledports(8)
• opacmdall(8)
• opacheckload(8)
• opagenesmchassis(8)
• opamergeperf2(8)
• opascpall(8)
• opaverifyhosts(8)
• opaextractlids(8)
• opafastfabric(8)
• opagenswitches(8)
• opadisableports(8)
• opaextractmissinglinks(8)
• opaxmlindent(8)
• opahostadmin(8)
• opashowmc(8)
• opaextractperf(8)
• opapaquery(8)
• opaextractlink(8)
• opachassisadmin(8)
• opaswitchadmin(8)
• opafmconfigdiff(8)

Manual

opaverifyhosts

NAME
Syntax
Options
Examples
Environment Variables

---

NAME

opaverifyhosts

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/share/opa/samples/hostverify.sh to FF_HOSTVERIFY_DIR and edit it to set the 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/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.

Syntax

opaverifyhosts [-kc] [-f hostfile ] [-u upload_file ] [-d upload_dir ]

[-h hosts ] [-T timelimit ] [-F filename ] [ test ...]

Options

--help

Produces full help text.

-k

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

-c

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

-f hostfile

Specifies the file with hosts in cluster.
Default is /etc/opa/hosts.

-h hosts

Specifies the list of hosts to ping.

-u upload_file

Specifies the 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

Specifies the directory to upload result from each host to. Default is uploads.

-T timelimit

Specifies the time limit in seconds for host to complete tests. Default is 300 seconds (5 minutes).

-F filename

Specifies the filename of hostverify script to use. Default is /root/hostverify.sh.

test

Specifies one or more specific tests to run. See
/usr/share/opa/samples/hostverify.sh for a list of available tests.

Examples

opaverifyhosts -c

opaverifyhosts -h 'arwen elrond'

HOSTS='arwen elrond' opaverifyhosts

Environment Variables

HOSTS

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

HOSTS_FILE

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

UPLOADS_DIR

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

FF_MAX_PARALLEL

Maximum concurrent operations.

---