lsnodecanister

The lsnodecanister command returns a concise list or a detailed view of node canisters that are part of the clustered system (system).

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

A list that contains concise information about all the node canisters on a system. Each entry in the list corresponds to a single node canister.
The detailed information about a single node canister.

Syntax

lsnodecanister [ -filtervalue attribute=value ] [ -nohdr ] [ -delim delimiter ] [ -filtervalue? ] [ { object_id | object_name } ]

Parameters

-filtervalueattribute=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 when you use the 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:
```
lsnodecanister -filtervalue "name=md*"
```

-filtervalue?

Displays a list of valid filter attributes for the -filtervalueattribute=value parameter. The valid filters for the lsnodecanister 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

-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.

-delimdelimiter

(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. lsnodecanister attribute values provides the possible values that are applicable to the attributes that are displayed as data in the output views.

Table 1. lsnodecanister 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 the port status. The values are: `active` `inactive` `not_installed`
hardware	Indicates the node canister hardware type, for example `300`.
UPS_serial_number	Blank.
UPS_unique_id	Blank.
panel_name	Indicates a compound of the enclosure ID and the canister ID, separated with a hyphen.
enclosure_id	Indicates the enclosure that the node is in. This field is blank for a node-based system.
canister_id	Indicates the canister location within the enclosure. This field is blank for a node-based system.
enclosure_serial_number	Indicates the serial number of the enclosure. This field is blank for a node-based system.
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).
identify_LED	Indicates the node or node canister state - `on`, `off`, or blank.
code_level	Indicates the current level of machine code that is running on the node canister. `on`, `off`, or blank.
product_mtm	Indicates the product machine type.
update_complete	Indicates whether the node canister completes its update. The values are `yes` or `no`.

Note: Use the lsenclosure command to display information about the serial_number or machine_signature.

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

lsnodecanister -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

lsnodecanister -delim , 1

The detailed resulting output:

id,1
name,hlcn114289
UPS_serial_number,10004BC018
WWNN,5005076801002978
status,online
IO_group_id,0
IO_group_name,io_grp0
partner_nodecanister_id,2
partner_nodecanister_name,hlcn114253
config_nodecanister,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,300
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,
site_id,1
site_name,DataCenterA
identify_LED
product_mtm 2145-DH8
code_level,7.4.0.0 (build 99.1.1406102000)