Scroll to navigation

ethverifyhosts(8) EFSFFCLIRG (Man Page) ethverifyhosts(8)

NAME

ethverifyhosts

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

NOTE: Prior to using ethverifyhosts, copy the sample file /usr/share/eth-tools/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/eth-tools/ethfastfabric.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

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

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

Options

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.

Specifies the file with hosts in cluster.
Default is /etc/eth-tools/hosts.

Specifies the list of hosts to ping.

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.

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

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

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

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

Examples

ethverifyhosts -c

ethverifyhosts -h 'arwen elrond'

HOSTS='arwen elrond' ethverifyhosts

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.

Intel Corporation Copyright(C) 2020-2022