ethcmdall(8)

📦 version 12.1.0.1, in centos-stream 9, fedora 43, fedora 44, opensuse-leap 16.0

✨ ethcmdall ✨ (the section 8 page, EFSFFCLIRG fam)

okay bestie, meet ethcmdall 💖

<span cyan>(Linux)</span> This one runs a command on all the hosts. Like, all of them. She's a powerful girlie and she can configure servers, verify that they're up and running, start and stop host processes, and do a whole bunch of other tasks. main character energy fr.

⚠️ heads up: ethcmdall depends on the Linux convention that utilities return 0 for success and > 0 for failure. So if you point ethcmdall at a non-standard utility like diff, or a program that uses custom exit codes, then ethcmdall may erroneously report "Command execution FAILED" when it hits a non-zero exit code. The tea ☕ is: the command output is still returned normally and the error may be safely ignored. no cap.

🌸 Syntax 🌸

ethcmdall [-pqP] [-f  hostfile] [-h  hosts] [-u  user]

[-T  timelimit]  cmd

🎀 Options 🎀

  • --help — produces the full help text. slay, she tells you everything.
  • -p — runs the command in parallel on all hosts. go go go 🔥
  • -q — quiet mode, meaning she does not show the command to execute. shhh 🤫
  • -P — outputs the hostname as a prefix to each output line. this one's lowkey iconic because it can make script processing of the output easier. 💅
  • -f hostfile — specifies the file with hosts in cluster. the default is the /etc/eth-tools/hosts file. 📁
  • -h host — specifies the list of hosts to execute the command on.
  • -u user — specifies the user to perform the command as:
    • For hosts, the default is the current user. 👑
  • -T timelimit — specifies the time limit in seconds when running host commands. default is -1 (infinite). literally forever, bestie ♾️

🦋 Examples 🦋

Operations on Host

ethcmdall date
ethcmdall 'uname -a'
ethcmdall -h 'elrond arwen' date
HOSTS='elrond arwen' ethcmdall date

🌈 Environment Variables 🌈

The following environment variables are also used by this command, bestie:

  • HOSTS — list of hosts, used if the -h option is not supplied.
  • HOSTS_FILE — file containing the list of hosts, used in absence of -f and -h.
  • FF_MAX_PARALLEL — when the -p option is used, maximum concurrent operations are performed. 🏃‍♀️💨
  • FF_SERIALIZE_OUTPUT — serialize output of parallel operations (yes or no).

💜 Notes 💜

All commands performed with ethcmdall must be non-interactive in nature. She waits for the command to complete before proceeding, so like… don't ask her to hold a conversation mid-task. 🙈

For example, when running host commands such as rm, the -i option (interactively prompt before removal) should not be used. And yes, note that this option is sometimes part of a standard bash alias list — so double check your aliases, girlie. For further information about Linux operating system commands, consult the man pages.

When performing ethcmdall against hosts, SSH is used internally. The command ethcmdall requires that password-less SSH be set up between the host running the Intel(R) Ethernet Fabric Suite FastFabric Toolset and the hosts ethcmdall is operating against. The ethsetupssh FastFabric tool can aid in setting up password-less SSH. 🫶

and that's the whole vibe check ✨ this page is ethcmdall(8), straight out of the EFSFFCLIRG man page, brought to you by Intel Corporation, copyright Copyright(C) 2020-2024. ty for coming to my ted talk, go run some commands on every host, periodt 💅🎀🦋

📦 where this page comes from