lsnodebattery

lsnodebattery コマンドを使用して、ノード内のバッテリーに関する情報を表示します。 このコマンドは、SAN ボリューム・コントローラー 2145-DH8 システムに適用されます。

構文

構文図を読む構文図をスキップする
>>-lsnodebattery-- --+-----------------------+-- --------------->
                     '- -delim -- delimiter -'      

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

パラメーター

-nohdr
(オプション) デフォルトでは、見出しは、簡略形式のビューではデータの列ごとに、詳細形式のビューではデータの項目ごとに表示されます。-nohdr パラメーターは、これらの見出しの表示を抑止します。
注: 表示するデータがない場合、見出しは表示されません。
-delim delimiter
(オプション) デフォルトでは、簡略形式のビューのデータのすべての列がスペースで区切られます。各列の幅は、データの各項目の最大幅に設定されています。詳細ビューでは、データの項目ごとに 1 行が使用されます。見出しが表示される場合は、データと見出しはスペースで区切られます。-delim パラメーターは、この動作を指定変更します。-delim パラメーターでは、1 バイトの文字を入力できます。コマンド・ラインに -delim : と入力すると、簡略ビューのすべてのデータ項目がコロン (:) で区切られます。例えば、列の間の空白は発生しません。 詳細ビューでは、データと見出しは指定の区切り文字で区切られます。
-battery battery_id
(オプション) バッテリー ID を指定します。このパラメーターを指定する場合は、node も指定する必要があります。
ノード (node)
(オプション) ノードの ID または名前を指定します。

説明

このコマンドは、ノード内のバッテリーに関する情報を表示します。簡略ビューには、すべてのノード内の各バッテリー・スロットごとに行が表示されます。
表 1 は、出力ビューのデータとして表示される属性に適用可能な値を示しています。
表 1. lsnodebattery の属性値
属性
node_id バッテリーを含むノードを識別します。
node_name バッテリーを含むノードを識別します。
battery_id ノード内のバッテリーを識別します。
status 次のようにバッテリーの状況を示します。
  • online は、バッテリーが存在し、通常どおりに動作している場合に示されます (バッテリーの調整が含まれます)。
  • degraded は、バッテリーが存在するものの、通常どおりに動作していないことを示します (バッテリーに対してエラーが記録されています)。
  • offline は、バッテリーを検出できないか、バッテリーに障害があることを示します (欠落または障害を示すノード・エラーがバッテリーに対して記録されています)。
    要確認: 状況が offline の場合、その他すべてのフィールドには最新のバッテリー・データが表示されます。データが表示されない場合、すべてのフィールドはブランクのままです。
charging_status 次のようにバッテリーの充電状態を示します。
  • charged は、バッテリーが完全に充電されていることを示します。
  • charging は、バッテリーが充電中であることを示します。
  • discharging は、バッテリーの電圧 (寿命) が失われつつあり、バッテリーの再充電後に電源ゲージの再調整が行われていることを示します。
  • idle は、バッテリーが充電中でも放電中でもなく、完全に充電済みでもないことを示します。
  • reconditioning は、バッテリーが放電と再充電後に自己修理中であることを示します。
重要: 修理は (冗長システム上で) 約 3 カ月ごとに行われ、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 は時を示します。
  • 2 番目の 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 が取り外された場合 (最後に認識された状況が提示されます)。

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