Skip to main content

storage array disk paths show

Contributors
Suggest changes

Display a list of LUNs on the given array

Availability: This command is available to cluster administrators at the admin privilege level.

Description

The storage array disk paths show command displays information about disks and array LUNs. Where it appears in the remainder of this document, "disk" may refer to either a disk or an array LUN. By default, the command displays the following information about all disks:

  • Disk Unique Identifier

  • Controller name

  • Initiator Port

  • LUN ID

  • Failover optimization type

  • The Use State of the LUN on this path

  • Target Port

  • Target IQN

  • TPGN

  • Port speeds

  • Kbytes/sec on Disk (Rolling Average)

  • Number IOPS per second on disk (Rolling Average)

To display detailed information about a single disk, use the -disk parameter.

Parameters

{ [-fields <fieldname>,…​]

Displays the specified fields for all disks, in column style output.

| [-switch ]

Displays the switch port information for all disks, in column style output.

| [-instance ] }

Displays detailed disk information. If no disk path name is specified, this parameter displays the same detailed information for all disks as does the -disk parameter. If a disk path name is specified, then this parameter displays the same detailed information for the specified disks as does the -disk parameter.

[-uid <text>] - Disk Unique Identifier

Selects the disks whose unique id matches this parameter value. A disk unique identifier has the form: `20000000:875D4C32:00000000:00000000:00000000:00000000:00000000:00000000:00000000:00000000 `

[-disk <disk path name>] - Disk Name

Displays detailed information about the specified disks.

[-array-name <array name>] - Array Name

Selects information about the LUNs presented by the specified storage array.

[-diskpathnames <disk path name>,…​] - Path-Based Disk Names

Selects information about disks that have all of the specified path names.

[-nodelist {<nodename>|local}] - Controller name

Selects information about disks that are visible to all of the specified nodes .

[-initiator <text>,…​] - Initiator Port

Selects information about disks that are visible to the initiator specified. Disks that are not currently in use by that initiator are included.

[-lun <integer>,…​] - LUN ID

Selects information about the specified LUNs.

[-target-wwpn <text>,…​] - Target Port

Selects information about disks that are visible on target ports identified by their World Wide Port Name.

[-initiator-side-switch-port <text>,…​] - Initiator Side Switch Port

Selects information about disks visible to an initiator that is connected to the specified switch port.

[-lun-path-use-state <text>,…​] - The Use State of the LUN on this path

Selects information about LUNs reporting the specified in-use state.

[-tpgn <integer>,…​] - Target Port Group Number

Selects information about disks that belong to the specified Target Port Group Number.

[-port-speed <text>,…​] - Port Speed

Selects information about disks served by a Host Bus Adapter that is running at the specified port speed.

[-lun-io-kbps <integer>,…​] - Kbytes/sec on Disk (Rolling Average)

Selects information about the LUNs that have reached the specified I/O throughput.

[-lun-iops <integer>,…​] - Number IOPS per second on disk (Rolling Average)

Selects information about the LUNs that have reached the specified number of IOPs.

[-target-side-switch-port <text>,…​] - Target Side Switch Port

Selects information about disks that are visible on target ports identified by the switch port to which they are connected.

[-target-port-access-state <text>,…​] - Failover optimization type

Selects information about disks visible on target ports that have the specified access state.

[-initiator-io-kbps <integer>,…​] - Kbytes of I/O per second on Initiator (Rolling Average)

Selects information about disks visible to an initiator that has executed I/O at the specified throughput.

[-initiator-iops <integer>,…​] - Number of IOPS on Initiator (Rolling Average)

Selects information about disks visible to an initiator that has executed the specified number of IOPs.

[-target-io-kbps <integer>,…​] - Kbytes of I/O per second to Target (Rolling Average)

Selects information about disks visible on target ports that have reached the specified I/O throughput.

[-target-iops <integer>,…​] - Number of IOPS to Target (Rolling Average)

Selects information about disks visible on target ports that have performed the specified number of IOPs.

[-path-link-errors <integer>,…​] - Link Error count on path

Selects information about disks with paths that have incurred the specified number of FC link errors.

[-path-io-kbps <integer>,…​] - Kbytes of I/O per second on Path (Rolling Average)

Selects information about disk with paths that have reached the specified I/O throughput.

[-path-iops <integer>,…​] - Number of IOPS on Path (Rolling Average)

Selects information about disks on those paths that have reached the specified number of IOPs.

[-path-quality <integer>,…​] - Percentage of weighted error threshold

