NAME

       opaverifyhosts

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

       NOTE:     Prior     to     using     opaverifyhosts,     copy     the     sample      file
       /usr/share/opa/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/opa/opafastfabric.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

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

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

Options

       --help

                 Produces full help text.

       -k

                 At start and end of verification, kills any existing hostverify or xhpl jobs  on
                 the hosts.

       -c

                 Copies hostverify.sh to hosts first, useful if you have edited it.

       -f hostfile

                 Specifies the file with hosts in 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 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.

       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 -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.