ethverifyhosts(8)

✨ ethverifyhosts ✨

okay bestie, welcome to ethverifyhosts(8) — a lil EFSFFCLIRG man page that's about to be your new fave 💖

🌸 NAME 🌸

ethverifyhosts — verifies basic node configuration and performance by running FF_HOSTVERIFY_DIR/hostverify.sh on all the hosts you point it at. she's the vibe check for your whole cluster, fr fr 🦋

NOTE: before you go using ethverifyhosts, copy the sample file /usr/share/eth-tools/samples/hostverify.sh over to FF_HOSTVERIFY_DIR and edit it to set the appropriate configuration and performance expectations, and to select which tests run by default. On the first run for a given node, use the -c option so that hostverify.sh gets copied to each node. no skipping this step, iykyk 💅

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. she's doing double duty, main character energy 👑

A summary of results gets appended to the FF_RESULT_DIR/verifyhosts.res file. A punchlist of failures is also appended to the FF_RESULT_DIR/punchlist.csv file. And heads up: only failures are shown on stdout. quiet queen behavior 🌈

🎀 Syntax 🎀

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

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

💅 Options 💅

• --help — produces full help text. the "bestie explain" button 🫶
• -k — at the start and end of verification, kills any existing hostverify or xhpl jobs on the hosts. it's giving cleanup era ✨
• -c — copies hostverify.sh to hosts first. useful if you've edited it. literally the "ship my edits" flag 📦
• -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, so you can back up and review the detailed results for each node. the default upload destination file is hostverify.res. if you pass -u '', 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). tick tock bestie ⏰
• -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/eth-tools/samples/hostverify.sh for a list of available tests. pick your fighters 🥊

🌈 Examples 🌈

ethverifyhosts -c

ethverifyhosts -h 'arwen elrond'

HOSTS='arwen elrond' ethverifyhosts

arwen and elrond are getting verified and honestly? iconic 💀

🧚 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. go fast but not too fast 🔥

and that's the whole page, no cap 🎀 this ethverifyhosts(8) page came to you from the EFSFFCLIRG man page set, copyright (C) 2020-2024 Intel Corporation — big thank you to Intel for the lore, mwah 💜 periodt.