opaverifyhosts(8)

💖 NAME 💖

opaverifyhosts — bestie, this one verifies basic node configuration and performance by running FF_HOSTVERIFY_DIR/hostverify.sh on all the hosts you point it at. It's giving "vibe check but for your whole cluster". 🦋

NOTE: Before you even think about using opaverifyhosts, you gotta copy the sample file /usr/share/opa/samples/hostverify.sh over to FF_HOSTVERIFY_DIR and edit it so it sets the right configuration and performance expectations, and picks which tests run by default. And on the first run for a given node, use the -c option so that hostverify.sh actually gets copied to each node. No cap. 🙈

FF_HOSTVERIFY_DIR is the main character here — it defines both where hostverify.sh lives and where the hostverify.res output file goes. It's configured in the /etc/opa/opafastfabric.conf file. 💅

A summary of results gets appended to the FF_RESULT_DIR/verifyhosts.res file. A punchlist of failures also gets appended to the FF_RESULT_DIR/punchlist.csv file. And heads up — only failures show up on stdout. ✨

🌈 Syntax 🌈

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

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

✨ Options ✨

• --help — produces the full help text. Your little cheat sheet, bestie. 🎀
• -k — at the start and end of verification, it kills any existing hostverify or xhpl jobs on the hosts. Clean slate energy. 🔥
• -c — copies hostverify.sh to the hosts first. Super useful if you've edited it. 💜
• -f hostfile — specifies the file with hosts in the 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, so you can back up and review the detailed results for each node. The default upload destination file is hostverify.res. And if you do -u '', no upload occurs at all — ghosted. 💀
• -d upload_dir — specifies the directory to upload the result from each host to. Default is uploads.
• -T timelimit — specifies the time limit in seconds for a host to complete tests. Default is 300 seconds (5 minutes). Tick tock ⏰
• -F filename — specifies the filename of the 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 the -h option isn't supplied.
• HOSTS_FILE — file containing the list of hosts, used in the absence of -f and -h.
• UPLOADS_DIR — directory to upload to, used in the absence of -d.
• FF_MAX_PARALLEL — maximum concurrent operations. Multitasking queen 👑

Copyright(C) 2015-2019 Intel Corporation — and that's the whole page, bestie 💖 this little opaverifyhosts(8) moment came from the IFSFFCLIRG (Man Page) set, so go forth and verify those hosts. Slay. ✨🎀🫶