lsnodebattery

Use the lsnodebattery command to display information about the batteries in a node.

Syntax

Read syntax diagramSkip visual syntax diagram lsnodebattery -batterybattery_idnode

Parameters

-delim delimiter
(Optional) Specify a delimiter to separate data in the output.
-nohdr
(Optional) Suppress the headings in the output.
-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.
This table 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.