Skip to main content

storage port show

Contributors
Suggest changes
PDFs

Show storage port information

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

Description

The storage port show command displays information about the storage ports in the cluster. If no parameters are specified, the default command displays the following information about the storage ports:

  • Node

  • Port

  • Type

  • Speed

  • State

  • Status

To display detailed profile information about a single storage port, use the -node and -port parameters.

Parameters

{ [-fields <fieldname>,…​]

Displays the specified fields for all the storage ports, in column style output.

| [-errors ]

Displays the following error status information about the storage ports which have errors:

  • Error type

  • Error severity

  • Error description

| [-instance ] }

Displays expanded information about all the storage ports in the system. If a storage port is specified, then this parameter displays detailed information for that port only.

[-node {<nodename>|local}] - Node

Displays detailed information about the storage ports on the specified node.

[-port <text>] - Port

Selects the ports with the specified port name.

[-port-type {Unknown|SAS|FC|ENET}] - Port Type

Selects the ports of the specified type.

[-port-speed {0|1|1.5|2|2.5|3|4|5|6|8|10|12|14|16|25|32|40|64|100}] - Port Speed

Selects the ports with the specified speed.

[-state {enabled|disabled|enable-pending|disable-pending}] - Port State

Selects the ports with the specified state.

[-status {unknown|online|online-degraded|offline|link-down|transient-mode}] - Port Status

Selects the ports with the specified operational status.

[-description <text>] - Description

Selects the ports with the specified description.

[-firmware-rev <text>] - Firmware Revision

Selects the ports with the specified firmware revision.

[-serial-number <text>] - Serial Number

Selects the ports with the specified serial number.

[-is-dedicated {true|false}] - Is Dedicated Storage Port?

Selects the ports that match the specified value for storage-only ports. This value is always true for FC and SAS ports, as well as for ENET ports that are dedicated to storage.

[-part-number <text>] - Part Number

Selects the ports with the specified part number.

[-connection-mode {Unknown|Loop|Point-to-point}] - Connection Mode

Selects the ports with the specified connection mode.

[-wwnn <FC WWN>] - World Wide Node Name

Selects the ports with the specified World Wide Node Name.

[-wwpn <FC WWN>] - World Wide Port Name

Selects the ports with the specified World Wide Port Name.

[-board-name <text>] - Board Name

Selects the ports with the specified board name.

[-connector-capabilities <integer>,…​] - Connector Capabilities

Selects the ports with the specified list of connector capabilities.

[-wwn <FC WWN>] - Base World Wide Name

Selects the ports with the specified World Wide Name.

[-mfg-part-number <text>] - MFG Part Number

Selects the ports with the specified manufacturer part number.

[-nvdata-rev <text>] - NVDATA Revision

Selects the ports with the specified NVDATA revision.

[-date-code <text>] - Date Code

Selects the ports with the specified date code.

[-connector-technology {active-copper|passive-copper|optical}] - Connector Technology

Selects the ports with the specified connector technology.

[-phy-id <integer>,…​] - Phy ID

Selects the ports that have phys with the specified phy ID.

[-phy-state {enabled|disabled}] - Phy State

Selects the ports that have phys with the specified state.

[-phy-status {unknown|online|offline|speed-negotiation-failed|sata-oob-failed}] - Phy Status

Selects the ports that have phys with the specified status.

[-phy-speed {0|1|1.5|2|2.5|3|4|5|6|8|10|12|14|16|25|32|40|64|100}] - Phy Speed

Selects the ports that have phys with the specified speed.

[-mac-address <text>] - MAC Address

Selects ports that match the specified MAC address.

[-mode {storage|network}] - Mode

Selects the ports with the specified mode.

[-vlan-id <integer>] - VLAN ID

Selects the ports with the specified VLAN ID.

[-vendor-id <text>] - (DEPRECATED) Vendor ID
Note This parameter has been deprecated and may be removed in a future version of ONTAP. 
Selects the ports with the specified vendor ID.
[-vendor-part-id <text>] - (DEPRECATED) Vendor part ID
Note This parameter has been deprecated and may be removed in a future version of ONTAP. 
Selects the ports with the specified vendor part ID.
[-device-type <text>] - Device type

Selects ports that match the specified device type.

[-hw-rev <text>] - Hardware Revision

Selects the ports with the specified hardware revision.

[-error-type {unknown|online|online-degraded|offline|link-down|transient-mode}] - Error Type

Selects the ports with the specified error type.

[-error-severity {unknown|notice|warning|error|critical}] - Error Severity

Selects the ports with the specified error severity.

[-error-text <text>] - Error Text

Selects the ports with the specified error text.

[-corrective-action <text>] - Corrective Action

Selects the ports with the specified corrective action.

[-cable-length <text>] - Cable Length

Selects the ports with the specified cable length.

[-cable-identifier <text>] - Cable Identifier

Selects the ports with the specified cable identifier.

[-cable-end-id {end_0|end_1}] - Cable End Identifier

Selects the ports with the specified cable end identifier.

[-connector-type {QSFP|QSFP+|QSFP28|Mini-SAS HD|SFP}] - Connector Type

Selects the ports with the specified connector type.

[-connector-vendor <text>] - Connector Vendor

Selects the ports with the specified connector vendor.

[-connector-part-number <text>] - Connector Part Number

Selects the ports with the specified connector part number.

[-connector-serial-number <text>] - Connector Serial Number

Selects the ports with the specified connector serial number.

[-is-redundant {true|false}] - Is Redundant?

Selects the ports that are redundant (true) or not redundant (false). A port is redundant if all attached devices have a second path through another port.

[-in-use {true|false}] - In Use?

Selects the ports that are in use (true) or not in use (false). A port is in use if any devices are connected using this port.

Examples

The following example displays information about all storage ports in the cluster:

cluster1::> storage port show
Speed                     VLAN
Node           Port Type  Mode    (Gb/s) State    Status      ID
-------------- ---- ----- ------- ------ -------- --------- ----
cluster1-01
               4a   SAS   -            0 enabled  offline      -
               4b   SAS   -            0 enabled  offline      -
               4c   SAS   -            0 enabled  offline      -
               4d   SAS   -            0 enabled  offline      -
               e3a  ENET  network      - -        -            -
               e3b  ENET  storage    100 enabled  online      30
               e5a  ENET  storage    100 enabled  online      30
               e5b  ENET  network      - -        -            -
cluster1-02
               4a   SAS   -            0 enabled  offline      -
               4b   SAS   -            0 enabled  offline      -
               4c   SAS   -            0 enabled  offline      -
               4d   SAS   -            0 enabled  offline      -
               e3a  ENET  network      - -        -            -
               e3b  ENET  storage    100 enabled  online      30
               e5a  ENET  storage    100 enabled  online      30
               e5b  ENET  network      - -        -            -
16 entries were displayed.

The following example displays detailed information about port e5a on node node1:

cluster1::> storage port show -node cluster1-01 -port e5a
Node: cluster1-01
                    Port: e5a
               Port Type: ENET
                    Mode: storage
             Description: 40G/100G Ethernet Controller CX5
       Firmware Revision: 16.23.1020
             MAC Address: ec:0d:9a:65:e4:44
            Is Dedicated: false
           Serial Number: MT1730X00227
        Connector Vendor: Molex Inc.
   Connector Part Number: 112-00322
 Connector Serial Number: 532120266
              Port Speed: 100 Gb/s
              Port State: enabled
             Port Status: online