Skip to main content

storage array port show

Contributors
Suggest changes

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 (privilege: advanced)

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 (privilege: advanced)

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 (privilege: advanced)

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 (privilege: advanced)

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

[-max-pending <integer>,…​] - Max Pending (privilege: advanced)

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

[-max-waiting <integer>,…​] - Max Waiting (privilege: advanced)

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