storage path show

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 -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.