collectdiag

Collects data on all SAN File System components running in the system and saves the diagnostic results to various files on the local file system of each specified engine. This command is used to assist in problem determination.

Read syntax diagramSkip visual syntax diagram
                                           .-------------.
                                           V             |
>>-collectdiag--+--------+--+---------+--+---engine_name-+-+---><
                +- -?----+  '- -quiet-'  '- - -------------'
                +- -h----+
                '- -help-'

Parameters

–? | –h | –help
Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored.
–quiet
Turns off confirmation messages for this command.
engine_name
Specifies the names of one or more engines for which to collect diagnostic data.
Note: You must be logged on to the master metadata server to issue this command against one or more non-local engine. If you are not logged on to the master metadata server, this command collects diagnostics data only for the local engine.
Specifies that you want to read the name of the engine for which to gather diagnostic data from stdin (for example, – << /work/vol_list.txt).

Prerequisites

You must have Operator or Administrator privileges to use the command.

Description

Diagnostic data is saved on each specified engine in a subdirectory of the directory specified by the TANKDIR environment variable. The default directory is /usr/tank/OBDC. The subdirectory name is the timestamp when the data is collected (for example, /usr/tank/OBDC/20030507_081010).

Example

Collect diagnostic data The following example collects diagnostic data for engine ST1:
sfscli> collectdiag ST1
Are you sure you want to collect diagnostic data for ST1 since this
procedure may take a few minutes to complete? [y/n]  Y
Diagnostic file successfully created for Engine ST1. Tip: See 
usr/tank/pmf to read the diagnostic files.

Parent topic: Administrative commands

Related reference
catlog
clearlog

Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.