NAME

       opacapture

       (Host) Captures critical system information into a zipped tar file. The resulting tar file should be sent
       to Customer Support along with any Intel(R) Omni-Path Fabric problem report regarding this system.

       NOTE: The resulting host capture file can require significant amounts of space on the  host.  The  actual
       size  varies,  but sizes can be multiple megabytes. Intel recommends ensuring that adequate disk space is
       available on the host system.

Syntax

       opacapture [-d detail] output_tgz_file

Options

       --help    Produces full help text.

       -d detail Captures level of detail:

                 1 (Local) Obtains local information from host. This is the default if no options are entered.

                 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 and the server multicast membership.

                 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 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 available on a node with  Intel(R)  Omni-Path
       Fabric  Suite FastFabric Toolset installed. The information is gathered for every fabric specified in the
       /etc/opa/ports file.

       output_tgz_file
                 Specifies the name of a  file  to  be  created  by  opacapture.  The  file  name  specified  is
                 overwritten  if  it  already  exists.  Intel  recommends using the .tgz suffix in the file name
                 supplied. If the filename given does not have a .tgz suffix, the .tgz suffix is added.

Examples

       opacapture mycapture.tgz
       opacapture -d 3 030127capture.tgz