Purpose
System administrators can collect the must-gather diagnostic data
that is required for reporting a problem to IBM®
support.
Syntax
platform must-gather filename [ PDfilename ]
Parameters
- filename
- Specifies the name of the output file that contains all diagnostic
data, in a compressed (.tgz) format.
- Use either the
.tgz or the .tar.gz suffix
for the output file name.
- PDfilename
- Specifies the name of the text file that the output of the problem
diagnostic commands is written to. This file contains the same output
that is collected by the platform collect-pd command. If
not specified, the default value is collect-pd.txt. If the
output file exists, the file is overwritten.
Usage Notes®
- This command must only be run by an administrator.
- This command is used by IBM support.
- The output might include both clear text and obscured data that
is intended to be read only by IBM support.
- You must use the imaserver trace flush command
before you use the platform must-gather command.
- Output files that are produced by this command are automatically
deleted during normal appliance restart or shutdown.
Example
Collect diagnostic data to a file called problem-data.tgz. admin@(none)> platform must-gather problem-data.tgz
admin@(none)> file list
problem-data.tgz 3449276 bytes created Mar 27, 2012 11:15:48 AM
collect-pd.txt 572878 bytes created Mar 27, 2012 11:15:48 AM
admin@(none)>