lsportip

Use the lsportip command to list the Internet Small Computer Systems Interface (iSCSI) Internet Protocol (IP) addresses assigned for each port on each node in the clustered system.

Syntax

lsportip [ -filtervalueattribute=value ] [ -filtervalue? ] [ -nohdr ] [ -delimdelimiter ] [ 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 theLenovo Storage V7000 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 using 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 possible 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 one-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 matching the filtering requirements that are specified by the -filtervalue parameter.

Description

This command lists all port IP addresses for each node in the clustered system. The concise view displays two rows of output for each Ethernet port. Each node has two Ethernet ports.

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

Both 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 first row for each port shows any Internet Small Computer System Interface, an Internet Protocol (iSCSI) addresses that have been 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 have been 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 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 enables you to view information about system port status.

Table 1 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.
  • configured: Hardware might or might not exist.
  • online: The iSCSI address is configured and port is running.
  • offline: The iSCSI address is configured but the port is not running (or hardware might not exist).
  • management_only: It is not configurable for I/O operations.
host Displays the IPv4 address 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 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 from 1 to 4094).
vlan_6 Displays the VLAN ID associated with the IPv6 address on this port (a numeric character from 1 to 4094).
adapter_location Displays the location of the adapter containing the Ethernet port (any number from 0 to 6).
adapter_port_id Displays the location of the Ethernet port that is in the adapter (any number from 1 to 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 1Gbps 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 has disabled for DCBx or the port state is offline.
On Ethernet ports that are 10Gb/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 assigned on the connected switch port. This 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 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 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 (0). This value is either blank or 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 (1). This value is either blank or 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 (2). This value is either blank or 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 (3). This value is either blank or 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 (4). This value is either blank or 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 (5). This value is either blank or 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 (6). This value is either blank or 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 (7). This value is either blank or 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 (0) through seven (7). 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 have been 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 10Gbps 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 state is set to 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 10Gbps port with a valid IPv6 address, PFC for iSCSI must be 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 state is set to off.

In the examples below (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.

An invocation example displaying only installed ports

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
1  1       node1           00:21:5e:4d:7b:c9                                         Full   unconfigured      100Mb/s    no        
active
1  1       node1           00:21:5e:4d:7b:c9                                         Full   unconfigured      100Mb/s    yes       
active
2  1       node1           00:21:5e:4d:7b:ca                                                unconfigured                 no        
active
2  1       node1           00:21:5e:4d:7b:ca                                                unconfigured                 yes       
inactive
1  3       node2           00:21:5e:4d:80:e5                                         Full   unconfigured      100Mb/s    no        
inactive
1  3       node2           00:21:5e:4d:80:e5                                         Full   unconfigured      100Mb/s    yes       
active
2  3       node2           00:21:5e:4d:80:e6                                                unconfigured                 no        
inactive
2  3       node2           00:21:5e:4d:80:e6                                                unconfigured                 yes       
inactive

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,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
1,1,dvt101794,9.71.47.129,255.255.254.0,9.71.46.1,,,,00:14::0:1:on:off
5e:33:51:92,Half,online,100Mb/s,no,0,yes,0,,,1063,,:0:1:off:on
1,1,dvt101794,,,,,,,00:14:5e:33:51:92,Half,online,100Mb/s,,,,,,,,,:0:2:on:off
2,1,dvt101794,,,,,,,00:14:5e:33:51:93,,unconfigured,,,,,,,,,:0:2:on:off
2,1,dvt101794,,,,,,,00:14:5e:33:51:93,,unconfigured,,,,,,,,,:1:1:on:off
1,2,dvt101760,9.71.47.83,255.255.254.0,9.71.46.1,,,,00:14:5e::1:1:on:off
7e:2a:58,Half,online,100Mb/s,no,1,no,0,used,,25,,:2:2:off:on
1,2,dvt101760,,,,,,,00:14:5e:7e:2a:58,Half,online,100Mb/s,,,,,,,,,,:2:2:off:on
2,2,dvt101760,,,,,,,00:14:5e:7e:2a:59,,unconfigured,,,,,,,,,,,:0:1:on:off
2,2,dvt101760,,,,,,,00:14:5e:7e:2a:59,,unconfigured,,,,,,,,,,,:0:1:on:off
1,3,dvt101761,9.71.47.253,255.255.254.0,9.71.46.1,,,,00:14:5e:0:2:on:off
33:50,fa,Half,online,100Mb/s,no,2,yes,0,unused,,1063,,:0:2:on:off
1,3,dvt101761,,,,,,,00:14:5e:33:50:fa,Half,online,100Mb/s,,,,,,,,,,:1:1:on:off
2,3,dvt101761,,,,,,,00:14:5e:33:50:fb,,unconfigured,,,,,,,,,,,:1:1:on:off
2,3,dvt101761,,,,,,,00:14:5e:33:50:fb,,unconfigured,,,,,,,,,,,:on:off
1,4,dvt101786,9.71.47.227,255.255.254.0,9.71.46.1,,,,00:14:5e::on:off
33:50:da,Half,online,100Mb/s,no,0,no,1,,unused,25,,:0:1:on:off
1,4,dvt101786,,,,,,,00:14:5e:33:50:da,Half,online,100Mb/s,,,,,,,,,,,:0:1:on:off
2,4,dvt101786,,,,,,,00:14:5e:33:50:db,,unconfigured,,,,,,,,,,,:0:2:on:off
2,4,dvt101786,,,,,,,00:14:5e:33:50:db,,unconfigured,,,,,,,,,,,:0:2:on:off
1,5,destiny35,9.71.47.69,255.255.254.0,9.71.46.1,,,,00:21:5e:09::1:1:on:off
21:44,Full,online,1Gb/s,no,0,no,2,,unused:25,,:1:1:off:on
1,5,destiny35,,,,,,,00:21:5e:09:21:44,Full,online,1Gb/s,,,,,,,,,,:2:2:on:off
2,5,destiny35,,,,,,,00:21:5e:09:21:46,,unconfigured,,,,,,,,,,,:2:2:on:off
2,5,destiny35,,,,,,,00:21:5e:09:21:46,,unconfigured,,,,,,,,,,,:0:1:on:off
1,6,destiny34,9.71.46.239,255.255.254.0,9.71.46.1,,,,00:21:5e:09::0:1:on:off
21:54,Full,online,100Mb/s,no,2,no,0,unused,,25,,:0:2:off:on
1,6,destiny34,,,,,,,00:21:5e:09:21:54,Full,online,100Mb/s,,,,,,,,,,,:0:2:on:off
2,6,destiny34,,,,,,,00:21:5e:09:21:56,,unconfigured,,,,,,,,,,,:1:1:on:off
2,6,destiny34,,,,,,,00:21:5e:09:21:56,,unconfigured,,,,,,,,,,,:1:1:on:off

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_6vlan 1063
vlan_6adapter_location 1
adapter_port_id 1dcbx_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 

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_6vlan 1063
vlan_6adapter_location 1
adapter_port_id 1dcbx_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 

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_6vlan 1063
vlan_6adapter_location 1
adapter_port_id 1dcbx_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 

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_6vlan 1063
vlan_6adapter_location 1
adapter_port_id 1dcbx_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