Selects information about disks on paths that have incurred the specified number of errors. The value displayed is a measure of the health of a path expressed as a percentage of an error threshold. Once a path has reached or surpassed the error threshold, another path will be selected for I/O transfer, if there is one available.

[-path-lun-in-use-count <integer>,…​] - Number of LUNs in the in-use state on this path

Selects information about disks with paths that have the specified in-use-count.

[-initiator-lun-in-use-count <integer>,…​] - Number of LUNs in the in-use state on this initiator

Selects information about disks with a path through an initiator that has the specified in-use-count.

[-target-lun-in-use-count <integer>,…​] - Number of LUNs in the in-use state on this target

Selects information about disks with a path through a target port that has the specified in-use-count.

[-preferred-target-port {true|false}] - Whether or not target port group is preferred

Selects information about disks that match the specified parameter value indicating whether the backing storage is ALUA (Assymetric Logical Unit Access) capable and has specified the array target port on this path to be a preferred target port for I/O.

[-vmdisk-device-id <integer>,…​] - Virtual disk device ID

Selects information about disks that have the specified virtual disk device ID.

[-host-adapter <text>] - Primary Path Host Adapter

Selects information about disks that are currently using the specified Host Bus Adapter.

[-primary-port <text>] - Primary Path Disk Port

Selects information about disks that use the specified primary port.

[-secondary-name <disk path name>] - Secondary Path Name

Selects information about disks that use the specified secondary path name, for multipath configuration.

[-secondary-port <text>] - Secondary Path Disk Port

Selects information about disks that use the specified secondary port.

Examples

The following example displays information about all disks:

cluster1::> storage array disk paths show
Disk Name: 1.0.20
UID: 5000C500:0979E09F:00000000:00000000:00000000:00000000:00000000:00000000:00000000:00000000
                                LUN                                                Link      Disk I/O
Controller         Initiator     ID  Acc  Use  Target Port                TPGN    Speed        (KB/s)          IOPS
node2              3a             0  AO   INU  5000c5000979e09d             80   9 Gb/S             0             0
node2              3c             0  AO   RDY  5000c5000979e09e             12   9 Gb/S             0             0
node1              3a             0  AO   RDY  5000c5000979e09e             12   9 Gb/S             0             0
node1              3c             0  AO   INU  5000c5000979e09d             80   9 Gb/S             0             0
Disk Name: 1.0.22
UID: 5000C500:0979E3C3:00000000:00000000:00000000:00000000:00000000:00000000:00000000:00000000
                                LUN                                                Link      Disk I/O
Controller         Initiator     ID  Acc  Use  Target Port                TPGN    Speed        (KB/s)          IOPS
node2              3a             0  AO   INU  5000c5000979e3c1             83   9 Gb/S             0             0
node2              3c             0  AO   RDY  5000c5000979e3c2             15   9 Gb/S             0             0
node1              3a             0  AO   RDY  5000c5000979e3c2             15   9 Gb/S             0             0
node1              3c             0  AO   INU  5000c5000979e3c1             83   9 Gb/S             0             0
Disk Name: 1.0.19
UID: 5000C500:0979E3F3:00000000:00000000:00000000:00000000:00000000:00000000:00000000:00000000
                                LUN                                                Link      Disk I/O
Controller         Initiator     ID  Acc  Use  Target Port                TPGN    Speed        (KB/s)          IOPS
node2              3a             0  AO   RDY  5000c5000979e3f1             86   9 Gb/S             0             0
node2              3c             0  AO   INU  5000c5000979e3f2             18   9 Gb/S             0             0
node1              3a             0  AO   INU  5000c5000979e3f2             18   9 Gb/S             0             0
node1              3c             0  AO   RDY  5000c5000979e3f1             86   9 Gb/S             0             0
Disk Name: 1.0.16
UID: 5000C500:0979EBEB:00000000:00000000:00000000:00000000:00000000:00000000:00000000:00000000
                                LUN                                                Link      Disk I/O
Controller         Initiator     ID  Acc  Use  Target Port                TPGN    Speed        (KB/s)          IOPS
node2              3a             0  AO   INU  5000c5000979ebe9             71   9 Gb/S           283             3
node2              3c             0  AO   RDY  5000c5000979ebea              3   9 Gb/S             0             0
node1              3a             0  AO   RDY  5000c5000979ebea              3   9 Gb/S             0             0
node1              3c             0  AO   INU  5000c5000979ebe9             71   9 Gb/S             3             0
[...]