lsnode

Use the lsnode command to return a concise list or a detailed view of nodes that are part of the system .

The list report style can be used to obtain two styles of report:
  • A list containing concise information about all the nodes on a system. Each entry in the list corresponds to a single node .
  • The detailed information about a single node.

Syntax

Read syntax diagramSkip visual syntax diagram lsnode -filtervalueattribute=value-nohdr-delimdelimiter-filtervalue?object_idobject_name

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 Command-Line Interface (CLI):
  • The wildcard character is an asterisk (*).
  • The command can contain a maximum of one wildcard.
  • When you use a wildcard, you must enclose the filter entry within double quotation marks (""):
    lsnode -filtervalue "name=md*"
-filtervalue?
Displays a list of valid filter attributes for the -filtervalueattribute=value parameter. The valid filters for the lsnode command are:
  • canister_id
  • config_node
  • enclosure_id
  • enclosure_serial_number
  • hardware
  • id
  • iscsi_alias
  • IO_group_name
  • IO_group_id
  • name
  • panel_name
  • status
  • site_id
-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 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 1-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 object ID or name. 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 that match the filtering requirements that are specified by the -filtervalue parameter are displayed.

Description

This command returns a concise list or a detailed view of nodes that are part of the system. This table provides the possible values that are applicable to the attributes that are displayed as data in the output views.
Table 1. lsnode attribute values
Attribute Value
status Indicates the status. The values are:
  • offline
  • service
  • flushing
  • pending
  • online
  • adding
  • deleting
  • spare
  • online_spare
config_node Indicates if the node is a configuration node. The values are:
  • yes
  • no
IO_group_id Indicates the I/O group of the node.
Note: A node that is considered a spare node does not use an I/O group ID for a node (spare or offline) that has been replaced by an online spare node.
IO_group_name Indicates the name of the I/O group in the node.
Note: A node that is considered a spare node does not use an I/O group name for a node (spare or offline) that has been replaced by an online spare node.
port_status Indicates whether the node is a configuration node. The values are:
  • active
  • inactive
  • not_installed
hardware Indicates the hardware type (for example, DH8).
UPS_serial_number Indicates the serial number of the UPS.
UPS_unique_id Indicates the unique ID of the UPS.
panel_name Indicates the unique identifier for the node.
enclosure_id Blank.
canister_id Blank.
enclosure_serial_number Blank.
service_IP_mode Indicates the current mode of the service IPv4
  • Empty if IPv4 is not active
  • The values are:
    • static (if the service IP is set by the user)
    • dhcp (if the service IP is set successfully by using DHCP server)
    • dhcpfallback (if the service IP is set to a default value after a DHCP server request failed)
service_IP_mode_6 Indicates the current mode of the service IPv6
  • Empty if IPv6 is not active
  • Either static (if the service IP is set by the user) or dhcp (if the service IP set successfully by using DHCP server).
site_id Indicates the site node value.
site_name Indicates the site name.
identify_LED Indicates the node or node canister state - on, off, or blank.
product_mtm Indicates the product machine type.
code_level Indicates the current level of machine code that is running on the node. on, off, or blank.
serial_number Indicates the current serial number for the node.
machine_signature Indicates the current machine signature for the node.
update_complete Indicates whether the node completes its update. The value is yes or no.
spare Indicates whether the node is a spare. The value is yes or no.
failover_source Indicates the node ID for a node that fails over to a specified node. This value is always blank if the node status is not online_spare.
protected_nodes Indicates the nodes that might fail over to a specified node. The value is blank unless the node status is spare.
Remember: This value does not indicate whether there is source node redundancy.

The first four Fibre Channel (FC) input/output (I/O) ports display the worldwide port name (WWPN), state, and speed. If there are less than four FC I/O ports, the fields display with a WWPN of 0000000000000000, port_status of inactive, and port_speed of N/A. To examine the FC ports, use the lsportfc command.

A node in the spare state displays a blank value for:
  • IO_group_id
  • IO_group_name
  • partner_node_id
  • partner_node_name.

A node with an online_spare state has a valid IO_group_id and IO_group_name, and might also have a valid partner_node_id and partner_node_name. The IO_group_id and IO_group_name values are blank when the node is in spare state.

Remember: Nodes that are in spare state or online_spare state must have a valid and unique node ID.

A concise invocation example 

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 panel_name enclosure_id canister_id enclosure_serial_number site_id site_name 
1  node1                   500507680C000128 online 0           io_grp0       yes                       SV1      iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node1             G71H00P                 1 
2  node2                   500507680C000130 online 0           io_grp0       no                        SV1      iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node2             G71H00M                 1
3  node3                   500507680C000138 online 1           io_grp1       no                        SV1      iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node3             G71H00X                 1
4  node4                   500507680C000140 online 1           io_grp1       no                        SV1      iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node4             G71H00Y                 1
5  node5                   500507680C000148 online 2           io_grp2       no                        SV1      iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node5             G71H00H                 1
6  node6                   500507680C000180 online 2           io_grp2       no                        SV1      iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node6             G71H008                 1
7  node7                   500507680100A283 online 3           io_grp3       no                        SV1      iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node7             CAY0007                 1
8  node8                   500507680100A284 online 3           io_grp3       no                        SV1      iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node8             CAY0008                 1

A concise invocation example 

lsnode -delim ,
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,panel_name,enclosure_id,canister_id,enclosure_serial_number,site_id,site_name
1,node114120,UPS_Fake_SN,5005076801005D00,online,0,io_grp0,yes,1000000000005D00,DH8,iqn.1986-03.com.ibm:2145.mycluster.node114120,,114120,,,,2,site2

A detailed invocation example

lsnode -delim , 1
The resulting output:
id,1
name,hlcn114289
UPS_serial_number,10004BC018
WWNN,5005076801002978
status,online
IO_group_id,0
IO_group_name,io_grp0
partner_node_id,2
partner_node_name,hlcn114253
config_node,no
UPS_unique_id,20400001124C0048
port_id,5005076801402978
port_status,active
port_speed,4Gb
port_id,5005076801302978
port_status,active
port_speed,4Gb
port_id,5005076801102978
port_status,active
port_speed,4Gb
port_id,5005076801202978
port_status,active
port_speed,4Gb
hardware,DH8
iscsi_name,iqn.1986-03.com.ibm:2145.ldcluster-19.hlcn114289
iscsi_alias,
failover_active,no
failover_name,hlcn114253
failover_iscsi_name,iqn.1986-03.com.ibm:2145.ldcluster-19.hlcn114253
failover_iscsi_alias,
panel_name,114289
enclosure_id,
canister_id,
enclosure_serial_number,
service_IP_address,9.180.29.52
service_gateway,9.180.28.1
service_subnet_mask,255.255.254.0
service_IP_address_6,
service_gateway_6,
service_prefix_6,
service_IP_mode,dhcp
service_IP_mode_6
site_id,1
site_name,DataCenterA

identify_LED,on
product_mtm,2145-DH8
code_level,7.4.0.0 (build 99.1.1406102000)
serial_number,78G0123
machine_signature,0123-4567-89AB-CDEF 
spare,yes
failover_source
protected_nodes 1,2