lsportip

Use the lsportip command to list the configuration for each Ethernet port on each node in the system. This command shows the Internet Protocol (IP) address and whether the port is configured as an Internet Small Computer Systems Interface (iSCSI) port.

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 SAN Volume Controller 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:
```
lsportip -filtervalue "node_name=md*"
```

-filtervalue?

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

id
node_id
node_name
state
failover

-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.

Note: If there is no data to be displayed, headings are not displayed.

-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.

ethernet_port_id

(Optional) Specifies the ID of an Ethernet port (1, 2, 3, or 4). If omitted, a concise view is displayed for all ports. When you use this parameter, the detailed view of the specified port is returned and any value that is specified by the -filtervalue parameter is ignored. If you do not use the ethernet_port_id parameter, the concise view displays all ports that match the filtering requirements that are specified by the -filtervalue parameter.

Description

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

Use the lsportip command with the optional ethernet_port_id parameter to display a detailed view of the specified port.

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.

The fourth row for each port shows any IP address that is configured for that port and are not failed over to a different node. The failover field on this row is set to no. The second row for each port shows any iSCSI addresses that are configured for the partner node, or for the local node with failover, and that are active on the port. The failover field on this row is set to yes.

The state field is set to unconfigured if there are no iSCSI addresses that are configured on the port. The state field is set to offline if there are configured addresses but the link is down, and online if the link is up. Any offline rows indicate a potential problem.

This command displays information about system port status.

This table provides the attribute values that can be displayed as output view data.

