Save storage array controller health image

The save storageArray controllerHealthImage command saves a controller health image to a specified file on a host, for storage arrays that support the controller health image feature.

Supported Arrays

This command applies to an individual DE2000H, DE4000H, DE4000F, DE6000H, or DE6000F storage array.

Roles

To execute this command on an storage array, you must have the Storage Admin role.

Context

If the storage array does not support the controller health image feature, the command returns an error.

Syntax

save storageArray controllerHealthImage file="filename" 

Parameter

Parameter Description
file

The file path and the file name to which you save the controller health image. Enclose the file name in double quotation marks (" "). For example:

file="C:\Array Backups\DBMbackup_03302010.core"

Notes

A controller health image file might be one to two gigabytes in size, and take several minutes to save. In addition to saving the controller health image itself, this command generates an XML descriptor file based on the controller health image metadata. This descriptor file is saved in ZIP file format to the same path as the controller health image. The following example show the XML format for the descriptor file.
<?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
- <DPLcontrollerHealthImageInfo> 
<dplcontrollerHealthImageTag>sometag#</dplcontrollerHealthImageTag> 
<captureTime>12/22/10 3:58:53 PM IST</captureTime> 
- <StorageArrayData> 
<ArraySAID>600a0b80006e006a000000004c65efc1</ArraySAID> 
<ManagementApiVersion>devmgr.v1083api01.Manager</ManagementApiVersion> 
<fwVersion>07.83.01.00</fwVersion> 
<platformType>7091</platformType> 
</StorageArrayData> 
<fullcontrollerHealthImageCtlr>controllerserialNumber1
     </fullcontrollerHealthImageCtlr> 
<fullcontrollerHealthImageSize>fullCaptureSize</fullcontrollerHealthImageSize> 
<altcontrollerHealthImageCtlr>controllerserialNumber2</altcontrollerHealthImage
     Ctlr> 
<altcontrollerHealthImageSize>altCaptureSize</altcontrollerHealthImageSize> 
<triggerReason>Exception</triggerReason>-<DPLcontrollerHealthImageDetail> 
<dplcontrollerHealthImageReason>DPLcontrollerHealthImageReason
     </dplcontrollerHealthImageReason> 
- <fwLocation > 
<filename>filename</filename> 
<lineNumber>line#</lineNumber> 
</fwLocation > 
<panicReason>panicString</panicReason> 
</DPLcontrollerHealthImageDetail> 
</DPLcontrollerHealthImageInfo>

When you retrieve a controller health image from the controller cache to a host, a flag is set on the controller to indicate that the controller health image does not need to be retrieved. This setting persists for 48 hours. If a new controller health image occurs during that period, the new controller health image is saved to the controller cache and overwrites any previous controller health image data in cache.