mkdevicedump

Edit online

Use the mkdevicedump command to collect diagnostic information on a storage device. The only storage devices currently supported by this command are DS8000 devices using an HMC connection. Users with administrator authority who have administrator or service authorization on the HMC can issue the mkdevicedump command through the HMC connection.

Syntax

Parameters

-help | -h | -?

Lists help for the command. If you specify additional parameters and arguments, those parameters and arguments are ignored.

-quiet

Suppresses the confirmation prompt for this command. This flag answers yes to all confirmation prompts.

-type warmstart | odd |saveuilogs

Specifies the type of diagnostic information to collect on a storage device.

warmstart

The -type warmstart parameter initiates a warmstart on the storage system, which causes the storage system to collect a state save that is useful in diagnosing problems. This action should only be used under the direction of your technical support representative. This action is restricted to the following usage rules enforced by the storage system and not the server:

Five minutes must pass before you can reissue the -type warmstart parameter.
If you enter the -type warmstart parameter more than 10 times during a 24-hour period, the warmstart does not collect the microcode diagnostic data.

odd: The -type odd parameter initiates an on-demand dump request.

saveuilogs: The -type saveuilogs parameter initiates a statesave for the UI log data of the storage system.

device_id | -

Specifies the ID of the storage system that you want to collect diagnostic data on.

Tip: To list the valid storage system IDs, use the lsdevice command.

Example: Issuing a warmstart on an IBM DS8000

The following command refreshes the storage system DS8000:BOX:2107.02341 before the command has completed.

csmcli> mkdevicedump -type warmstart DS8000:BOX:2107.02341

The following output is returned when command has been submitted and accepted by the server:

This command initiates a warmstart on the storage image, which causes the
storage image to collect microcode data that is useful in diagnosing problems.
Do you want to continue? [y/n]:y

IWNH2000I [Aug 18, 2017 2:18:20 PM] The create state save command with warmstart option succeeded for storage system 2107.BAY81.option succeeded for storage system 2107.BAY81.