lsnode

The list report style can be used to obtain two styles of report.
  1. A list containing concise information about all the nodes on a cluster. (Each entry in the list corresponds to a single node.)
  2. The detailed information about a single node.

Syntax

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

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

>--+-----------------------+-- --+-------------+-- ------------->
   '- -delim -- delimiter -'     +- object_id -+
                                 '- name ------'

>--+-----------------+-----------------------------------------><
   '- -filtervalue? -'

Parameters

-filtervalue attribute=value
Optionally 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.
-nohdr
By default, headings are displayed for each column of data (in a concise style view), and each item of data (in a detailed style view). Using the -nohdr parameter will suppress the display of these headings.
Note:Note: If there is no data to be displayed (for example, an empty view has been returned), then headings are not displayed irrespective of whether the -nohdr option was used or not.
-delim delimiter
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. Using the -delim parameter will override this behavior. Valid input for the -delim parameter is a one byte character. If, for example, you entered -delim : a colon will be used to separate all items of data in a concise view (for example, the spacing of columns does not occur) and in a detailed view the data is separated from its header by a colon.
object_id | name
Optionally specifies the name or ID of an object. If not supplied, the concise view of all objects, or all of those objects matching the filtering requirements in -filtervalue (if specified), of the given type are returned. If supplied, the detailed view of the specific object is returned, and any filtervalue entry (if entered) is ignored.
-filtervalue?
Display a list of valid filter attributes. The valid filters for the svcinfo lsnode command are:
  • node_name
  • id
  • status
  • IO_group_name
  • IO_group_id
  • name

Description

This command will return a concise list or a detailed view, of nodes visible to the cluster.

The following list provides possible values that are applicable to the attributes that are displayed as data in the output views:

status offline, pending, online, adding, deleting
config node no, yes
port status not present, online, offline

Determining a node's WWPNs: List the nodes in the cluster by issuing the following command:
svcinfo lsnode

Note:Note: Remember the node name or ID as you will need it in the next step.

For the node or nodes in question, issue the following command:
svcinfo lsnode <nodename/id>
where <nodename/id> is the node name or ID.

Note:Note: Remember the four port ID's (WWPNs).
Attention: Attention: If the node is in adding state, the WWPN will be displayed as 0000000000000000. Once the node has successfully become a member of the cluster, the state will change to online and the WWPN will be displayed correctly.

Possible failures

Examples

A concise invocation example

svcinfo lsnode -delim :

The concise resulting output

id:name:UPS_serial_number:WWNN:
status:IO_group_id:IO_group_name:config_node:UPS_unique_id 

1:node1:UPS_Fake_SN:50050768010007E5:online:0:
io_grp0:yes:10000000000007E5

A detailed invocation example

svcinfo lsnode -delim = 1

The detailed resulting output

id=1
name=node1
UPS_serial_number=UPS_Fake_SN
WWNN=50050768010007E5
status=online
IO_group_id=0
IO_group_name=io_grp0
partner_node_id=
partner_node_name=
config_node=yes
UPS_unique_id=10000000000007E5
port_id=50050768011007E5
port_status=active
port_id=50050768012007E5
port_status=inactive
port_id=50050768013007E5
port_status=not_installed
port_id=50050768014007E5
port_status=not_installed

Related topics

(C) Copyright International Business Machines Corporation 2003, 2004