Table 1. lsportip output
Attribute	Description
id	Indicates the ID of the Ethernet port.
node_id	Indicates the ID of the node that contains the port.
node_name	Indicates the name of the node that contains the port.
IP address	Indicates the IPv4 address (and is blank if there is none).
mask	Indicates the IPv4 subnet mask (and is blank if there is none).
gateway	Indicates the IPv4 gateway (and is blank if there is none).
IP_address_6	Indicates the IPv6 address (and is blank if there is none).
prefix_6	Indicates the IPv6 prefix (and is blank if there is none).
gateway_6	Indicates the IPv6 gateway address (and is blank if there is none).
MAC	Indicates the current MAC address (blank if unknown).
duplex	Indicates the current duplex state of the port (blank if unknown).
state	Indicates the state of iSCSI addresses. The values can be: `unconfigured`: There is no iSCSI address (or hardware might not exist). `configured`: The iSCSI address is configured. `management_only`: It is not configurable for I/O operations.
link_state	Indicates the link state of Ethernet port. The values are `active` and `inactive`.
host	Displays the IPv4 address that is used for host attachment.
remote_copy	Displays the IPv4 remote copy port group ID. Remote copy includes Metro Mirror, Global Mirror, and HyperSwap®.
host_6	Displays the IPv6 address that is used for host attachment.
remote_copy_6	Displays the IPv6 remote copy port group ID. Remote copy includes Metro Mirror, Global Mirror, and HyperSwap.
remote_copy_status	Displays the IPv4 remote copy status. Remote copy includes Metro Mirror, Global Mirror, and HyperSwap.
remote_copy_status_6	Displays the IPv6 remote copy status. Remote copy includes Metro Mirror, Global Mirror, and HyperSwap.
vlan	Displays the virtual local area network (VLAN) ID associated with the IPv4 address on this port (a numeric character in the range 1 - 4094).
vlan_6	Displays the VLAN ID associated with the IPv6 address on this port (a numeric character from 1- 4094).
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 accept priority flow control (PFC) configuration from the switch port, even if the switch is DCBx-capable. 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. On Ethernet ports that are 10 Gbps, DCBx is automatically enabled if the connected switch port has it enabled. Remember: When this field is disabled or unsupported, all PFC related fields are blank.
fcoe_priority_tag	Displays the numeric priority tag value for the Fiber Channel over Ethernet (FCoE) protocol that is assigned on the connected switch port. This value must be a number from `0` to `7` or blank.
pfc_enabled_tags	Displays a list of priority tags for which PFC is enabled on the connected switch port. If you want to use the lossless iSCSI or FCoE function, PFC must be enabled for the corresponding tags on the switch. Once enabled on the switch, the tags are displayed in this field. This value is either blank or is a colon-separated list of numbers from `0` to `7`. Important: If no priority tags are defined on the switch, this field is blank. If priority tags are defined on the switch but PFC is not enabled for those priority tags, this field is blank.
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. Note: The field is blank if no specific bandwidths are allocated to any priority group on the network.
storage	Indicates whether the IPv4 address is used for iSCSI backend storage attachment functions. The values are `yes` and `no` (default). If no address is specified, the value is blank.
storage_6	Indicates whether the IPv6 address on the port is used for iSCSI backend storage attachment functions. The values are `yes` and `no` (default). If no address is specified, the value is blank.
host_port_grp_id	Indicates the host port group ID in both concise and detailed views. Values are 0 and 1-32. The default value is 0 for any Ethernet port. All configured host attachment ports have a non-zero host_port_grp_id. 0 (default): For a new installation, all configured iSCSI ports that have the host flag set to no have this field set to 0. Upon an update from older versions, all previously configured iSCSI ports are added to the default host port group that is 0. After the update to the current version, even though the host flag is set to yes, iSCSI ports are placed in host port group 0. 1-32: These host port group IDs are assigned to each configured iSCSI port that has its host flag set to yes. Host port grouping groups the ports that have the same speed with same rdma_type capability. Ports with same speed but with different rdma_type capabilities are grouped separately. Example: 25 Gbps speed ports with rdma_type as iWARP are grouped separately from 25 Gbps speed ports with rdma_type as RoCE. Host port grouping ensures that no more than four ports are discovered by a host during a discovery. A maximum of four ports per system node can belong to the same host port group ID. All ports that belong to the same host port group ID are the same speed and same rdma_type capability. Across two nodes of an I/O group, up to eight iSCSI ports (four per node) can belong to the same host port group ID.
lossless_host_attach	This field displays whether priority flow control (PFC) is enabled for host attachment traffic on IPv4. If PFC is not enabled, then it shows the reason why. The values are: Blank - IP is not configured. off-host_flag_disabled - host flag is not set. off-vlan_not_configured - vlan is not configured. off-priority_tag_not_enabled_on_switch - priority tag (hostattachcos set by using the chsystemethernet) is not enabled on the switch. on - PFC is enabled
lossless_host_attach6	This field displays whether priority flow control (PFC) is enabled for host attachment traffic on IPv6. If PFC is not enabled, then it shows the reason why. The values are: Blank - IP is not configured. off-host_flag_disabled - host6 flag is not set. off-vlan_not_configured - vlan is not configured. off-priority_tag_not_enabled_on_switch - priority tag (hostattachcos set by using the chsystemethernet) is not enabled on the switch. on - PFC is enabled
lossless_system	This field displays whether priority flow control (PFC) is enabled for system traffic. If PFC is not enabled, then it shows the reason why. The values are: Blank - IP is not configured. off-vlan_not_configured - vlan is not configured. off-priority_tag_not_enabled_on_switch - priority tag (systemcos set by using the chsystemethernet) is not enabled on the switch. on - PFC is enabled
lossless_storage	This field displays whether priority flow control (PFC) is enabled for storage traffic on IPv4. If PFC is not enabled, then it shows the reason why. The values are: Blank - IP is not configured. off-host_flag_disabled - storage flag is not set. off-vlan_not_configured - vlan is not configured. off-priority_tag_not_enabled_on_switch - priority tag (storagecos set by using the chsystemethernet) is not enabled on the switch. on - PFC is enabled
lossless_storage6	This field displays whether priority flow control (PFC) is enabled for storage traffic on IPv6. If PFC is not enabled, then it shows the reason why. The values are: Blank - IP is not configured. off-host_flag_disabled - storage6 flag is not set. off-vlan_not_configured - vlan is not configured. off-priority_tag_not_enabled_on_switch - priority tag (storagecos set by using the chsystemethernet) is not enabled on the switch. on - PFC is enabled
is_rdma_clustering	This field displays whether this Ethernet port is configured to use RDMA system node-to-node connections or not. The value is either yes, no, or blank.

