ethverifyhosts - Man Page



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

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

FF_HOSTVERIFY_DIR defines both the location of 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 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/


Specifies one or more specific tests to run. See
/usr/share/eth-tools/samples/ 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-2021 EFSFFCLIRG (Man Page)