ONTAP 9.12.1 commands

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

    Display information about a storage array’s target ports.

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

    Description

    The storage array port show command displays all the target ports known to the cluster for a given storage array (if an array name is specified) or for all storage arrays if no storage array name is specified. Target ports remain in the database as part of an array profile unless you explicitly remove them from the database.

    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.

    | [-instance ] }

    If you specify the -instance parameter, the command displays detailed information about all fields.

    [-name <text>] - Name

    Selects the array ports that match this parameter value. The storage array name is either generated by Data ONTAP or assigned by the user.

    [-wwnn <text>] - WWNN

    Selects the array ports that match this parameter value.

    [-wwpn <text>] - WWPN

    Selects the array ports that match this parameter value.

    [-max-queue-depth <integer>] - Target Port Queue Depth

    Selects the array ports that match this parameter value.

    [-node {<nodename>|local}] - Controller Name

    Selects the array ports that match this parameter value.

    [-initiator-port <text>,…​] - Initiator Port

    Selects the array ports that match this parameter value.

    [-average-dynamic-queue-depth <integer>,…​] - Average Dynamic Queue Depth

    The average value of the dynamic target port queue depth.

    [-average-latency-per-iop <integer>,…​] - Average Latency Per IOP

    Selects the array ports that match this parameter value (average latency per I/O performed in microseconds).

    [-average-pending <integer>,…​] - Average Pending

    Selects the array ports that match this parameter value (average over time of how many commands are on the outstanding queue).

    [-average-waiting <integer>,…​] - Average Waiting

    Selects the array ports that match this parameter value (average over time of how many commands are on the waiting queue).

    [-connection-type {direct|fabric|ISCSI}] - Connection Type

    Selects the array ports that match this parameter value (type of connection between the controller and the back end storage).

    [-dynamic-queue-depth <integer>,…​] - Dynamic Queue Depth

    Current dynamic target port queue depth, the maximum number of commands allowed outstanding.

    [-max-pending <integer>,…​] - Max Pending

    Selects the array ports that match this parameter value (largest number of commands observed on the outstanding queue).

    [-max-waiting <integer>,…​] - Max Waiting

    Selects the array ports that match this parameter value (largest number of commands observed on the waiting queue).

    [-path-link-errors <integer>,…​] - Link Error count on path

    Selects the array ports that match this parameter value.

    [-percent-busy <integer>,…​] - Percent Busy

    Selects the array ports that match this parameter value (percentage of time I/Os are outstanding on the port).

    [-percent-waiting <integer>,…​] - Percent Waiting

    Selects the array ports that match this parameter value (percentage of time there are I/Os waiting on the throttle list on the target port).

    [-switch-port <text>] - Switch Port

    Selects the array ports that match this parameter value (for fabric attached connections, the switch port the array target port is connected to; N/A for direct attached).

    [-target-io-kbps <integer>,…​] - Kbytes of I/O per second to Target (Rolling Average)

    Selects the array ports that match this parameter value.

    [-target-iops <integer>,…​] - Number of IOPS to Target (Rolling Average)

    Selects the array ports that match this parameter value.

    [-target-lun-in-use-count <integer>,…​] - Target LUN In Use Count

    Selects the array ports that match this parameter value (number of IN-USE disks on this target port).

    [-target-port-speed <text>] - Target Port Speed

    Selects the array ports that match this parameter value (speed that the target port has negotiated with its connected switch port, or initiator port if direct attached).

    [-utilization-policy {normal|defer}] - Utilization Policy

    The policy used when sending I/O to an array target port when it reaches maximum queue depth. Possible values are:

    • normal - This policy aggressively competes for target port resources, in effect competing with other hosts. (default)

    • defer - This policy does not aggressively compete for target port resources, in effect deferring to other hosts.

    Examples

    The example below displays the port information for a single port.

    cluster1::> storage array port show -wwpn 50060e80004291c0
    Array Name: HITACHI_DF600F_1
    WWNN: 50060e80004291c0
    WWPN: 50060e80004291c0
    Connection Type: fabric
    Switch Port: vgbr300s89:9
    Link Speed: 4 GB/s
    Max Queue Depth: 1024
    Utilization Policy: normal
                                  LUN                                        Link
    Node              Initiator  Count   IOPS    KB/s    %busy    %waiting   Errs
    ----------------  ---------  -----  ------  ------  -------  ----------  ----
         vnv3070f20a         0b      2       0       0        0           0     0
         vnv3070f20b         0b      2       0       0        0           0     0
    Top of Page