Skip to main content
ONTAP FlexArray

Commands for checking back-end configuration

Contributors netapp-chikkusu

Several ONTAP commands provide information about the storage array configuration, including back-end configuration errors. These commands are particularly useful during installation verification and troubleshooting.

The storage array config show command is the first command to use during installation verification. It is also the first command to use if you notice that your system is not working as you expect, or if you receive an error message.

Commands that are particularly useful for installation verification and troubleshooting are shown in the following table:

Command Description

storage array config show

Provides information, at the storage array level, about the configuration of the back-end devices in a deployment with ONTAP systems using array LUNs. This command shows how storage arrays connect to the cluster. If ONTAP detects an issue that would prevent the ONTAP systems using array LUNs and storage arrays from operating properly together, storage array config show instructs you to run storage errors show to obtain details about the error.

This command is also useful for verifying that the configuration is set up as you intended. For example, you can look at the output to confirm that the number of array LUN groups that you intended were created.

storage array show -name array_name

Displays information about all storage arrays visible to the cluster or about the storage array that you specify. If the number of array LUNs presented exceeds the capacity of the system, the Error text field shows you the number of LUNs that ONTAP could not discover. You should watch for this issue on low memory systems in particular.

storage path quiesce

Temporarily suspends I/O to a specific array LUN on a specific path. The path becomes active again on reboot or by running storage path resume. Some storage arrays require ceasing I/O for a period of time to remove or move an array LUN.

Note

The storage path quiesce command cannot be used with IBM DS storage arrays.

storage path resume

Allows I/O to start flowing again; this is the inverse of quiesce. The storage path resume command is used primarily for hardware maintenance (for example, cable or GBIC pulls) or after an accidental quiescence of a path to an array LUN occurs. It is not always necessary to run this command after quiescing a path. For example, ONTAP can discover a newly mapped array LUN.

storage array show

Displays information about the storage arrays that are visible to the cluster, for example, name, vendor, model, and failover type.

storage disk show

Entering storage disk show without parameters shows the following for all disks and array LUNs: the name, usable size, container type, position, aggregate, and owner. Entering storage disk show with a disk name or an array LUN name as a parameter shows details about an individual disk or array LUN, for example, the status (assigned or unassigned), the owner, and the paths for the array LUN. The output is broken into three sections: information about the array LUN, information about the paths to the array LUN, and any errors associated with the array LUN.

storage disk show -errors **

Entering storage disk show with the `-errors parameter provides details of configuration errors at the disk and array LUN levels. Although the command output is similar to that of the storage disk error show command, storage disk show -errors provides additional options to filter the output by parameters such as node, cluster, and bay position.

storage disk error show

Provides details about back-end configuration errors at the disk and array LUN levels. Entering storage disk error show with an array LUN name as a parameter shows details about configuration errors related to the specified array LUN. You must fix these errors before configuring ONTAP to work with storage arrays.

storage errors show

Provides details, at the array LUN level, about back-end configuration errors that prevent the ONTAP system and the storage array from operating together. You must fix errors identified by storage errors show before you configure ONTAP to work with storage arrays.

Note

The storage errors show command does not provide information about disk configuration errors. To view information about both disk and array LUN configuration errors, you can use either the storage disk show -errors command or the storage disk error show command.