lsnodebattery

Use the lsnodebattery command to display information about the batteries in a node. This command applies to SAN Volume Controller 2145-DH8 systems.

Syntax


>>-lsnodebattery-- --+-----------------------+-- --------------->
                     '- -delim -- delimiter -'      

>--+----------+--+-----------------------+-- --+------+--------><
   '- -nohdr -'  '- -battery--battery_id-'     '-node-'

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 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.
-battery battery_id: (Optional) Specifies the battery ID. If you specify this parameter, you must also specify node.
node: (Optional) Specifies the node ID or name.

Description

The command displays information about the batteries in a node. The concise view displays a line for each battery slot in all nodes.

Table 1 provides the possible values that are applicable to the attributes that are displayed as data in the output views.

Table 1. lsnodebattery attribute values
Attribute	Value
node_id	Identifies the node that contains the battery.
node_name	Identifies the node that contains the battery.
battery_id	Identifies the battery in the node.
status	Identifies the status of the battery: `online` if the battery is present and working as usual (which includes a battery calibration). `degraded` indicates that the battery is present but not working as usual (it has an error logged against it). `offline` indicates that the battery cannot be detected or is failed (a node error indicating it is missing or failed is logged against the battery). Remember: If the status is `offline`, all other fields display the most recent battery data. If no data was shown, all fields remain blank.
charging_status	Identifies the charging state of the battery: `charged` indicates that the battery is fully charged. `charging` indicates that the battery is charging. `discharging` indicates that the battery is losing voltage (life) and it is recalibrating the gas gauge after the battery recharges. `idle` indicates that the battery is not charging and it is not discharging, but it is not fully charged. `reconditioning` indicates that the battery is reconditioning itself by discharging and after recharging. Important: Reconditioning occurs approximately every three months (on redundant systems) and can take from 12 - 48 hours.
recondition_needed	Identifies that the battery needs to be reconditioned or it must start reconditioning soon. A recalibration is required because the reported values from the gas gauge are not trusted. The values are `yes` and `no`.
node_percentage_charge	Identifies the battery's percentage charged to determine if it can support the node.
end_of_life_warning	Identifies the battery's end of life (with a warning noise). The values are `yes` and `no`. Important: Replace the battery.
present	Identifies a battery is present. The values are `yes` and `no`.
redundant	Identifies if it is safe to remove the battery. The values are `yes` and `no`.
remaining_charge_capacity_mAh	Identifies the remaining capacity of the battery (when the battery recharges) in milliamps hours (mAh).
full_charge_capacity_mAh	Identifies the fully charged capacity of the battery in mAh.
FRU_part_number	Identifies the FRU part number of the battery. The value contains seven alphanumeric characters.
FRU_identity	Identifies the 11S number (combining the manufacturing part number and the serial number). The value contains 22 alphanumeric characters.
compatibility_level	Identifies the battery driver software must support the current software level to operate with this battery (this comes from the battery vital product data or VPD).
last_recondition_timestamp	Indicates a system timestamp for the last successful recalibration of the gas gauge. The format is `YYMMDDHHMMSS`, where: `YY` indicates year. The first `MM` indicates month. `DD` indicates day. `HH` indicates hour. The second `MM` indicates minute. `SS` indicates second.
powered_on_hours	Indicates the number of hours the battery is in a powered node.
cycle_count	Identifies the number of charge or discharge cycles the battery performs.
error_sequence_number	Identifies the error log number of the highest priority error. This field is generally blank, but if the status is `degraded` or `offline` an error sequence number is displayed.

A concise invocation example

If battery 2 in node 1 is not installed:

lsnodebattery

The resulting output:

node_id node_name battery_id status  charging_status recondition_needed  node_percentage_charge   end_of_life_warning 
1       node1     1          online  charged         no                  50                       no
1       node1     2          offline                                                  
2       node2     1          online  charged         no                  50                       no
2       node2     2          online  reconditioning  yes                 50

A concise invocation example

If battery 2 in node 1 is failing to charge:

lsnodebattery

The resulting output:

node_id node_name battery_id status   charging_status recondition_needed  node_percentage_charge   end_of_life_warning 
1       node1     1          online   charged         no                  50                       no
1       node1     2          offline  idle            no                  50                       no
2       node2     1          online   charged         no                  100                      no
2       node2     2          online   charged         no                  100

A concise invocation example

If battery 2 in node 1 is removed (last known status is presented):

lsnodebattery

The resulting output:

node_id node_name battery_id status  charging_status recondition_needed  node_percentage_charge   end_of_life_warning 
1       node1      1          online  charged         no                  50                       no
1       node1      2          offline charged         no                  50                       no
2       node2      1          online  charged         no                  50                       no
2       node2      2          online  reconditioning  yes                 50

A detailed invocation example

lsnodebattery -battery 2 2

The resulting output:

node_id 2
node_name node2
battery_id 2
status online
charging_status reconditioning
present yes
redundant yes
recondition_needed yes
remaining_charge_capacity_mAh 1600
full_charge_capacity_mAh 1950
end_of_life_warning no
FRU_part_number FRU0001
FRU_identity 11SYM30BG123456MAN0001
compatability_level 5
last_recondition_timestamp 0
powered_on_hours 12345
cycle_count 2
node_percentage_charge 50
error_sequence_number