Skip to main content

Cornelis Technical Documentation

Name

opacaptureCaptures critical system information into a zipped tar file.

Syntax

opacapture [-d detail] output_tgz_file

Description

The resulting tar file should be sent to Customer Support along with any CN5000 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. Cornelis recommends ensuring that adequate disk space is available on the host system.

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.

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 the Omni-Path Fabric 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. Cornelis 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