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:

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 using 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 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. 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 if the node is a configuration node. 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 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).
identify_LED Indicates the node or node canister state - on, off, or blank.
code_level Indicates the current level of machine code running on the node canister. on, off, or blank.
product_mtm Indicates the product machine type.
update_complete Indicates if the node canister has completed 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,CG8,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_LEDproduct_mtm 2145-CG8
code_level,7.4.0.0 (build 99.1.1406102000)