1
2ethverifyhosts(8)            EFSFFCLIRG (Man Page)           ethverifyhosts(8)
3
4
5

NAME

7       ethverifyhosts
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   ethverifyhosts,   copy   the   sample   file
15       /usr/share/eth-tools/samples/hostverify.sh   to  FF_HOSTVERIFY_DIR  and
16       edit it to set the appropriate configuration and  performance  expecta‐
17       tions  and select which tests to run by default. On the first run for a
18       given node, use the -c option so that hostverify.sh gets copied to each
19       node.
20
21
22       FF_HOSTVERIFY_DIR  defines  both  the location of hostverify.sh and the
23       destination of the hostverify.res  output  file.  FF_HOSTVERIFY_DIR  is
24       configured in the /etc/eth-tools/ethfastfabric.conf file.
25
26       A  summary  of results is appended to the FF_RESULT_DIR/verifyhosts.res
27       file.  A  punchlist  of  failures  is  also  appended  to  the   FF_RE‐
28       SULT_DIR/punchlist.csv file. Only failures are shown on stdout.
29
30

Syntax

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

Options

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

Examples

99       ethverifyhosts -c
100
101       ethverifyhosts -h 'arwen elrond'
102
103       HOSTS='arwen elrond' ethverifyhosts
104

Environment Variables

106       HOSTS
107
108                 List of hosts, used if -h option not supplied.
109
110
111       HOSTS_FILE
112
113                 File containing list of hosts, used in absence of -f and -h.
114
115
116       UPLOADS_DIR
117
118                 Directory to upload to, used in absence of -d.
119
120
121       FF_MAX_PARALLEL
122
123                 Maximum concurrent operations.
124
125
126
127Copyright(C) 2020              Intel Corporation             ethverifyhosts(8)