Skip to main content

Save storage array support data

The save storageArray supportData command saves the support-related information of the storage array to a file.

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 or Support Admin role.

Context

The following table lists the type of support data that you can collect.

Type of dataFile name and description
Automatic Load Balancing statistics

alb-statistics-A.txt

alb-statistics-B.txt

This file, one per controller, specify various statistics related to the Automatic Load Balancing feature that allow further analysis via offline analysis tool.

Core dump metadata

all-coredump.xml

This file contains core dump metadata for the array.

AutoSupport status

autosupport.xml

This file specifies the current status of ASUP for the given array.

The AutoSupport history file

autosupport-history.xml

This file specifies all ASUP messages, both standard and AutoSupport OnDemand messages, for the given array. Each entry in the table corresponds to an ASUP message currently sitting in one of the repositories for a given array.

AutoSupport logs

asup-transmission-logs.txt

This file contains all the transmitted AutoSupport messages.

Web Server Client Info

client-info.txt

This file specifies various Web Services client information.

Drive cabling topology connection.txt

This file contains information about the connections between the shelf input/output module (IOM) and the controller pair.

Cumulative statistics bundles

cumulative-drive-vol-stats.xml

This file contains cumulative statistics for the controllers.

Misbehaving drive log

controller-drive-error-event-log.txt

This file contains the storage array controller drive-side error and event log messages.

Controller health image metadata

all-coredump.xml

This file contains DPL controller health image information.

Note
Starting with the 8.25 release, core-dump-info.xml has been renamed to all-coredump.xml.
DOM 0 journal files for controller A

dom0-complete-journal-A.7z

This file, one per controller, contains detailed Linux system logs. This includes logs for Linux packages and standard Linux utilities and services.

DOM 0 journal files for controller B

dom0-complete-journal-B.7z

This file, one per controller, contains detailed Linux system logs. This includes logs for Linux packages and standard Linux utilities and services.

Miscellaneous DOM 0 log files for controller A

dom0-misc-logs-A.7z

This file, one per controller, contains system logs that cannot be contained with the Journal. This includes the serial log for the RAID Application and debug logs for the Hypervisor.

Miscellaneous DOM 0 log files for controller B

dom0-misc-logs-B.7z

This file, one per controller, contains system logs that cannot be contained with the Journal. This includes the serial log for the RAID Application and debug logs for the Hypervisor.

Drive command aging timeout values drive-command-aging-timeout.txt

This file contains the default values and current values for the command aging timeout field for every drive.

Drive health logs drive-health-data.bin

This file contains various drive information related to the drive's health.

Note
This file is a binary file and will require an offline parser to convert to human readable format.
Drive performance analyzer data

drive-performance-log.txt

This file contains drive performance data that helps you identify any drives that are performing below expectations.

Shelf event logs

expansion-tray-log.txt

IOM event logs.

Failed repository analysis

failed-repository-analysis.txt

This file contains the failed repository analysis information.

Features of the storage array feature-bundle.txt

This file contains a list of the number of volumes, drives, and shelves allowed in the storage array and a list of the features available and their limits.

Firmware inventory firmware-inventory.txt

This file contains a list of all of the firmware versions for all of the components in the storage array.

I/O path statistics io-path-statistics.7z

This file contains raw performance data for each controller that can be used to analyze application performance issues.

IOC dump info for the host interface chip ioc-dump-info.txt

This file contains IOC dump information for the host interface chip.

IOC dump logs for the host interface chip ioc-dump.gz

This file contains the log dump from the host interface chip on the controller. The file is compressed in gz format. The zip file is saved as a file inside of the Customer Support Bundle.

iSCSI connections (iSCSI only) iscsi-session-connections.txt

This file contains a list of all of the current iSCSI sessions.

iSCSI statistics (iSCSI only) iscsi-statistics.csv

This file contains statistics for the Ethernet media access control (MAC), Ethernet Transmission Control Protocol (TCP)/Internet Protocol (IP), and iSCSI target.

Major event log major-event-log.txt

This file contains a detailed list of events that occur on the storage array. The list is stored in reserved areas on the disks in the storage array. The list records configuration events and component failures in the storage array.

