lsnode

The lsnode command returns a concise list or a detailed view of nodes visible to the cluster.

The list report style can be used to obtain two styles of report:

Syntax

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

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

>--+-----------------------+-- -- --+-----------------+--------->
   '- -delim -- delimiter -'        '- -filtervalue? -'   

>--+---------------+-------------------------------------------><
   +- object_id ---+   
   '- object_name -'   

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.
  • When using a wildcard, you must enclose the filter entry within double quotation marks (""), as follows:
    svcinfo lsnode -filtervalue "name=md*"
-filtervalue?
Displays a list of valid filter attributes for the -filtervalue attribute=value parameter. The valid filters for the svcinfo lsnode command are:
  • node_name
  • id
  • status
  • IO_group_name
  • IO_group_id
  • name
  • hardware
-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.
object_id | object_name
(Optional) Specifies the name or ID of an object. When you use this parameter, the detailed view of the specific object is returned and any value that is specified by the -filtervalue parameter is ignored. If you do not specify the object_id | object_name parameter, the concise view of all objects matching the filtering requirements that is specified by the -filtervalue parameter are displayed.

Description

This command returns a concise list or a detailed view of nodes visible to the cluster. Table 1 provides the possible values that are applicable to the attributes that are displayed as data in the output views.
Table 1. svcinfo lsnode attribute values
Attribute Value
status offline | flushing | pending | online | adding | deleting
config_ node no | yes
port_status active | inactive | not installed
hardware 4F2 | 8F2 | 8F4 | 8G4 | CF8 | 8A4 | other
To determine a node's WWPNs, enter the following command:

svcinfo lsnode

Note: Record the node name or ID because you use this value in the next step.
For the node or nodes in question, issue the following command:

svcinfo lsnode node_name | node_id

where node_name | node_id is the node name or ID.
Note: Record the four port IDs (WWPNs).
Attention: If the node is in the adding state, the WWPN is displayed as 0000000000000000. Once the node has successfully become a member of the cluster, the state changes to online and the WWPN is displayed correctly.

A concise invocation example

svcinfo lsnode

The concise resulting output

id name UPS_serial_number WWNN status IO_group_id IO_group_name 
config_node UPS_unique_id hardware iscsi_name iscsi_alias 
81 dvt104607 1000849036 5005076801000070 online 0 io_grp0 no 20400002042400C6 
8G4 iqn.1986-03.com.ibm:2145.ldcluster-65.dvt104607 dvt104607 
83 hlcn114263 1000849028 500507680100056C online 2 io_grp2 no 2040000204240088 
8A4 iqn.1986-03.com.ibm:2145.ldcluster-65.hlcn114263 hlcn114263 
84 hlcn114302 100083B159 50050768010000FC online 3 io_grp3 no 2040000203481149 
8A4 iqn.1986-03.com.ibm:2145.ldcluster-65.hlcn114302 hlcn114302 
85 hlcn114252 1000849020 5005076801000D79 online 0 io_grp0 no 2040000204240080 
8A4 iqn.1986-03.com.ibm:2145.ldcluster-65.hlcn114252 hlcn114252 
82 dvt101952 100062L097 500507680100055C online 1 io_grp1 yes 2040000182700247 
8F4 iqn.1986-03.com.ibm:2145.ldcluster-65.dvt101952 dvt101952 
86 dvt101036 100062L102 50050768010000D0 online 1 io_grp1 no 2040000182701002 
8F4 iqn.1986-03.com.ibm:2145.ldcluster-65.dvt101036 dvt101036 
87 hlcn114163 100084O052 5005076801000023 online 2 io_grp2 no 20400002047C0142 
8A4 iqn.1986-03.com.ibm:2145.ldcluster-65.hlcn114163 hlcn114163 
88 hlcn114414 100083B158 500507680100004A online 3 io_grp3 no 2040000203481148 
8A4 iqn.1986-03.com.ibm:2145.ldcluster-65.hlcn114414 hlcn114414 

A detailed invocation example

svcinfo lsnode -delim : node1

The detailed resulting output

id:1
name:node1
UPS_serial_number:1000849042
WWNN:5005076801007B24
status:online
IO_group_id:0
IO_group_name:io_grp0
partner_node_id:
partner_node_name:
config_node:yes
UPS_unique_id:1000000000007B24
port_id:5005076801107B24
port_status:active
port_speed:2
port_id:5005076801207B24
port_status:inactive
port_speed:2
port_id:0000000000000000
port_status:not_installed
port_speed:2
port_id:0000000000000000
port_status:not_installed
port_speed:2
hardware:other
iscsi_name:iqn.1986-03.com.ibm:2145.rack8.dvt110683
iscsi_alias:rapchikvgadekar
failover_active:no
failover_name:node1
failover_iscsi_name:iname1
failover_iscsi_alias:ialias1
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2003, 2009. All Rights Reserved.