ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • 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:

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

    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.
    Top of Page