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

 lsportip    [  -filtervalue  attribute=value  ]   [  -filtervalue?  ]   [  -nohdr  ]   [  -delim  delimiter  ]   [  ethernet_port_id  ]  

Parameters

-filtervalueattribute=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 theStorwize V5000 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.

lsportip output 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 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 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 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 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 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 Internet Small Computer System Interface (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 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.
lossless_iscsi Displays whether PFC is enabled (on) or not enabled (off) for an iSCSI Internet Protocol Version 4 (IPv4) IP address. To be on:
  • It must be 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. To be on:
  • It must be 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 IPv4 address
  • iSCSI host attach is enabled on the port
Otherwise the value is off.
storage Indicates whether the IPv4 address that 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 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 and 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. 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), 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 -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_6host_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_6host_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_6host_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_6host_port_grp_id 1