Provided by: opa-fastfabric_10.8.0.0.201+dfsg.1-1_amd64 bug

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
       >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 [-CpqPS] [-f hostfile] [-F chassisfile] [-h hosts]
       [-H chassis] [-u user] [-m marker] [-T timelimit] 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.

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

       -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).

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

       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  because
       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
       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.