lsportethernet

Use the lsportethernet command to list the properties and status of the storage system ethernet ports.

Syntax

Read syntax diagramSkip visual syntax diagram lsportethernet -nodenode_namenode_idport_id

Parameters

-delim delimiter
(Optional) Specify a delimiter to separate data in the output.
-nohdr
(Optional) Suppress the headings in the output.
-filtervalue attribute=value
(Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are displayed.
-filtervalue?
(Optional) Displays a list of valid filter attributes.
-node node_id | node_name
(Optional) Specifies the node ID or node name that contains the port. The ID must be of 64 bits and node name can be a string of 63 ASCII characters.
port_id
(Optional) Indicates the ID of the ethernet port within the node. The ID can be a value in the range 1 - 28.

Description

This command lists the configuration of the Ethernet ports for each node in the IBM® Storage Virtualize system.

Output rows for a port show the MAC address of that port if it can be determined. If the node and the Ethernet link are online, the rows also show the speed and duplex state of the link. The duplex field can have values of Half or Full, or it is blank if the node is offline.

This table provides the attribute values that can be displayed as output view data.
Table 1. lsportethernet output
Attribute Description
port_id Indicates the ID of the ethernet port within the node. You can specify a value in the range 1 - 28.
node_id Indicates the node id. Value can be in decimal of 64 bits.
node_name Indicates the name of the node that contains the port. Value can be a string of 63 ASCII characters.
MAC Indicates the current MAC address (blank if unknown).
duplex Indicates the current duplex state of the port (blank if unknown).
speed Indicates the negotiated speed of the port.
max_speed Indicates the maximum speed of the port.
link_state Indicates the link state of ethernet port. The values are active and inactive.
mtu Indicates the maximum transmission unit (MTU) for the port. The default value is 1500.
rdma_type Indicates the colon separated list of RDMA protocol capabilities of the port.
adapter_location Displays the location of the adaptor that contains the Ethernet port (any number in the range 0 - 8). Where 1 - 8 is the PCIe expansion slot number and 0 means that the adaptor is part of the system board or not in a PCIe expansion slot.
adapter_port_id Displays the location of the ethernet port that is in the adapter (any number in the range 1 - 4).
dcbx_state Displays the Data Center Bridging Capability Exchange protocol (DCBx) state of the port. A value of:
  • unsupported indicates that the port does not support priority flow control (PFC) on that port. All ports that are less than 10 Gbps have this value.
  • enabled indicates that the connected switch port is enabled for DCBx and the port state is online.
  • disabled indicates that the connected switch port turned off for DCBx or the port state is offline.

For 2 Port 25GbE RoCE Adapter Card, the lsportethernet command does not display correct DCBx values.
pfc_enabled_host_attach Displays whether a PFC tag for host attach is enabled on the connected switch port.
pfc_enabled_storage Displays whether a PFC tag for storage virtualization is enabled on the connected switch port.
pfc_enabled_clustering Displays whether a PFC tag for clustering is enabled on the connected switch port.
priority_group_0 Displays the set of priority tags that are within the priority group zero. This value is either blank or is a colon-separated list of numbers from 0 to 7. This field is part of the Enhanced Transmission Selection (ETS) settings.
priority_group_1 Displays the set of priority tags that are within the priority group one. This value is either blank or is a colon-separated list of numbers from 0 to 7. This field is part of the ETS settings.
priority_group_2 Displays the set of priority tags that are within the priority group two. This value is either blank or is a colon-separated list of numbers from 0 to 7. This field is part of the ETS settings.
priority_group_3 Displays the set of priority tags that are within the priority group three. This value is either blank or is a colon-separated list of numbers from 0 to 7. This field is part of the ETS settings.
priority_group_4 Displays the set of priority tags that are within the priority group four. This value is either blank or is a colon-separated list of numbers from 0 to 7. This field is part of the ETS settings.
priority_group_5 Displays the set of priority tags that are within the priority group five. This value is either blank or is a colon-separated list of numbers from 0 to 7. This field is part of the ETS settings.
priority_group_6 Displays the set of priority tags that are within the priority group six. This value is either blank or is a colon-separated list of numbers from 0 to 7. This field is part of the ETS settings.
priority_group_7 Displays the set of priority tags that are within the priority group seven. This value is either blank or is a colon-separated list of numbers from 0 to 7. This field is part of the ETS settings.
bandwidth_allocation Displays a list of guaranteed bandwidth allocation percentages for priority groups zero through seven. The value is either blank or a colon-separated numeric list of bandwidth allocation percentages for each priority group, where each percentage is a whole number integer. This field is part of the ETS settings.
management Indicates that this port can be used for management. Values are yes for ports 1 and 2, no for the rest.
host Indicates if the port can be used for host attachment. The values are yes (default) and no.
storage Indicates if the port can be used for storage virtualization. The values are yes (default) and no.
replication Indicates if the port can be used for replication. The values are yes (default) and no.
eth_clustering Indicates if the port is configured for ethernet clustering. The values are yes and no (default).