lsportip

The lsportip command lists the iSCSI IP addresses assigned for each port on each node in the cluster.

Syntax

Read syntax diagramSkip visual syntax diagram
>>- svcinfo -- -- lsportip -- ---------------------------------->

>--+--------------------------------+-- --+-----------------+--->
   '- -filtervalue -- attrib=value -'     '- -filtervalue? -'   

>-- --+----------+-- -- --+-----------------------+------------->
      '- -nohdr -'        '- -delim -- delimiter -'   

>--+--------------------+--------------------------------------><
   '- ethernet_port_id -'   

Parameters

-filtervalue attrib=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 using a wildcard, enclose the filter entry within double quotation marks (""), as follows:
    svcinfo lsportip -filtervalue "node_name=md*"
-filtervalue?
(Optional) Displays the valid filter attributes. The following filter attributes for the svcinfo 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, either 1 or 2. 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 cluster. The concise view displays two rows of output for each ethernet port. Each node has two ethernet ports.

Use the svcinfo 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 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.

A concise invocation example

svcinfo lsportip -delim :

The concise resulting output

id:node_id:node_name:IP_address:mask:gateway:IP_address_6:
prefix_6:gateway_6:MAC:duplex:state:speed:failover
1:1:dvt101794:9.71.47.129:255.255.254.0:9.71.46.1::::00:14:
 5e:33:51:92:Half:online:100Mb/s:no
1:1:dvt101794:::::::00:14:5e:33:51:92:Half:online:100Mb/s:yes
2:1:dvt101794:::::::00:14:5e:33:51:93::unconfigured::no
2:1:dvt101794:::::::00:14:5e:33:51:93::unconfigured::yes
1:2:dvt101760:9.71.47.83:255.255.254.0:9.71.46.1::::00:14:5e:
 7e:2a:58:Half:online:100Mb/s:no
1:2:dvt101760:::::::00:14:5e:7e:2a:58:Half:online:100Mb/s:yes
2:2:dvt101760:::::::00:14:5e:7e:2a:59::unconfigured::no
2:2:dvt101760:::::::00:14:5e:7e:2a:59::unconfigured::yes
1:3:dvt101761:9.71.47.253:255.255.254.0:9.71.46.1::::00:14:5e:
 33:50:fa:Half:online:100Mb/s:no
1:3:dvt101761:::::::00:14:5e:33:50:fa:Half:online:100Mb/s:yes
2:3:dvt101761:::::::00:14:5e:33:50:fb::unconfigured::no
2:3:dvt101761:::::::00:14:5e:33:50:fb::unconfigured::yes
1:4:dvt101786:9.71.47.227:255.255.254.0:9.71.46.1::::00:14:5e:
 33:50:da:Half:online:100Mb/s:no
1:4:dvt101786:::::::00:14:5e:33:50:da:Half:online:100Mb/s:yes
2:4:dvt101786:::::::00:14:5e:33:50:db::unconfigured::no
2:4:dvt101786:::::::00:14:5e:33:50:db::unconfigured::yes
1:5:destiny35:9.71.47.69:255.255.254.0:9.71.46.1::::00:21:5e:09:
 21:44:Full:online:1Gb/s:no
1:5:destiny35:::::::00:21:5e:09:21:44:Full:online:1Gb/s:yes
2:5:destiny35:::::::00:21:5e:09:21:46::unconfigured::no
2:5:destiny35:::::::00:21:5e:09:21:46::unconfigured::yes
1:6:destiny34:9.71.46.239:255.255.254.0:9.71.46.1::::00:21:5e:09:
 21:54:Full:online:100Mb/s:no
1:6:destiny34:::::::00:21:5e:09:21:54:Full:online:100Mb/s:yes
2:6:destiny34:::::::00:21:5e:09:21:56::unconfigured::no
2:6:destiny34:::::::00:21:5e:09:21:56::unconfigured::yes

A detailed invocation example

svcinfo lsportip 1

The detailed resulting output

id 1
node_id 1
node_name dvt101794
IP_address 9.8.7.1
mask 255.255.255.0
gateway 9.0.0.1
IP_address_6
prefix_6
gateway_6
MAC 00:14:5e:33:51:92
duplex Half
state online
speed 100Mb/s
failover no
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2003, 2009. All Rights Reserved.