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

NAME

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

Syntax

25       opacmdall [-CpqPS] [-f hostfile] [-F chassisfile] [-h hosts]
26       [-H chassis] [-u user] [-m marker] [-T timelimit] cmd
27

Options

29       --help    Produces full help text.
30
31
32       -C        Performs command against chassis. Default is hosts.
33
34
35       -p        Runs command in parallel on all hosts/chassis.
36
37
38       -q        Quiet mode, do not show command to execute.
39
40
41       -P        Outputs  the  hostname/chassis  name as prefix to each output
42                 line. This can make script processing of output easier.
43
44
45       -S        Securely prompts for password for user on chassis.
46
47
48       -f hostfile
49                 Specifies  the  file  with  hosts  in  cluster.  Default   is
50                 /etc/opa/hosts file.
51
52
53       -F chassisfile
54                 Specifies  the  file  with  chassis  in  cluster.  Default is
55                 /etc/opa/chassis file.
56
57
58       -h host   Specifies the list of hosts to execute command on.
59
60
61       -H chassis
62                 Specifies the list of chassis to execute command on.
63
64
65       -u user   Specifies the user to perform the command as:
66
67
68                 ·      For hosts, the default is current user code.
69
70                 ·      For chassis, the default is admin.
71
72
73
74
75       -m marker Specifies the marker for end of chassis  command  output.  If
76                 omitted,  defaults  to  chassis command prompt. This may be a
77                 regular expression.
78
79
80       -T timelimit
81                 Specifies the time limit in seconds when  running  host  com‐
82                 mands. Default is -1 (infinite).
83
84

Examples

Operations on Host

87       opacmdall date
88       opacmdall 'uname -a'
89       opacmdall -h 'elrond arwen' date
90       HOSTS='elrond arwen' opacmdall date
91
92

Operations on Chassis

94       opacmdall -C 'ismPortStats -noprompt'
95       opacmdall -C -H 'chassis1 chassis2' ismPortStats -noprompt'
96       CHASSIS='chassis1 chassis2' opacmdall -C ismPortStats -noprompt'
97

Environment Variables

99       The following environment variables are also used by this command:
100
101       HOSTS     List of hosts, used if -h option not supplied.
102
103
104       CHASSIS   List of chassis, used if -C is used and -H and -F options not
105                 supplied.
106
107
108       HOSTS_FILE
109                 File containing list of hosts, used in absence of -f and -h.
110
111
112       CHASSIS_FILE
113                 File containing list of chassis, used in absence  of  -F  and
114                 -H.
115
116
117       FF_MAX_PARALLEL
118                 When  -p  option  is  used, maximum concurrent operations are
119                 performed.
120
121
122       FF_SERIALIZE_OUTPUT
123                 Serialize output of parallel operations (yes or no).
124
125
126       FF_CHASSIS_LOGIN_METHOD
127                 How to log into chassis. Can be Telnet or SSH.
128
129
130       FF_CHASSIS_ADMIN_PASSWORD
131                 Password for admin on all chassis.  Used  in  absence  of  -S
132                 option.
133
134

Notes

136       All  commands  performed  with  opacmdall  must  be  non-interactive in
137       nature. opacmdall waits for the command to complete before  proceeding.
138       For  example,  when  running  host  commands  such as rm, the -i option
139       (interactively prompt before removal) should not be  used.  (Note  that
140       this  option  is  sometimes  part of a standard bash alias list.) Simi‐
141       larly, when running  chassis  commands  such  as  fwUpdateChassis,  the
142       -reboot option should not be used because this option causes an immedi‐
143       ate reboot and therefore the command never returns. Also,  the  chassis
144       command reboot should not be executed using opacmdall. Instead, use the
145       opachassisadmin reboot command to reboot one or more chassis. For  fur‐
146       ther  information  about  individual  chassis CLI commands, consult the
147       Intel(R) Omni-Path Fabric Switches  Command  Line  Interface  Reference
148       Guide
149
150
151       When  performing  opacmdall  against hosts, internally SSH is used. The
152       command opacmdall requires that password-less SSH be set up between the
153       host running the Intel(R) Omni-Path Fabric Suite FastFabric Toolset and
154       the hosts opacmdall is operating against.  The  opasetupssh  FastFabric
155       tool can aid in setting up password-less SSH.
156
157       When performing opacmdall against a set of chassis, all chassis must be
158       configured with the same admin password. Alternatively, the opasetupssh
159       FastFabric tool can be used to set up password-less SSH to the chassis.
160
161       When  performing  operations against chassis, Intel recommends that you
162       set up SSH keys using opasetupssh. If SSH keys are not  set  up,  Intel
163       recommends  that you use the -S option to avoid keeping the password in
164       configuration files.
165
166
167
168Copyright(C) 2015-2018         Intel Corporation                  opacmdall(8)