storage path show

Display a list of paths to attached arrays.

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

Description

The storage path show command displays path based statistics. The default command shows:

Parameters

{ [-fields <fieldname>, ...]
If you specify the -fields <fieldname>, ... parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.
| [-array ]
Using this option displays:
  • Array name
  • Target port
  • Target IQN
  • Target I/O in Kbytes/sec
  • Target side switch port
  • Path I/O in Kbytes/sec
  • Initiator side switch port
  • Initiator I/O in Kbytes/sec
  • Initiator port
| [-by-target ]
Using this option displays the same information as the array option, but grouped by target port.
| [-detail ]
Using this option displays the same information as the array and by-target options, but adds the following:
  • Target IOPs
  • Target LUNs
  • Path IOPs
  • Path errors
  • Path quality
  • Path LUNs
  • Initiator IOPs
  • Initiator LUNs
| [-switch ]
Using this option adds switch port information to the default display.
| [-instance ]}
If you specify the -instance parameter, the command displays detailed information about all fields.
[-node {<nodename>|local}] - Controller name
The name of the clustered node for which information is being displayed.
[-array-name <array name>] - Array Name
Name of the storage array that is connected to the cluster.
[-target-wwpn <text>] - Target Port
Target World Wide Port Name. Port on the storage array that is being used.
[-initiator <text>] - Initiator Port
Initiator port that the clustered node uses.
[-initiator-side-switch-port <text>] - Initiator Side Switch Port
Switch port connected to the clustered node.
[-tpgn <integer>] - Target Port Group Number
TPGN refers to the target port group to which the target port belongs. A target port group is a set of target ports which share the same LUN access characteristics and failover behaviors.
[-port-speed <text>] - Port Speed
Port Speed of the specified port.
[-path-io-kbps <integer>] - Kbytes of I/O per second on Path (Rolling Average)
Rolling average of I/O per second on the path.
[-path-iops <integer>] - Number of IOPS on Path (Rolling Average)
Rolling average of Kbytes of I/O per second on the path
[-initiator-io-kbps <integer>] - Kbytes of I/O per second on Initiator (Rolling Average)
Rolling average of I/O per second on the initiator port.
[-initiator-iops <integer>] - Number of IOPS on Initiator (Rolling Average)
Rolling average of Kbytes of I/O per second on the initiator port.
[-target-io-kbps <integer>] - Kbytes of I/O per second to Target (Rolling Average)
Rolling average of I/O per second on the target port.
[-target-iops <integer>] - Number of IOPS to Target (Rolling Average)
Rolling average of Kbytes of I/O per second on the target port.
[-target-side-switch-port <text>] - Target Side Switch Port
Switch port connected to the array.
[-path-link-errors <integer>] - Link Error count on path
Fibre Channel link error count.
[-path-quality <integer>] - Percentage of weighted error threshold
A number representing the threshold of errors that is allowed on the path. Path quality is a weighted error value. When the error weight of a path exceeds the threshold, I/O is routed to a different path.
[-path-lun-in-use-count <integer>] - Number of LUNs in the in-use state on this path
Number of LUNs on this path.
[-initiator-lun-in-use-count <integer>] - Number of LUNs in the in-use state on this initiator
Number of LUNs on this initiator.
[-target-lun-in-use-count <integer>] - Number of LUNs in the in-use state on this target
Number of LUNs on this target.
[-vmdisk-device-id <integer>] - Virtual disk device ID
Common device identifier, shared by a VM and its hypervisor, of a virtual disk. On ESX servers, this is the Disk ID component of a virtual device node, with a value of 0 to 15.
[-path-failure-threshold <integer>] - Max number of path failures acceptable in wait-duration
The path failure count, exceeding this value within wait duration will quiesce the path.
[-wait-duration <integer>] - Wait Duration in minutes
The time duration(minutes) in which path is monitored for path failures.

Examples

The following example shows the default display.

			vbv3170f2a::> storage path show
                                                                                Path I/O
