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 containing 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
- -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 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
- 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 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.
Attribute | Value |
---|---|
status | Indicates the status. The values are:
|
config_node | Indicates if the node is a configuration node.
The values are:
|
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:
|
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
|
service_IP_mode_6 | Indicates the current mode of the service IPv6
|
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. |
site_id | Indicates the site node canister value. |
site_name | Indicates the site name. |
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
site_id,1
site_name,ChelseaX
service_IP_mode,
site_id,1
site_name,DataCenterA
identify_LED
product_mtm 2145-CG8
code_level,7.4.0.0 (build 99.1.1406102000)