application commands
storage path show
Suggest changes
PDFs
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:
-
Node name
-
Initiator port
-
Target port
-
Target IQN
-
TPGN
-
Port speeds
-
Path I/O in Kbytes/sec
-
IOPs
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
-instanceparameter, 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.