Node                   Initiator  Array Target Port          TPGN    Speed        (KB/s)          IOPS
---------------------  ---------  -----------------------  ------  -------  ------------  ------------
vbv3170f2a-01          0b         50001fe1500a866c              2   2 Gb/S             6             2
vbv3170f2a-01          0b         50001fe1500a866d              2   2 Gb/S             0             0
vbv3170f2a-01          0c         50001fe1500a866e              4   4 Gb/S             0             0
vbv3170f2b-03          0a         50001fe1500a866d              1   2 Gb/S             3             1
vbv3170f2b-03          0c         50001fe1500a866f              4   4 Gb/S             3             1
5 entries were displayed.
		

The following example shows how the information is displayed with the array option.

			vnv3070f20b::> storage path show -array
Node: vnv3070f20b
                                    Target I/O          Target Side     Path I/O       Initiator Side Initiator I/O Initiator
Array Name       Target Port            (KB/s)          Switch Port       (KB/s)          Switch Port        (KB/s)      Port
---------------- ---------------- ------------ -------------------- ------------ -------------------- ------------- ---------
HITACHI_DF600F_1 50060e80004291c0            0        vnbr3850s5:12            0         vnbr3850s4:4             3        0a
                 50060e80004291c2            0     vnci9124s54:1-22            0      vnci9124s54:1-6            26        0c
IBM_1722_1       200600a0b819e16f            3        vnbr3850s5:15            3         vnbr3850s4:4             3        0a
                 200700a0b819e16f           26     vnci9124s54:1-24           26      vnci9124s54:1-6            26        0c
4 entries were displayed.

		

The following example shows how the information is displayed when grouped by target.

			vnv3070f20b::> storage path show -by-target
Node: vnv3070f20b
Array Name: HITACHI_DF600F_1
                   Target I/O          Target Side     Path I/0       Initiator Side Initiator I/O Initiator
Target Port            (KB/s)          Switch Port       (KB/s)          Switch Port        (KB/s)      Port
---------------- ------------ -------------------- ------------ -------------------- ------------- ---------
50060e80004291c0            0        vnbr3850s5:12            0         vnbr3850s4:4             3        0a
50060e80004291c2            0     vnci9124s54:1-22            0      vnci9124s54:1-6            26        0c
Node: vnv3070f20b
Array Name: IBM_1722_1
                   Target I/O          Target Side     Path I/0       Initiator Side Initiator I/O Initiator
Target Port            (KB/s)          Switch Port       (KB/s)          Switch Port        (KB/s)      Port
---------------- ------------ -------------------- ------------ -------------------- ------------- ---------
200600a0b819e16f            3        vnbr3850s5:15            3         vnbr3850s4:4             3        0a
200700a0b819e16f           26     vnci9124s54:1-24           26      vnci9124s54:1-6            26        0c
4 entries were displayed.

		

The following example shows how the information is displayed with the switch option.

			vbv3170f2b::> storage path show -switch
                                                           Target Side          Initiator Side                             Path I/O
Node                   Initiator  Array Target Port        Switch Port          Switch Port             TPGN    Speed        (KB/s)          IOPS
---------------------  ---------  -----------------------  -------------------- --------------------  ------  -------  ------------  ------------
vbv3170f2a-01          0b         50001fe1500a866c         vbbr300s1:6          vbbr300s1:2                2   2 Gb/S             9             3
vbv3170f2a-01          0b         50001fe1500a866d         vbbr300s1:7          vbbr300s1:2                2   2 Gb/S             0             0
vbv3170f2a-01          0c         50001fe1500a866e         vbci9124s2:1-7       vbci9124s2:1-3             4   4 Gb/S             0             0
vbv3170f2b-03          0a         50001fe1500a866d         vbbr300s1:7          vbbr300s1:3                1   2 Gb/S             4             1
vbv3170f2b-03          0c         50001fe1500a866f         vbci9124s2:1-8       vbci9124s2:1-4             4   4 Gb/S             4             1
5 entries were displayed.