In the following examples, which list different port configuration options, there are two lines for each possible Ethernet port, which represent the port and iSCSI behavioral effects. Port indices are assigned statically, and higher indices are used for optional ports.

A concise invocation example

lsportip

The resulting output:


id node_id node_name IP_address   mask          gateway     IP_address_6                            prefix_6 gateway_6                               MAC               duplex state      speed failover link_state host remote_copy host_6 remote_copy_6 remote_copy_status remote_copy_status_6 vlan vlan_6 adapter_location adapter_port_id  storage storage_6 host_port_grp_id  is_rdma_clustering
1  1       node1     192.168.1.52 255.255.255.0 192.168.1.1                                                                                          5c:f3:fc:0b:da:64 Full   configured 1Gb/s no       active     yes  0                  0                                                                 0                1                yes               1       
1  1       node1                                                                                                                                     5c:f3:fc:0b:da:64 Full   configured 1Gb/s yes      active          0                  0                                                                 0                1                                  0 
2  1       node1                                            fc00:0000:0000:0000:445a:0a17:fcf7:0236 64       fc00:0000:0000:0000:445a:0a17:fcf7:0001 5c:f3:fc:0b:da:66 Full   configured 1Gb/s no       active          0           yes    0                                                                 0                2                                  1 
2  1       node1                                                                                                                                     5c:f3:fc:0b:da:66 Full   configured 1Gb/s yes      active          0                  0                                                                 0                2                                  0
1  2       node2     192.168.1.53 255.255.255.0 192.168.1.1                                                                                          e4:1f:13:2f:b4:a4 Full   configured 1Gb/s no       active     yes  0                  0                                                                 0                1                                  1
1  2       node2                                                                                                                                     e4:1f:13:2f:b4:a4 Full   configured 1Gb/s yes      active          0                  0                                                                 0                1                                  0
2  2       node2                                            fc00:0000:0000:0000:445a:0a17:fcf7:0237 64       fc00:0000:0000:0000:445a:0a17:fcf7:0001 e4:1f:13:2f:b4:a6 Full   configured 1Gb/s no       active          0           yes    0                                                                 0                2                                  1
2  2       node2                                                                                                                                     e4:1f:13:2f:b4:a6 Full   configured 1Gb/s yes      active          0                  0                                                                 0                2                                  0

A detailed invocation example

lsportip 1

The detailed resulting output:

id 1
node_id 1
node_name node1
IP_address 192.168.20.10
mask 255.255.255.0
gateway 192.168.20.1
IP_address_6
prefix_6
gateway_6
MAC 00:1a:64:97:1b:a0
duplex Full
state online
speed 1Gb/s
failover no
mtu 1500
host yes
remote_copy 0
host_6
remote_copy_6 0
remote_copy_status
remote_copy_status_6
vlan 1063
vlan_6
adapter_location 1
adapter_port_id 1
dcbx_state Enabled  
lossless_host_attach on
lossless_host_attach6
lossless_system
lossless_storage on
lossless_storage6
fcoe_priority_tag  3 
pfc_enabled_tags 3:4  
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
storage yes
storage_6
host_port_grp_id 1

is_rdma_clustering

id 1
node_id 1
node_name node1
IP_address
mask
gateway
IP_address_6
prefix_6
gateway_6
MAC 00:1a:64:97:1b:a0
duplex Full
state online
speed 1Gb/s
failover yes
mtu 1500
host yes
remote_copy 0
host_6
remote_copy_6 0
remote_copy_status
remote_copy_status_6
vlan 1063
vlan_6
adapter_location 1
adapter_port_id 1
dcbx_state Enabled 
lossless_host_attach on
lossless_host_attach6
lossless_system
lossless_storage on
lossless_storage6 
fcoe_priority_tag  3 
pfc_enabled_tags 3:4  
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
storage
storage_6
host_port_grp_id 1

is_rdma_clustering

