Provided by: opa-fastfabric_10.10.3.0.11-1ubuntu1_amd64 bug

NAME

       opacaptureall

       (Chassis  and Host) Captures supporting information for a problem report from all hosts or Intel(R) Omni-
       Path Chassis and uploads to this system.

       For Hosts: When a host opacaptureall is performed, opacapture is run to create the specified capture file
       within  ~root  on  each  host (with the .tgz suffix added as needed). The files are uploaded and unpacked
       into a matching directory name within upload_dir/hostname/ on the local system. The default file name  is
       hostcapture.

       For  Chassis: When a chassis opacaptureall is performed, opacapture is run on each chassis and its output
       is saved to upload_dir/chassisname/file on the local system. The default file name is chassiscapture.

       For both host and chassis capture, the uploaded captures are combined into a .tgz file with the file name
       specified and the suffix .all.tgz added.

Syntax

       opacaptureall [-C] [-p] [-f  hostfile] [-F  chassisfile] [-h 'hosts']

       [-H 'chassis'] [-t  portsfile] [-d  upload_dir] [-S] [-D  detail_level]

       [ file]

Options

       --help

                 Produces full help text.

       -C

                 Performs capture against chassis. Default is hosts.

       -p

                 Performs  capture upload in parallel on all host/chassis. For a host capture, this only affects
                 the upload phase.

       -f hostfile

                 Specifies the file with hosts in cluster. Default is /etc/opa/hosts file.

       -F chassisfile

                 Specifies the file containing a list of chassis in the  cluster.  Default  is  /etc/opa/chassis
                 file.

       -h hosts

                 Specifies the list of hosts on which to perform a capture.

       -H chassis

                 Specifies the list of chassis on which to perform a capture.

       -t portsfile

                 Specifies  the  file  with  list of local HFI ports used to access fabric(s) for switch access.
                 Default is /etc/opa/ports file.

       -d upload_dir

                 Specifies the directory to upload to. Default is uploads. If  not  specified,  the  environment
                 variable UPLOADS_DIR is used. If that is not exported, the default ./uploads is used.

       -S

                 Securely prompts for password for administrator on a chassis.

       -D detail_level

                 Specifies  the  level  of  detail of the capture passed to host opacapture. (Only used for host
                 captures; ignored for chassis captures.)

                 1 (Local) Obtains local information from each host.

                 2 (Fabric)
                           In addition to Local, also obtains basic fabric information by queries to the SM  and
                           fabric error analysis using opareport.

                 3 (Fabric+FDB)
                           In addition to Fabric, also obtains the Forwarding Database (FDB), which includes the
                           switch forwarding tables from the SM.

                 4 (Analysis)
                           In addition to Fabric+FDB, also obtains opaallanalysis results. If opaallanalysis has
                           not yet been run, it is run as part of the capture.

       NOTE:  Detail  levels  2-4  can  be  used when fabric operational problems occur. If the problem is node-
       specific, detail level 1 should be sufficient. Detail levels 2-4 require an  operational  Intel(R)  Omni-
       Path Fabric Suite Fabric Manager. Typically your support representative requests a given detail level. If
       a given detail level takes excessively long or fails to be gathered, try a lower detail level.

       For detail levels 2-4, the additional information is only gathered on the node running the  opacaptureall
       command. The information is gathered for every fabric specified in the /etc/opa/ports file.

       file

                 Specifies  the name for capture file. The suffix .tgz is appended if it is not specified in the
                 name.

Examples

Host Capture Examples

       opacaptureall

       # Creates a hostcapture directory in upload_dir/hostname/ for each host
       in /etc/opa/hosts file, then creates hostcapture.all.tgz.

       opacaptureall mycapture

       # Creates a mycapture directory in upload_dir/hostname/ for each host
       in /etc/opa/hosts file, then creates mycapture.all.tgz.

       opacaptureall -h 'arwen elrond' 030127capture

       # Gets the list of hosts from arwen elrond file and creates
       030127capture.tgz file.

Chassis Capture Examples

       opacaptureall -C

       # Creates a chassiscapture file in upload_dir/chassisname/ for each
       chassis in /etc/opa/chassis file, then creates chassiscapture.all.tgz.

       opacaptureall -C mycapture

       # Creates a mycapture.tgz file in upload_dir/chassisname/ for each
       chassis in /etc/opa/chassis file, then creates mycapture.all.tgz.

       opacaptureall -C -H 'chassis1 chassis2' 030127capture

       # Captures from chassis1 and chassis2, and creates 030127capture.tgz file.

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 option is not supplied.

       HOSTS_FILE

                 File containing a list of hosts, used in the absence of -f and -h.

       CHASSIS_FILE

                 File containing a list of chassis, used in the absence of -F and -H.

       UPLOADS_DIR

                 Directory to upload to, used in the absence of -d.

       FF_MAX_PARALLEL

                 When -p option is used, maximum concurrent operations are performed.

       FF_CHASSIS_LOGIN_METHOD

                 How to log into chassis. Can be Telnet or SSH.

       FF_CHASSIS_ADMIN_PASSWORD

                 Password for administrator on all chassis. Used in absence of -S option.

More Information

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

       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 all chassis be configured with the same admin  password
       and that you use of the -S option to avoid keeping the password in configuration files.

       NOTE: The resulting host capture files can require significant amounts of space on the Intel(R) Omni-Path
       Fabric Suite FastFabric Toolset host. Actual size varies, but sizes can be multiple megabytes  per  host.
       Intel  recommends  that  you  ensure  adequate  space is available on the Intel(R) Omni-Path Fabric Suite
       FastFabric Toolset system. In many cases, it may not be necessary to run opacaptureall against all  hosts
       or  chassis; instead, a representative subset may be sufficient. Consult with your support representative
       for further information.