lsnode

Use the lsnode command to return a concise list or a detailed view of nodes that are part of the clustered system (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


>>- lsnode -- --+-----------------------------------+-- -------->
                '- -filtervalue -- attribute=value -'      

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

>--+-----------------+--+---------------+----------------------><
   '- -filtervalue? -'  +- object_id ---+   
                        '- object_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 using 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

For more information about filtering attributes, see Attributes of the -filtervalue parameters.

-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 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 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 that are part of the system. Table 1 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`
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.
IO_group_name	Indicates the name of the I/O group in the node.
port_status	Indicates if the node is a configuration node. The values are: `active` `inactive` `not_installed`
hardware	Indicates the hardware type (for example, `CG8`).
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 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 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 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 if the node has completed its update. The values are `yes` or `no`.

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 concise invocation example

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,CG8,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



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


product_mtm,2145-CG8
code_level,7.4.0.0 (build 99.1.1406102000)
serial_number,78G0123
machine_signature,0123-4567-89AB-CDEF