1
2opaverifyhosts(8)      Master map: IFSFFCLIRG (Man Page)     opaverifyhosts(8)
3
4
5

NAME

7       opaverifyhosts
8
9
10
11       Verifies   basic   node   configuration   and  performance  by  running
12       FF_HOSTVERIFY_DIR/hostverify.sh on all specified hosts.
13
14       NOTE:  Prior  to   using   opaverifyhosts,   copy   the   sample   file
15       /usr/share/opa/samples/hostverify.sh  to  FF_HOSTVERIFY_DIR and edit it
16       to set the appropriate configuration and performance  expectations  and
17       select  which  tests  to  run  by default. On the first run for a given
18       node, use the -c option so that hostverify.sh gets copied to each node.
19
20
21       FF_HOSTVERIFY_DIR defines both the location of  hostverify.sh  and  the
22       destination  of  the  hostverify.res  output file. FF_HOSTVERIFY_DIR is
23       configured in the /etc/opa/opafastfabric.conf file.
24
25       A summary of results is appended to  the  FF_RESULT_DIR/verifyhosts.res
26       file.   A   punchlist   of   failures   is   also   appended   to   the
27       FF_RESULT_DIR/punchlist.csv file. Only failures are shown on stdout.
28
29

Syntax

31       opaverifyhosts [-kc] [-f hostfile] [-u upload_file] [-d upload_dir]
32       [-h hosts] [-T timelimit] [-F filename] [ test...]
33

Options

35       --help    Produces full help text.
36
37
38       -k        At start and end of verification, kills any existing hostver‐
39                 ify or xhpl jobs on the hosts.
40
41
42       -c        Copies  hostverify.sh  to  hosts  first,  useful  if you have
43                 edited it.
44
45
46       -f hostfile
47                 Specifies the file with hosts in cluster.
48                 Default is /etc/opa/hosts.
49
50
51       -h hosts  Specifies the list of hosts to ping.
52
53
54       -u upload_file
55                 Specifies the filename to upload hostverify.res to after ver‐
56                 ification  to allow backup and review of the detailed results
57                 for  each  node.  The  default  upload  destination  file  is
58                 hostverify.res. If -u '' is specified, no upload occurs.
59
60
61       -d upload_dir
62                 Specifies  the  directory to upload result from each host to.
63                 Default is uploads.
64
65
66       -T timelimit
67                 Specifies the time limit in  seconds  for  host  to  complete
68                 tests. Default is 300 seconds (5 minutes).
69
70
71       -F filename
72                 Specifies  the  filename of hostverify script to use. Default
73                 is /root/hostverify.sh.
74
75
76       test      Specifies one or more specific tests to run. See
77                 /usr/share/opa/samples/hostverify.sh for a list of  available
78                 tests.
79
80

Examples

82       opaverifyhosts -c
83       opaverifyhosts -h 'arwen elrond'
84       HOSTS='arwen elrond' opaverifyhosts
85

Environment Variables

87       HOSTS     List of hosts, used if -h option not supplied.
88
89
90       HOSTS_FILE
91                 File containing list of hosts, used in absence of -f and -h.
92
93
94       UPLOADS_DIR
95                 Directory to upload to, used in absence of -d.
96
97
98       FF_MAX_PARALLEL
99                 Maximum concurrent operations.
100
101
102
103Copyright(C) 2015-2018         Intel Corporation             opaverifyhosts(8)