Save storage array support data

09/10/2024 Contributors

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

Supported Arrays

This command applies to any individual storage array, including the E4000, E2700, E5600, E2800, E5700, EF600 and EF300 arrays, as long as all SMcli packages are installed.

Roles

To execute this command on an E4000, E2800, E5700, EF600, or EF300 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 data File 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.

Starting with the 8.25 release, core-dump-info.xml has been renamed to all-coredump.xml.

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.

This parameter is not applicable for E2700 and E5600 arrays.

Drive cabling topology

connection.txt This file contains information about the connections between the drive tray environmental services module (ESM) 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.

Starting with the 8.25 release, core-dump-info.xml has been renamed to all-coredump.xml.

DOM 0 journal files for controller A (E2800 or E5700 only)

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 (E2800 or E5700 only)

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 (E2800 or E5700 only)

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 (E2800 or E5700 only)

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.

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.

Enterprise Management Window configuration

emwdata_v04.bin

This file contains the EMW configuration data store file.

In support bundles for the E2800 and E5700, this file isn't present.

Tray event logs

expansion-tray-log.txt

ESM 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 drive trays 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.

InfiniBand interface statistics (InfiniBand only)

ib-statistics.csv

This file contains the InfiniBand interface statistics.

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.

iSER interface statistics (iSER over InfiniBand only)

iser-statistics.csv This file contains the statistics for the host interface card that runs iSER over InfiniBand.

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.

NVMe-oF statistics

nvmeof-statistics.csv

This file contains a list of statistics, including NVMe controller statistics, NVMe queue statistics, and interface statistics for the transport protocol (for example, InfiniBand).

NVSRAM data

nvsram-data.txt This controller file specifies the default settings for the controllers.

Object bundle

object-bundle.binobject-bundle.json

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.

In support bundles for the E2800 or E5700, this file is not present.

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 E2800 and E5700 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.

Tray capture data

tray-component-state-capture.7z If your tray contains drawers, the diagnostic data is archived in this zipped file. The Zip file contains a separate text file for each tray 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 (E2800 or E5700 only)

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="filename"
[force=(TRUE | FALSE) |
csbSubsetid=(basic | weekly | event | daily | complete) |
csbTimeStamp=hh:mm]

Parameters

Parameter Description

Parameter	Description
`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`.

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.

Notes

Starting with firmware level 7.86, the file name extension must be .7z. If you are running a firmware version earlier than 7.86, the files extension must be .zip.

Minimum firmware level

7.80 adds the force parameter.

8.30 adds information for the E2800 storage array.