storage shelf port show

Contributors

Display storage shelf ports

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

Description

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

  • Shelf Name

  • ID

  • Module

  • State

  • Internal?

To display detailed information for a single port, use the -shelf and -id parameters.

Parameters

{ [-fields <fieldname>,…​]

Displays output in column style about the specified fields for all shelf ports.

| [-cables ]

Displays information about all cables connected to the shelf ports.

| [-instance ]

Displays expanded information for all shelf ports in the system. If a shelf and ID are specified, then this parameter displays the same detailed information for the specified port as does the -shelf and -id parameters.

[-shelf <text>] - Shelf Name

Displays the ports in the storage shelf that matches the specified shelf name.

[-id <integer>] - Port ID

Displays the ports that match the specified ID.

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

Displays the ports that are present for the specified node.

[-module-id {A|B}] - Module ID

Displays the ports from the specified shelf module ID.

[-is-internal {true|false}] - Is Port Internal?

Displays the ports that are internal.

[-location <text>] - Location

Displays the ports with the specified location.

[-is-cable-connected {true|false}] - Is Cable Connected?

Displays the ports that have cables connected to them.

[-is-error {true|false}] - Any Errors?

Displays the ports for which errors have been logged.

[-connector-state {connected|disconnected|error}] - Connector State

Displays the ports with the specified connector state.

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

Displays the ports with the specified connector serial number.

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

Displays the ports with the specified connector type.

[-cable-vendor <text>] - Cable Vendor

Displays the ports that are connected to a cable from the specified vendor.

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

Displays the ports that are connected to a cable with the specified part number.

[-cable-technology {active-copper|passive-copper|optical}] - Cable Technology

Displays the ports that are connected to a cable with the specified technology.

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

Displays the ports that are connected to a cable with the specified length.

[-cable-id <text>] - Cable ID

Displays the ports that are connected to a cable with the specified ID.

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

Displays the ports that are connected to a cable with the specified cable end.

[-designator <text>] - Designator

Displays the ports with the specified designator.

[-wwn <text>] - Local Device WWN

Displays the ports with the specified WorldWide Name (WWN).

[-remote-wwn <text>] - Remote Device WWN

Displays the ports connected to the specified remote WorldWide Name (WWN).

[-remote-phy <text>] - Remote Phy

Displays the ports connected to the specified remote PHY.

[-swap-count <integer>] - Swap Count

Displays the ports with the specified swap count.

[-mac <MAC Address>] - Local MAC Address

Displays the ports with the specified MAC address.

[-remote-mac <MAC Address>] - Remote MAC Address

Displays the ports connected to the specified MAC address.

[-remote-port <text>] - Remote Port

Displays the ports connected to the specified port.

[-remote-chassis <text>] - Remote Chassis

Displays the ports connected to the specified chassis.

[-remote-device <text>] - Remote Device

Displays the ports connected to the specified device.

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

Displays the ports with the specified Virtual LAN (VLAN) ID.

[-link-state {unknown|online|offline}] - Link State

Displays the ports with the specified link state.

Examples

The following example displays information about all shelf ports:

cluster1::> storage shelf port show

Shelf ID Module State        Internal?
----- -- ------ ------------ ---------
1.4
       0 A      connected    false
       1 A      connected    false
       2 B      connected    false
       3 B      connected    false
4 entries were displayed.

The following example displays expanded information about port 0 in shelf 1.4:

cluster1::> storage shelf port show -shelf 1.4 -id 0
Shelf Name: 1.4
                Port ID: 0
              Module ID: A
      Is Port Internal?: false
               Location: rear of the shelf at the top left, on shelf module A
    Is Cable Connected?: true
            Any Errors?: false
        Connector State: connected
Connector Serial Number: 616930439
         Connector Type: qsfp+
           Cable Vendor: Molex Inc.
      Cable Part Number: 112-00431+A0
       Cable Technology: passive-copper
           Cable Length: 5m
               Cable ID: 500a0980000b6c3f-50000d1703544b80
              Cable End: end_1
             Designator: sqr
       Local Device WWN: 500A0980000B6C3F
      Remote Device WWN: 50000D1703544B80
             Remote Phy: 12
             Swap Count: 0

The following example displays information about the cables:

cluster1::> storage shelf port show -cables

Shelf: 1.4

ID Vendor     Part Number   Technology     Length   Type        Serial Number
-- ---------- ------------- -------------- -------- ----------- --------------
 0 Molex Inc. 112-00431+A0  passive-copper 5m       qsfp+       616930439
 1 Molex Inc. 112-00431+A0  passive-copper 5m       qsfp+       616930364
 2 Molex Inc. 112-00431+A0  passive-copper 5m       qsfp+       616930452
 3 Molex Inc. 112-00431+A0  passive-copper 5m       qsfp+       616930474
4 entries were displayed.