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 -- --+-----------------------------------+-- ------> '- -filtervalue -- attribute=value -' >--+-----------------+-- --+----------+-- ----------------------> '- -filtervalue? -' '- -nohdr -' >--+-----------------------+-- --+--------------------+-- ----->< '- -delim -- delimiter -' '- ethernet_port_id -'
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 Storwize® V3700 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.
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:
|
link_state | Indicates the link state of ethernet port. The values are active and inactive. |
host | Displays the IPv4 address used for host attach. |
remote_copy | Displays the IPv4 remote copy port group ID. Remote copy includes Metro Mirror and Global Mirror. |
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 and Global Mirror. |
remote_copy_status | Displays the IPv4 remote copy status. Remote copy includes Metro Mirror and Global Mirror. |
remote_copy_status_6 | Displays the IPv6 remote copy status. Remote copy includes Metro Mirror and Global Mirror. |
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:
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:
|
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:
|
storage | Indicates whether the IPv4 address 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. |
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.
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
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,node1,,,,,,,5c:f3:fc:f5:67:ca,Full,configured,1Gb/s,yes,active,,0,,0,,,,,0,1,,,,
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,
2,1,node1,,,,,,,5c:f3:fc:f5:67:cb,Full,configured,1Gb/s,yes,active,,0,,0,,,,,0,2,,,,
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,
3,1,node1,,,,,,,00:90:fa:27:ec:22,,configured,10Gb/s,yes,active,,0,,0,,,,,1,1,,,,
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
4,1,node1,,,,,,,00:90:fa:27:ec:24,,configured,10Gb/s,yes,active,,0,,0,,,,,1,2,,,,
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,2,node2,,,,,,,5c:f3:fc:f5:68:b2,Full,configured,1Gb/s,yes,active,,0,,0,,,,,0,1,,,,
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,,,
2,2,node2,,,,,,,5c:f3:fc:f5:68:b3,Full,configured,1Gb/s,yes,active,,0,,0,,,,,0,2,,,,
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,
3,2,node2,,,,,,,00:90:fa:27:ec:4a,,configured,10Gb/s,yes,inactive,,0,,0,,,,,1,1,,
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
4,2,node2,,,,,,,00:90:fa:27:ec:4c,,configured,,yes,inactive,,0,,0,,,,,1,2,,,,
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
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 node1 5c:f3:fc:0b:da:64 Full configured 1Gb/s yes active 0 0 0 1
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
2 1 node1 5c:f3:fc:0b:da:66 Full configured 1Gb/s yes active 0 0 0 2
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 2 node2 e4:1f:13:2f:b4:a4 Full configured 1Gb/s yes active 0 0 0 1
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
2 2 node2 e4:1f:13:2f:b4:a6 Full configured 1Gb/s yes active 0 0 0 2
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
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
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
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