lsnodebattery

使用 lsnodebattery 指令來顯示節點中電池的相關資訊。

語法

讀取語法圖表略過語法圖表 lsnodebattery -delimdelimiter-nohdr-batterybattery_idnode

參數

-nohdr
（選用）依預設，會在簡要樣式視圖中顯示每個資料直欄的標題，以及在詳細樣式視圖中顯示每個資料項目的標題。-nohdr 參數會暫停顯示這些標題。
註： 如果沒有要顯示的資料，就不會顯示標題。
-delim delimiter
（選用）依預設，簡要視圖中的所有資料直欄都以空格區隔。每個直欄的寬度都會設為各資料項目的最大寬度。在詳細視圖中，每個資料項目本身都有一列，如果顯示標頭，會用空格來區隔資料與標頭。-delim 參數會置換此行為。-delim 參數的有效輸入為一個單位元組字元。如果您在指令行輸入 -delim :，則會用冒號字元 (:) 來區隔簡要視圖中的所有資料項目；例如，直欄不會出現間距。在詳細視圖中，會用指定的定界字元來區隔資料與其標頭。
-battery battery_id
（選用）指定電池 ID。如果您指定這個參數，則還必須指定 node。
node
（選用）指定節點 ID 或名稱。

說明

這個指令會顯示節點中電池的相關資訊。在簡要視圖中，所有節點中的每一個電池插槽都會顯示一行。
該表提供了對於在輸出視圖中顯示為資料的屬性適用的可能值。
表 1. lsnodebattery 屬性值
屬性 值
node_id 識別包含電池的節點。
node_name 識別包含電池的節點。
battery_id 識別節點中的電池。
status 識別電池的狀態：
  • online 指出電池存在且正常運作（包括電池校準）。
  • degraded 指出電池存在但未正常運作（已記載相關錯誤）。
  • offline 指出偵測不到電池或電池故障（已記載關於電池的節點錯誤，指出缺少電池或故障）。
    記住： 如果狀態為 offline，則所有其他欄位都會顯示最新的電池資料。如果未顯示任何資料，則所有欄位都保留空白。
charging_status 識別電池的充電狀態：
  • charged 指出電池已充滿電。
  • charging 指出電池充電中。
  • discharging 指出在電池再充電之後，電池電壓（壽命）降低且正在重新校準電量計。
  • idle 指出電池既不在充電中，也不在放電中，但它未完全充滿電。
  • reconditioning 指出電池正在透過放電再充電的方式來自行重新續電。
重要： 大約每三個月會重新續電一次（在備援系統上），可能需要花費 12 - 48 個小時。
recondition_needed 識別電池需要重新續電，或必須盡快開始重新續電。 需要重新校準，因為來自電量計的報告值已不可信。值為 yes 和 no。
node_percentage_charge 識別電池的已充電百分比以判斷它是否可以支援節點。
end_of_life_warning 指出電池壽命結束（有警告聲）。值為 yes 和 no。
重要： 更換電池。
present 識別電池是否存在。值為 yes 和 no。
redundant 識別是否可以安全移除電池。值為 yes 和 no。
remaining_charge_capacity_mAh 識別電池的剩餘電量（當電池再充電時），以毫安培小時 (mAh) 為單位。
full_charge_capacity_mAh 識別電池充滿電後的電量 (mAh)。
FRU_part_number 指出電池的 FRU 產品編號。此值包含 7 個英數字元。
FRU_identity 識別 11S 號碼（結合製造零件號碼及序號）。此值包含 22 個英數字元。
compatibility_level 指出電池驅動程式軟體必須支援現行軟體層次，才能操作此電池（此值來自電池重要產品資料 或 VPD）。
last_recondition_timestamp 指出前次成功校準電量計時的系統時間戳記。 格式為 YYMMDDHHMMSS，其中：
  • YY 指出年。
  • 第一個 MM 指出月。
  • DD 指出日。
  • HH 指出小時。
  • 第二個 MM 指出分鐘。
  • SS 指出秒。
powered_on_hours 指出電池位於已供電節點中的時數。
cycle_count 識別電池執行充電或放電循環的次數。
error_sequence_number 識別最高優先順序錯誤的錯誤日誌號碼。這個欄位通常是空白，但如果狀態是 degraded 或 offline，則會顯示錯誤序號。

簡要呼叫範例

如果未安裝節點 1 中的電池 2： 

lsnodebattery

結果輸出：

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

簡要呼叫範例

如果節點 1 中的電池 2 無法充電： 

lsnodebattery

結果輸出：

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

簡要呼叫範例

如果已移除節點 1 中的電池 2（前次已知狀態是 presented）： 

lsnodebattery

結果輸出：

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

詳細的呼叫範例

lsnodebattery -battery 2 2

結果輸出：

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