Skip to main content

Start controller trace

The start controller command starts an operation that saves debug trace information to a compressed 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 role.

Context​

The debug trace information can be used by technical support to help analyze how well a storage array is running.

Syntax​

start controller [(<span className="ph">a</span>
 | <span className="ph">b</span>
 | both)] trace 
dataType=(current | flushed | currentFlushed | all) 
forceFlush=(TRUE | FALSE) 
file="<var id="GUID-B96F5112-8366-4D53-84B6-6630C0A156A6__V1653534" className="keyword varname">fileName</var>"

Parameters​

ParameterDescription
controller The controller for which you want to collect the trace debug information. Valid controller identifiers are a or b , where a is the controller in slot A , and b is the controller in slot B . You can also simultaneously collect debug for both controllers by entering both . Enclose the controller identifier in square brackets ([ ]). If you do not specify a controller, the storage management software returns a syntax error.
dataType

The type of data that you want to collect:

  • current – Retrieves the current DQ traces
  • flushed – Retrieves all flushed DQ traces
  • currentFlushed – Retrieves both the current DQ trace and the flushed DQ trace
  • all – Retrieves the current DQ trace, flushed DQ trace, and all platform DQ traces

NOTE – If dataType=flushed and forceFlush=True , an error message is returned indicating that only active traces can be flushed to the buffer on retrieval.

forceFlush

The setting to move the DQ information in the current buffer to the flushed buffer when the DQ trace information defined by the dataType parameter is retrieved. To enable force flush, set this parameter to TRUE . To disable force flush, set this parameter to FALSE .

NOTE – If dataType=flushed and forceFlush=True , an error message is returned indicating that only active traces can be flushed to the buffer on retrieval.

file

The file path and the file name to which you want to save the DQ trace information. Enclose the file name in double quotation marks (" ").

Refer to the Notes section for information about naming the files.

Notes​

The DQ trace information is written to a compressed file with an extension of .zip. The file name is a combination of a user-defined file name and the storage array identifier (SAID). A constant of "dq" is also added to the file name. The complete file name has this form:


<var id="GUID-B96F5112-8366-4D53-84B6-6630C0A156A6__V1173443" className="keyword varname">
    user_defined_file_name
</var>
-SAID-dq.zip

The compressed file contains the information listed in this table.

File NameDirectoryComments
user_provided_file_name-SAID-A.dqSAID/timestamp/The DQ trace data retrieved from controller A.
user_provided_file_name-SAID-B.dqSAID/timestamp/The DQ trace data retrieved from controller B.
user_provided_file_name-SAID-trace_description.xmSAID/timestamp/The description file in an xml format that describes the DQ file attributes for future data mining.