id 1
node_id 2
node_name node2
IP_address 192.168.20.11
mask 255.255.255.0
gateway 192.168.20.1
IP_address_6
prefix_6
gateway_6
MAC 00:1a:64:97:16:08
duplex Full
state online
speed 1Gb/s
failover no
mtu 1500
host yes
remote_copy 0
host_6
remote_copy_6 0
remote_copy_status
remote_copy_status_6
vlan 1063
vlan_6
adapter_location 1
adapter_port_id 1
dcbx_state Enabled 
lossless_host_attach on
lossless_host_attach6
lossless_system
lossless_storage on
lossless_storage6
fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
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
storage yes
storage_6
host_port_grp_id 1

is_rdma_clustering

id 1
node_id 2
node_name node2
IP_address
mask
gateway
IP_address_6
prefix_6
gateway_6
MAC 00:1a:64:97:16:08
duplex Full
state online
speed 1Gb/s
failover yes
mtu 1500
host yes
remote_copy 0
host_6
remote_copy_6 0
remote_copy_status
remote_copy_status_6
vlan 1063
vlan_6
adapter_location 1
adapter_port_id 1
dcbx_state Enabled 
lossless_host_attach
lossless_host_attach6
lossless_system
lossless_storage
lossless_storage6
fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
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
storage
storage_6
host_port_grp_id 1

is_rdma_clustering

An invocation example for port 1, which is a 1 Gb port (DCBx is not supported).

lsportip 1

The resulting output (not all fields are shown):

node_id 3
...
host yes
remote_copy 1
host_6
...
vlan
vlan_6
adapter_location 0
adapter_port_id 2
dcbx_state unsupported   <------ for 1G ports DCBx is not supported
lossless_host_attach off
lossless_host_attach6
lossless_system off
lossless_storage off
lossless_storage6
storage no
storage_6
host_port_grp_id 1
rdma_type
is_rdma_clustering

An invocation example for port 5, which is a 25 Gb port and DCBx is enabled. The host attach priority tag is set to 4. The system priority tag is set to 5. The storage priority tag is set 6.

lsportip 5

The resulting output (not all fields are shown):

node_id 3
node_name node1
IP_address 10.39.5.1
...
host yes    <------- host flag is set
remote_copy 1
host_6
...
vlan   <------ VLAN is not configured
vlan_6
adapter_location 0
adapter_port_id 2
dcbx_state supported
lossless_host_attach on <------ VLAN is configured, host flag is set, and PFC for tag 4 (host attach cos) is enabled.
lossless_host_attach6
lossless_system on      <----- Node IP is configured over VLAN and PFC for tag 5 (system cos) is enabled. 
lossless_storage on     <----- VLAN is configured, Storage flag is set, and PFC for tag 6 (storage cos) is enabled 
lossless_storage6
fcoe_priority_tag 3 
pfc_enabled_tags 4:5:6 
...
storage yes <------- Storage flag is set
storage_6
host_port_grp_id 1
rdma_type
is_rdma_clustering

An invocation example for port 5, which is a 25 Gb port and DCBx is enabled. The host attach priority tag is set to 4. The system priority tag is set to 5. The storage priority tag is set 6.

lsportip 5

The resulting output (not all fields are shown):

node_id 3
node_name node1
IP_address 10.39.5.1
...
host yes    <------- host flag is set
remote_copy 1
host_6
...
vlan    <------ VLAN is not configured
vlan_6
adapter_location 0
adapter_port_id 2
dcbx_state supported
lossless_host_attach off-enable-vlan <------ host flag is set, priority for tag 4
                                                 (host attach cos) is enabled, but VLAN
                                                 is not configured
lossless_host_attach6
lossless_system off-enable-vlan      <----- Node IP is configured but not over VLAN, 
                                                therefore lossless_system is off. 
lossless_storage off-enable-vlan     <----- Storage flag is set, PFC for tag 6 (storage
                                                cos) is enabled, but VLAN is not configured.
                                                Therefore lossless_storage is off. 
lossless_storage6
fcoe_priority_tag 3 
pfc_enabled_tags 4:5:6 
...
storage yes <------- Storage flag is set
storage_6
host_port_grp_id 1
rdma_type
is_rdma_clustering