opacmdall (8) - Linux Manuals

NAME

opacmdall

(Linux and Switch) Executes a command on all hosts or Intel(R) Omni-Path Chassis. This powerful command can be used for configuring servers or chassis, verifying that they are running, starting and stopping host processes, and other tasks.

NOTE: opacmdall depends on the Linux* convention that utilities return 0 for success and #8217gt;0 for failure. If opacmdall is used to execute a non-standard utility like diff or a program that uses custom exit codes, then opacmdall may erroneously report "Command execution FAILED" when it encounters a non-zero exit code. However, command output is still returned normally and the error may be safely ignored.

Syntax

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

Options

--help

Produces full help text.

-C

Performs command against chassis. Default is hosts.

-p

Runs command in parallel on all hosts/chassis.

-q

Quiet mode, do not show command to execute.

-f hostfile

File with hosts in cluster. Default is /etc/sysconfig/opa/hosts file.

-F chassisfile

File with chassis in cluster. Default is /etc/sysconfig/opa/chassis file.

-h host

List of hosts to execute command on.

-H chassis

List of chassis to execute command on.

-u user

The user to perform the command as:

•

For hosts, the default is current user code.

•

For chassis, the default is admin.

-S

Securely prompts for password for user on chassis.

-m marker

Marker for end of chassis command output. If omitted, defaults to chassis command prompt. This may be a regular expression.

-T timelimit

Time limit in seconds when running host commands. Default is -1 (infinite).

-P

Outputs the hostname/chassis name as prefix to each output line. This can make script processing of output easier.

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#8217#8217;
CHASSIS='chassis1 chassis2' opacmdall ismPortStats -noprompt#8217#8217;

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

All commands performed with opacmdall must be non-interactive in nature. opacmdall waits for the command to complete before proceeding. For example, 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.) Similarly, when running chassis commands such as fwUpdateChassis, the -reboot option should not be used beccause this option causes an immediate reboot and therefore the command never returns. 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 (see opasetupssh ). If SSH keys are not set up, Intel recommends that you use the -S option, to avoid keeping the password in configuration files.