lsportethernet

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

Syntax

Parameters

-filtervalue attribute=value

(Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are returned. If a capacity is specified, the units must also be included.

Note: Some filters allow the use of a wildcard when you enter the command. The following rules apply to the use of wildcards with the FlashSystem 7300 CLI:

The wildcard character is an asterisk (*).
The command can contain a maximum of one wildcard, which must be the first or last character in the string.
When you use a wildcard, enclose the filter entry within double quotation marks (""), as follows:
```
lsportethernet -filtervalue "node_name=md*"
```

-filtervalue?

(Optional) Displays the valid filter attributes. The following filter attributes for the lsportethernet command are valid:

port_id
node_id
node_name

-nohdr

(Optional) By default, headings are displayed for each column of data in a concise style view, and for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these headings.

-delim delimiter

(Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum width of each item of data. In a detailed view, each item of data has its own row, and if the headers are displayed, the data is separated from the header by a space. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a 1-byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.

-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 value can be specified in between 1 - 255.

Description

This command lists the configuration of the Ethernet ports for each node in the IBM Spectrum 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
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.
port_id	Indicates the ID of the ethernet port within the node. Value can be in between 1 - 255.
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 remote copy. 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).

A concise invocation example

lsportethernet

The resulting output:


port_id node_id node_name MAC               duplex speed  link_state dcbx_state  rdma_type adapter_location adapter_port_id host storage replication eth_clustering management 
1       1       node1     00:e0:ec:8b:35:c1 Full   1Gb/s  active     unsupported           0                1               yes  yes     yes         no             yes
2       1       node1     00:e0:ec:8b:35:c2 Full   1Gb/s  active     unsupported           0                2               yes  yes     yes         no             yes
3       1       node1     00:e0:ec:8b:35:c3               inactive                         0                3               yes  yes     yes         no             no
4       1       node1     00:e0:ec:8b:35:c4               inactive                         0                4               yes  yes     yes         no             no
5       1       node1     98:03:9b:06:eb:95 Full   25Gb/s active     enabled     RoCE      1                1               yes  yes     yes         no             no
6       1       node1     98:03:9b:06:eb:94 Full   25Gb/s active     enabled     RoCE      1                2               yes  yes     yes         no             no
7       1       node1     00:07:43:48:59:48 Full   25Gb/s active     enabled     iWARP     2                1               yes  yes     yes         no             no
8       1       node1     00:07:43:48:59:40 Full   25Gb/s active     enabled     iWARP     2                2               yes  yes     yes         no             no

A detailed invocation example

lsportethernet -node 1 1

The resulting output:

port_id 1
node_id 1
node_name node1
MAC 00:1a:64:97:1b:a0
duplex Full
speed 1Gb/s
max_speed 1Gb/s
link_state active
mtu 1500
rdma_type
adapter_location 1
adapter_port_id 1
dcbx_state enabled
pfc_enabled_host_attach yes
pfc_enabled_storage no
pfc_enabled_clustering no
priority_group_0
priority_group_1
priority_group_2
priority_group_3
priority_group_4
priority_group_5
priority_group_6 3
priority_group_7 4
bandwidth_allocation 0:0:0:0:0:0:30:30
management yes
host yes
storage yes
replication yes
eth_clustering no