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

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 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 ("").
```
lsportip -filtervalue "node_name=md*"
```

-filtervalue?

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

id
node_id
node_name
state
failover

-nohdr

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 no data is displayed, headings are not displayed.

-delim delimiter

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

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 no iSCSI addresses are configured on the port. The state field is set to offline if configured addresses exist but the link is down, and the field is set to 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 (blank if none)
`mask`	Indicates the IPv4 subnet mask (blank if none)
`gateway`	Indicates the IPv4 gateway (blank if none)
`IP_address_6`	Indicates the IPv6 address (blank if none)
`prefix_6`	Indicates the IPv6 prefix (blank if none)
`gateway_6`	Indicates the IPv6 gateway address (blank if 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. `unconfigured` 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 attach.
`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 attach.
`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 adapter 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 adapter 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 DCBx state of the port. `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 1 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 is turned off for DCBx or the port state is offline. On Ethernet ports that are 10 Gb/s, DCBx is automatically enabled if the connected switch port has it enabled. Remember: When this field is disabled or unsupported, all fields other than `lossless_iscsi` and `lossless_iscsi6` are blank.
`iscsi_priority_tag`	Displays the numeric priority tag value for the iSCSI protocol that is assigned on the connected switch port. This priority value must be a number from `0` to `7` or blank.
`fcoe_priority_tag`	Displays the numeric priority tag value for the Fibre 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. After PFC is 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.
`lossless_iscsi`	Displays whether PFC is enabled (`on`) or not enabled (`off`) for an iSCSI Internet Protocol Version 4 (IPv4) IP address. For PFC to be `on`, the following conditions must be true. The port is a 10 Gbps port with a valid IPv4 address. PFC for iSCSI is enabled on the switch port. Virtual local area network (VLAN) is configured for this IPv4 address. iSCSI host attach is enabled on the port. Otherwise the value is `off`.
`lossless_iscsi6`	Displays whether PFC is enabled (`on`) or not enabled (`off`) for an iSCSI Internet Protocol Version 6 (IPv6) IP address. For PFC to be `on`, the following conditions must be true. The port is a 10 Gbps port with a valid IPv6 address PFC for iSCSI is enabled on the switch port Virtual local area network (VLAN) is configured for this IPv6 address iSCSI host attach is enabled on the port Otherwise the value is `off`.
`storage`	Indicates whether the IPv4 address is used for iSCSI backend storage attach 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 attach 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 attached ports have a nonzero `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. For 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.

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

A concise invocation example

lsportip -delim ,

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,lossless_iscsi,lossless_iscsi6,storage,storage_6,host_port_grp_id,
1,1,node1,192.168.48.135,255.255.255.0,192.168.48.1,,,,5c:f3:fc:f5:67:ca,Full,configured,1Gb/s,no,
active,yes,1,,0,unused,,65,,0,1,off,,no,1,
1,1,node1,,,,,,,5c:f3:fc:f5:67:ca,Full,configured,1Gb/s,yes,active,,0,,0,,,,,0,1,,,,0
2,1,node1,192.168.48.136,255.255.255.0,192.168.48.1,,,,5c:f3:fc:f5:67:cb,Full,configured,1Gb/s,no,
active,yes,1,,0,unused,,,,0,2,off,,no,1
2,1,node1,,,,,,,5c:f3:fc:f5:67:cb,Full,configured,1Gb/s,yes,active,,0,,0,,,,,0,2,,,,0
3,1,node1,192.168.48.137,255.255.255.0,192.168.48.1,,,,00:90:fa:27:ec:22,,configured,10Gb/s,no,
active,yes,1,,0,unused,,,,1,1,off,,no,1
3,1,node1,,,,,,,00:90:fa:27:ec:22,,configured,10Gb/s,yes,active,,0,,0,,,,,1,1,,,,0
4,1,node1,192.168.48.138,255.255.255.0,192.168.48.1,0009:2009:0003:0004:0005:0006:0007:1130,64,
fe80:0000:0000:0000:0007:b4ff:fe00:0a00,00:90:fa:27:ec:24,,configured,10Gb/s,no,
active,yes,1,yes,0,unused,,165,170,1,2,on,on,yes,yes,1
4,1,node1,,,,,,,00:90:fa:27:ec:24,,configured,10Gb/s,yes,active,,0,,0,,,,,1,2,,,,0
1,2,node2,192.168.48.145,255.255.255.0,192.168.48.1,,,,5c:f3:fc:f5:68:b2,Full,configured,1Gb/s,no,
active,yes,1,,0,unused,,65,,0,1,off,,no,1
1,2,node2,,,,,,,5c:f3:fc:f5:68:b2,Full,configured,1Gb/s,yes,active,,0,,0,,,,,0,1,,,,0
2,2,node2,192.168.48.146,255.255.255.0,192.168.48.1,,,,5c:f3:fc:f5:68:b3,Full,configured,1Gb/s,no,
active,yes,1,,0,unused,,,,0,2,off,,,1
2,2,node2,,,,,,,5c:f3:fc:f5:68:b3,Full,configured,1Gb/s,yes,active,,0,,0,,,,,0,2,,,,0
3,2,node2,192.168.48.147,255.255.255.0,192.168.48.1,,,,00:90:fa:27:ec:4a,,configured,10Gb/s,no,
active,yes,1,,0,unused,,,,1,1,off,,no,1
3,2,node2,,,,,,,00:90:fa:27:ec:4a,,configured,10Gb/s,yes,inactive,,0,,0,,,,,1,1,,0
4,2,node2,192.168.48.148,255.255.255.0,192.168.48.1,0009:2009:0003:0004:0005:0006:0007:1230,64,
fe80:0000:0000:0000:0007:b4ff:fe00:0a00,00:90:fa:27:ec:4c,,configured,10Gb/s,no,active,yes,1,yes,
0,unused,,165,170,1,2,on,on,yes,yes,1
4,2,node2,,,,,,,00:90:fa:27:ec:4c,,configured,,yes,inactive,,0,,0,,,,,1,2,,,,0

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 lossless_iscsi lossless_iscsi6 storage storage_6 host_port_grp_id 
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               off                            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                              off                     yes       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               off                            no                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                              off                     no        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
iscsi_priority_tag  4  
fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
pfc_disabled_tags  0:1:2:5:6:7 
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
lossless_iscsi  on 
lossless_iscsi6 
storage yes
storage_6
host_port_grp_id 1


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
iscsi_priority_tag  4  
fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
pfc_disabled_tags  0:1:2:5:6:7 
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
lossless_iscsi  on 
lossless_iscsi6 
storage
storage_6
host_port_grp_id 1


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
iscsi_priority_tag  4  
fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
pfc_disabled_tags  0:1:2:5:6:7 
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
lossless_iscsi  on 
lossless_iscsi6 
storage yes
storage_6
host_port_grp_id 1


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
iscsi_priority_tag  4  
fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
pfc_disabled_tags  0:1:2:5:6:7 
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
lossless_iscsi  on 
lossless_iscsi6 
storage
storage_6
host_port_grp_id 1