opacmdall(8)

✨ opacmdall(8) ✨

okay bestie, settle in, because this one is from the IFSFFCLIRG man page family and it is lowkey one of the most powerful little gremlins in your whole toolset 💅

---

💖 NAME 💖

opacmdall

(Linux and Switch) This one runs a command on all your hosts or on all your Intel(R) Omni-Path Chassis. It's giving main character energy, fr fr — you can use it to configure servers or chassis, verify that they're actually up and running, start and stop host processes, and honestly a whole pile of other tasks. It's the group-chat broadcast of Unix commands. 📣

⚠️ NOT ME DROPPING A CAVEAT RIGHT AWAY: opacmdall depends on the Linux* convention that utilities return 0 for success and >0 for failure. So if you use opacmdall to run a non-standard utility like diff, or literally any program that uses custom exit codes, then opacmdall may erroneously report "Command execution FAILED" when it hits a non-zero exit code. The tea ☕ is: command output is still returned normally and the error may be safely ignored. So don't panic, it's fine, breathe. 🫶

---

🌈 Syntax 🌈

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

---

✨ Options ✨

• --help — Produces full help text. Your bestie when you forget literally everything.
• -C — Performs command against chassis. Default is hosts.
• -p — Runs command in parallel on all hosts/chassis. Go fast, bestie 🏃‍♀️💨
• -q — Quiet mode, do not show command to execute. Shhh 🤫
• -P — Outputs the hostname/chassis name as prefix to each output line. This can make script processing of output easier. Iconic for piping into stuff.
• -S — Securely prompts for password for user on chassis. 🔐
• -f hostfile — Specifies the file with hosts in cluster. Default is /etc/opa/hosts file.
• -F chassisfile — Specifies the file with chassis in cluster. Default is /etc/opa/chassis file.
• -h host — Specifies the list of hosts to execute command on.
• -H chassis — Specifies the list of chassis to execute command on.
• -u user — Specifies the user to perform the command as:
  • For hosts, the default is current user code.
  • For chassis, the default is admin.
• -m marker — Specifies the marker for end of chassis command output. If omitted, defaults to chassis command prompt. This may be a regular expression.
• -T timelimit — Specifies the time limit in seconds when running host commands. Default is -1 (infinite). No cap, no timer, just vibes ⏳

---

🌸 Examples 🌸

Operations on Host

opacmdall date

opacmdall 'uname -a'

opacmdall -h 'elrond arwen' date

HOSTS='elrond arwen' opacmdall date

Operations on Chassis

opacmdall -C 'ismPortStats -noprompt'

opacmdall -C -H 'chassis1 chassis2' ismPortStats -noprompt'

CHASSIS='chassis1 chassis2' opacmdall -C ismPortStats -noprompt'

---

🦋 Environment Variables 🦋

The following environment variables are also used by this command:

• HOSTS — List of hosts, used if -h option not supplied.
• CHASSIS — List of chassis, used if -C is used and -H and -F options not supplied.
• HOSTS_FILE — File containing list of hosts, used in absence of -f and -h.
• CHASSIS_FILE — File containing list of chassis, used in absence of -F and -H.
• FF_MAX_PARALLEL — When -p option is used, maximum concurrent operations are performed.
• FF_SERIALIZE_OUTPUT — Serialize output of parallel operations (yes or no).
• FF_CHASSIS_LOGIN_METHOD — How to log into chassis. Can be Telnet or SSH.
• FF_CHASSIS_ADMIN_PASSWORD — Password for admin on all chassis. Used in absence of -S option.

---

🎀 Notes 🎀

💀 THE BIG ONE, PLS READ THIS ONE:

All commands performed with opacmdall must be non-interactive in nature. opacmdall waits for the command to complete before proceeding.

So like — when running host commands such as rm, the -i option (interactively prompt before removal) should not be used. (Note that this option is sometimes part of a standard bash alias list.) Yeah, the classic rm -i alias jumpscare. 🙈

Similarly, when running chassis commands such as fwUpdateChassis, the -reboot option should not be used because this option causes an immediate reboot and therefore the command never returns. Like, it just ghosts you forever, bestie. 😭

Also, the chassis command reboot should not be executed using opacmdall. Instead, use the opachassisadmin reboot command to reboot one or more chassis. For further information about individual chassis CLI commands, consult the Intel(R) Omni-Path Fabric Switches Command Line Interface Reference Guide.

---

When performing opacmdall against hosts, internally SSH is used. The command opacmdall requires that password-less SSH be set up between the host running the Intel(R) Omni-Path Fabric Suite FastFabric Toolset and the hosts opacmdall is operating against. The opasetupssh FastFabric tool can aid in setting up password-less SSH. 🔑✨

When performing opacmdall against a set of chassis, all chassis must be configured with the same admin password. Alternatively, the opasetupssh FastFabric tool can be used to set up password-less SSH to the chassis.

When performing operations against chassis, Intel recommends that you set up SSH keys using opasetupssh. If SSH keys are not set up, Intel recommends that you use the -S option to avoid keeping the password in configuration files. 🫶

---

and that's the whole page, bestie — go forth and broadcast responsibly 💜

Copyright(C) 2015-2019 Intel Corporation — mwah, thanks Intel, this page is opacmdall(8) and it ate 💅✨