Your company here — click to reach over 10,000 unique daily visitors

ethverifyhosts - Man Page



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.


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

[-h  hosts] [-T  timelimit] [-F  filename] [ 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

Specifies the file with hosts in cluster.
Default is /etc/eth-tools/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.


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


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-2024 EFSFFCLIRG (Man Page)