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

NAME

7       ethcmdall
8
9
10
11       (Linux)  Executes  a command on all hosts. This powerful command can be
12       used for configuring servers, verifying that they are running, starting
13       and stopping host processes, and other tasks.
14
15       NOTE:  ethcmdall depends on the Linux* convention that utilities return
16       0 for success and >0 for failure. If ethcmdall is  used  to  execute  a
17       non-standard  utility  like  diff  or  a  program that uses custom exit
18       codes, then ethcmdall may erroneously report "Command execution FAILED"
19       when  it  encounters  a  non-zero exit code. However, command output is
20       still returned normally and the error may be safely ignored.
21
22

Syntax

24       ethcmdall [-pqP] [-f  hostfile] [-h  hosts] [-u  user]
25
26       [-T  timelimit]  cmd
27

Options

29       --help
30
31                 Produces full help text.
32
33
34       -p
35
36                 Runs command in parallel on all hosts.
37
38
39       -q
40
41                 Quiet mode, do not show command to execute.
42
43
44       -P
45
46                 Outputs the hostname as prefix to each output line. This  can
47                 make script processing of output easier.
48
49
50       -f hostfile
51
52                 Specifies   the  file  with  hosts  in  cluster.  Default  is
53                 /etc/eth-tools/hosts file.
54
55
56       -h host
57
58                 Specifies the list of hosts to execute command on.
59
60
61       -u user
62
63                 Specifies the user to perform the command as:
64
65
66                 •      For hosts, the default is current user code.
67
68
69
70
71       -T timelimit
72
73                 Specifies the time limit in seconds when  running  host  com‐
74                 mands. Default is -1 (infinite).
75
76

Examples

Operations on Host

79       ethcmdall date
80
81       ethcmdall 'uname -a'
82
83       ethcmdall -h 'elrond arwen' date
84
85       HOSTS='elrond arwen' ethcmdall date
86

Environment Variables

88       The following environment variables are also used by this command:
89
90       HOSTS
91
92                 List of hosts, used if -h option not supplied.
93
94
95       HOSTS_FILE
96
97                 File containing list of hosts, used in absence of -f and -h.
98
99
100       FF_MAX_PARALLEL
101
102                 When  -p  option  is  used, maximum concurrent operations are
103                 performed.
104
105
106       FF_SERIALIZE_OUTPUT
107
108                 Serialize output of parallel operations (yes or no).
109
110

Notes

112       All commands performed with ethcmdall must be  non-interactive  in  na‐
113       ture.  ethcmdall  waits  for the command to complete before proceeding.
114       For example, when running host commands such as rm, the -i option  (in‐
115       teractively  prompt before removal) should not be used. (Note that this
116       option is sometimes part of a standard bash alias  list.)  For  further
117       information  about  Linux*  operating  system commands, consult the man
118       pages.
119
120       When performing ethcmdall against hosts, internally SSH  is  used.  The
121       command ethcmdall requires that password-less SSH be set up between the
122       host running the Intel(R) Ethernet Fabric Suite FastFabric Toolset  and
123       the  hosts  ethcmdall  is operating against. The ethsetupssh FastFabric
124       tool can aid in setting up password-less SSH.
125
126
127
128Copyright(C) 2020-2021         Intel Corporation                  ethcmdall(8)