Manifest file

manifest.xml

This file contains a table that describes the files included in the archive file and the collected status of each of those files.

Storage management software runtime information

msw-runtime-info.txt

This file contains the storage management software application runtime information. Contains the JRE version currently used by the storage management software.

NVSRAM data nvsram-data.txt

This controller file specifies the default settings for the controllers.

Object bundle object-Bundle .bin

This bundle contains a detailed description of the status of your storage array and its components, which was valid at the time that the file was generated.

Summary performance statistics perf-stat-daily-summary-a.csv

perf-stat-daily-summary-b.csv

This file contains various controller performance statistics, one file per controller.

Persistent reservations and registrations persistent-reservations.txt

This file contains a detailed list of volumes on the storage array with persistent reservations and registrations.

Storage management software user preferences

pref-01.bin

This file contains the user preference persistent data store.

Recovery Guru procedures recovery-guru-procedures.html

This file contains a detailed list of all of the recovery guru topics that are issued in response to problems detected on the storage array. For the DE2000H/ DE4000H / DE4000F DE6000H arrays, this file contains only the recovery guru details, not the HTML files.

Recovery profile recovery-profile.csv

This file contains a detailed description of the latest recovery profile record and historical data.

SAS PHY error logs

sas-phy-error-logs.csv

This file contains the error information for SAS PHY.

State capture data state-capture-data.txt

This file contains a detailed description of the current state of your storage array.

Storage array configuration storage-array-configuration.cfg

This file contains a detailed description of the logical configuration on your storage array.

Storage array profile storage-array-profile.txt

This file contains a description of all of the components and properties of a storage array.

Trace buffer contents trace-buffers.7z

This file contains the contents of the controllers’ trace buffers that are used to record debug information.

Shelf capture data tray-component-state-capture.7z

If your shelf contains drawers, the diagnostic data is archived in this zipped file. The Zip file contains a separate text file for each shelf that contains drawers. The Zip file is saved as a file inside of the Customer Support Bundle.

Unreadable sectors unreadable-sectors.txt

This file contains a detailed list of all of the unreadable sectors that have been logged to the storage array.

Web Services Trace Log

web-server-trace-log-A.7z

web-server-trace-log-B.7z

This file, one per controller, contains Web Services trace buffers that are used to record debug information.

Workload capture analytics log file wlc-analytics-a.lz4

wlc-analytics-b.lz4

This file, one per controller, contains computed key workload characteristics such as LBA histogram, read/write ratio and I/O throughput across all active volumes.

X-header data file x-header-data.txt

This AutoSupport message header consists of plain text key-value pairs; which include information about the array and message type.

Syntax

save storageArray supportData file="filename" [force=(TRUE | FALSE)]

save storageArray supportData file="<var id="GUID-C4D9080C-D77A-41F1-8B0B-2CDDD9DA55B7__V1111201" className="keyword varname">filename</var>" 
[force=(TRUE | FALSE) |
csbSubsetid=(basic | weekly | event | daily | complete) |
csbTimeStamp=<var id="GUID-C4D9080C-D77A-41F1-8B0B-2CDDD9DA55B7__V1630894" className="keyword varname">hh:mm</var>]

Parameters

ParameterDescription
file

The file path and the file name to which you want to save the support-related data for the storage array. Enclose the file path and the file name in double quotation marks (" "). For example:

file="C:\Program Files\CLI\logs\supdat.7z"

force

This parameter forces the collection of support data if there are any failures in securing a lock on controller operations. To force the collection of support data, set this parameter to TRUE . The default value is FALSE .

csbSubsetid

This parameter collects a subset of data in the support bundle. The options for the subset of data are:

  • basic – Use this option to collect support bundle data about storage array discovery.
  • weekly – Use this option to collect support bundle data each week.
  • event – Use this option to collect support bundle data when a critical event occurs.
  • daily – Use this option to collect support bundle data every day.
  • complete – Use this option to collect all of the support bundle data. This is the default option.
csbTimeStamp

This parameter adds a time stamp to the support bundle. Enter hours and minutes in a 24-hour format. For example: 13:30 for 1:30 p.m.