ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • storage array disk paths show

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