Scroll to navigation

IPMCTL-DUMP-SUPPORT-DATA(1) ipmctl IPMCTL-DUMP-SUPPORT-DATA(1)

NAME

ipmctl-dump-support-data - Dumps a support snapshot to a file

SYNOPSIS

ipmctl dump [OPTIONS] -destination (file_prefix) [-dict (filename)] -support

DESCRIPTION

Creates a support snapshot and dump support data to a file for off-line analysis by support personnel. Support data may include system logs, error logs, trace logs, platform configuration, sensor information and diagnostic results.

This command may take significantly longer than other commands to complete, because it combines and executes multiple individual commands.

Commands executed:

•version

•show -memoryresources

•show -a -system -capabilities

•show -a -topology

•start -diagnostic

•show -system

Commands executed per PMem module:

•show -a -dimm

•show -a -sensor -dimm

•show -pcd -dimm

•show -error media -dimm

•show -error thermal -dimm

•dump -destination -debug

OPTIONS

-h, -help

Displays help for the command.

-ddrt

Used to specify DDRT as the desired transport protocol for the current invocation of ipmctl.

-smbus

Used to specify SMBUS as the desired transport protocol for the current invocation of ipmctl.


Note

The -ddrt and -smbus options are mutually exclusive and may not be used together.

-o (text|nvmxml), -output (text|nvmxml)

Changes the output format of the command execution (the output file content will remain text). One of: "text" (default) or "nvmxml".

TARGET

-destination (filename)

This command creates a text file with a name starting with the given filename option and dumps the platform support information into it. In addition, this command also outputs the debug log information in separate files. Refer to [Dump Debug Log] for more details.

-dict (filename)

Optional file path to the dictionary file. If supplied, the command will create both the binary debug log and a text file with decoded log data with the file prefix specified by -destination. This option is used only to dump the debug log information.

EXAMPLES

Creates a text file named dumpfile_platform_support_info.txt and stores the platform supported data in that file. Also, dumps the debug log info in the related files that start with the file name dumpfile. Refer to [Dump Debug Log] for more info on the output files.

ipmctl dump -destination filename -dict nlog_dict.1.1.0.0000.txt -support

LIMITATIONS

In order to successfully execute this command:

•The caller must have the appropriate privileges.

•The specified PMem modules must be manageable by the host software.

RETURN DATA

Returns the status of the operation.

SAMPLE OUTPUT

On success:

Dump support data successfully written to filename_platform_support_info.txt.
2022-09-26 ipmctl