fmadm - 障害管理構成ツール
fmadm [-q] [subcommand [arguments]]
fmadm ユーティリティーを使用すると、管理者やサービス担当者は、Solaris Fault Manager (fmd(1M)) によって保持されているシステム構成パラメータを表示および変更できます。fmd は、システムソフトウェアによって検出された状態に関連する症状の遠隔測定情報を受信し、その遠隔測定情報を障害、欠陥、またはアラートに診断し、障害のあるコンポーネントの無効化などの予防的な自己修復操作を開始します。
fmadm コマンドを使って次の操作を実行できます。
障害管理に現在関与している一連の診断エンジンおよびエージェントの表示。
障害、欠陥、またはアラートに関連があると診断されたシステムコンポーネントのリストの表示。
前述のエンティティーに関連する管理タスクの実行。
Fault Manager ができるだけ多くの操作を自動化しようとするため、通常は fmadm を使用する必要はありません。Fault Manager が管理者、サービス修復技術者、または Oracle の助けを必要とする場合は、その必要性を示すメッセージが生成されます。また、Oracle の Web サイトのナレッジ記事が参照先として示されます。この Web サイトでは、fmadm またはほかの障害管理ユーティリティーを使った詳細情報の収集や追加タスクの実行を求められることがあります。fmd(1M)、fmdump(1M)、fmstat(1M) の各マニュアルページのドキュメントや『Oracle Solaris 11.3 での障害、欠陥、およびアラートの管理』のドキュメントでは、障害管理操作を監視するためのツールがより詳細に説明されています。
Fault Manager が行う処理の 1 つに、コンポーネントの位置の追跡があります。シャーシレベルでは、fmadm *-alias サブコマンドはシャーシ chassis-name.chassis-serial から alias-id へのマッピングを管理します。管理された alias-id は、シャーシの物理的な位置を記述するためのものです。
fmadm ユーティリティーでは、ユーザーが SYS_ADMIN 特権を保持している必要があります。Solaris 特権を構成する方法の詳細は、Oracle Solaris 11.3 でのシステムおよび接続されたデバイスのセキュリティー保護を参照してください。fmadm load サブコマンドを使用するユーザーは、すべての特権を持っている必要があります。
fmadm コマンドで使用できるサブコマンドは、次のとおりです。一部のサブコマンドは追加のオプションやオペランドを受け入れるか、または追加のオプションやオペランドが必要です。acquit、load、unload、repaired、replaced、reset、および rotate は、トレーニングを受けた技術担当者向けのサブコマンドです。これらのサブコマンドを使用する際には、ナレッジベース記事などの具体的な指針に従うことをお勧めします。
Fault Manager に、指定したリソースが uuid で識別される障害イベントで、または UUID が指定されていない場合は、検出されたどの障害、欠陥、アラートでも疑わしいとはみなされないことを通知します。fmadm acquit コマンドは、Oracle のドキュメントに記載されている修復手順で指示された場合にのみ使用してください。管理者は、以前に障害が発生したリソースを再度有効にするために、追加のコマンドを適用しなければならない場合があります。
Fault Manager に、uuid で識別されたイベントを安全に無視できることを通知します。fmadm acquit コマンドは、Oracle のドキュメントに記載されている修復手順で指示された場合にのみ使用してください。管理者は、以前に障害が発生したリソースを再度有効にするために、追加のコマンドを適用しなければならない場合があります。
add-alias サブコマンドは、alias-id を chassis-name.chassis-serial シャーシの管理された別名として確立するために使用されます。管理された別名が定義されているときは、シャーシの /dev/chassis devchassis(7FS) 名前空間表現では、chassis-name.chassis-serial ではなく、より意味のある alias-id が使用されます。
# fmadm add-alias SUN-Storage-J4410.1039QAQ007 RACK29.U25-28
上記のコマンドでは、新しいマッピングが既存のマッピングと競合しないことを検証します。競合する場合は、マッピングの変更は行われません。このコマンドは、関連付けられた名前空間の更新が完了したときに完了します。更新された名前空間が新しい alias-id を使用しない場合、警告が出力されますが、マッピングは更新されます。名前空間の更新に時間がかかりすぎる場合、警告が出力されます。
省略可能な注釈を指定した場合、注釈は保持され、後続の lookup-alias または list-alias コマンドによって表示されます。remove-alias および sync-alias も参照してください。
Fault Manager に、指定された位置 label または uuid に関連する、または class@resource で識別される、すべてのアラートイベントをクリアするべきであることを通知します。このコマンドは (欠陥や障害ではなく) アラートのみに適用できます。
Fault Manager 自体の構成を表示します。これには、各コンポーネントモジュールのモジュール名、バージョン、および説明が含まれます。Fault Manager のモジュールは、システムに存在するハードウェアおよびソフトウェアに対して自動診断、自己修復、メッセージ配信などのサービスを提供します。
このコマンドは fmadm list コマンドの別名です。
指定されたリソースの、そのリソースがすでに修復、解決、または交換されたすべての障害、欠陥、アラートに関する Fault Manager によってキャッシュされた情報をフラッシュします。
Fault Manager で現在障害、欠陥、またはアラートに関連があるとみなされているリソースのステータス情報を表示します。list-alert、list-defect、および list-fault も参照してください。
サポートしているオプションは、次のとおりです。
障害、欠陥、またはアラートに関連している可能性のあるすべてのリソースを表示します。デフォルトでは、fmadm list コマンドは、まだアクティブである障害、欠陥、またはアラートに関連するリソースの出力のみを一覧表示します。–a オプションを指定した場合は、すでに解決または修復されたか、あるいはシステム内に存在しなくなっている可能性のあるリソースに関する情報を含め、Fault Manager によってキャッシュされたすべてのリソース情報が一覧表示されます。
障害、欠陥、またはアラートに関連している FRU (現場交換可能ユニット) を表示します。
Fault Manager 内の各リソースの永続的キャッシュ識別子を表示します。
各イベントの間にフォームフィードを挿入して出力をページャーを介してパイプします。
影響を受けた Solaris リソースを、その識別子 (FMRI) および障害管理状態とともに表示します。
イベントごとに 1 行のサマリーを表示します。
指定された uuid のイベントのみを表示します。
完全な出力を表示します。
イベントに対して複数の原因 (異なるクラスまたは異なる FRU) が考えられる場合は、その確度が表示されます。同じ FRU 上に複数のリソースがあり、イベントがその FRU に関連していることが 100% 確実でない場合は、その FRU 上の考えられる原因の最大確度が表示されます。
このサブコマンドの動作は list と同様ですが、アラートイベントを含む疑いリストだけが表示されます。
list-alias コマンドは、すべての注釈とマッピングを表示するために使用します。add-alias、lookup-alias、remove-alias、および sync-alias も参照してください。
このサブコマンドの動作は list と同様ですが、欠陥イベントを含む疑いリストだけが表示されます。
このサブコマンドの動作は list と同様ですが、障害イベントを含む疑いリストだけが表示されます。
Fault Manager は、障害、欠陥、またはアラートがあると診断されたすべての FRU に次の状態を関連付けます。
FRU は Fault Manager によって障害、欠陥、またはアラートに関連があると診断されており、引き続きシステム内に存在します。
FRU は Fault Manager によって障害、欠陥、またはアラートに関連があると診断されましたが、システム内に存在しなくなっています。
FRU はシステムから取り外されており、代わりに交換用 FRU が設置されています。
Fault Manager に FRU が修復されたことを通知するために、コマンド fmadm repaired が使用されました。
Fault Manager に FRU が解決されたことを通知するために、コマンド fmadm acquit が使用されました。
影響を受けたすべての Solaris リソースの状態も表示されます。障害がある FRU の場合、関連するリソースの状態は次のいずれかです。
障害があり、サービス対象外
障害があるが、引き続きサービス提供中
障害があるが、引き続き縮退サービス提供中
修復、交換、または解決済みの FRU の場合、関連するリソースの状態は次のいずれかです。
正常であり、サービス提供中
サービス対象外だが、関連するコンポーネントの障害はなくなった
サービスは縮退しているが、関連するコンポーネントの障害はなくなった
指定された Fault Manager モジュールをロードします。path は、絶対パスで指定し、モジュール用に定義されたいずれかのディレクトリに存在するモジュールを参照する必要があります。Fault Manager が Solaris の初期ブート時や必要な場合に自動的にモジュールをロードするため、通常はこのコマンドを使用する必要はありません。fmadm unload も参照してください。
指定された Fault Manager モジュールを読み込み解除します。module は、fmadm config の出力に表示されたベース名を使って指定します。Fault Manager がシステム構成に基づいて自動的にモジュールの読み込みと読み込み解除を行うため、通常はこのコマンドを使用する必要はありません。
lookup-alias サブコマンドは、現在のマッピングの内容を確認するために使用できます。コマンドの例を次に示します。
# fmadm lookup-alias SUN-Storage-J4410.1039QAQ007
add-alias、list-alias、remove-alias、および sync-alias も参照してください。
fmadm remove-alias サブコマンドは、chassis-name.chassis-serial から alias-id へのマッピングを削除するために使用します。
# fmadm remove-alias RACK29.U25-28
前述のコマンドは、関連付けられた名前空間の更新が完了したときに完了します。add-alias、list-alias、lookup-alias、および sync-alias も参照してください。
Fault Manager に、指定したリソースに対して修復手順が実行されたことを通知します。fmadm repaired コマンドは、Oracle のドキュメントに記載されている修復手順で指示された場合にのみ使用してください。管理者は、以前に障害が発生したリソースを再度有効にするために、追加のコマンドを適用しなければならない場合があります。
Fault Manager に、指定したリソースが交換されたことを通知します。このコマンドは、Fault Manager が交換を自動的に検出できない場合に使用してください。fmadm replaced コマンドは、Oracle のドキュメントに記載されている修復手順で指示された場合にのみ使用してください。管理者は、以前に障害が発生したリソースを再度有効にするために、追加のコマンドを適用しなければならない場合があります。
指定された Fault Manager モジュールまたはモジュールのサブコンポーネントをリセットします。–s オプションを指定すると、モジュール内部の指定した Soft Error Rate Discrimination (SERD) エンジンがリセットされます。–s オプションを指定しないと、モジュール全体がリセットされ、モジュールに関連付けられたすべての永続状態が削除されます。fmadm reset コマンドは、Oracle のドキュメントに記載されている修復手順で指示された場合にのみ使用してください。Fault Manager がモジュールを自動的に管理するため、通常はこのコマンドを使用する必要はありません。
fmadm rotate コマンドは、logadm が有効なログファイルを正しくローテーションできるようにするための、logadm(1M) コマンドのヘルパーコマンドです。fmadm rotate コマンドは、直接呼び出すようには設計されていません (直接呼び出すとログ履歴が失われる可能性が高くなります)。現在のログファイルのサイズが 0 でない場合に、適切なログファイルがローテーションされるようにするには、次のいずれかのコマンドを使用します。
# logadm -p now -s 1b /var/fm/fmd/errlog # logadm -p now -s 1b /var/fm/fmd/fltlog # logadm -p now -s 1b /var/fm/fmd/infolog # logadm -p now -s 1b /var/fm/fmd/infolog_hival
sync-alias サブコマンドは、一連のマッピングを一括で手動インポートするために使用します。現在のマッピングは 2 つのコピーが保持されます。
/etc/dev/chassis_aliases
/etc/dev/.chassis_aliases
一連のマッピングを一括でインポートするには、/etc/dev/chassis_aliases ファイルを更新してから、fmadm sync-alias を実行します。add-alias、list-alias、lookup-alias、および remove-alias も参照してください。
指定された Fault Manager モジュールを読み込み解除します。モジュールは、fmadm config の出力に表示されたベース名を使って指定します。Fault Manager がシステム構成に基づいて自動的にモジュールのロードとアンロードを行うため、通常はこのコマンドを使用する必要はありません。fmadm load も参照してください。
サポートしているオプションは、次のとおりです。
非出力モードを設定します。操作が成功したときに、fmadm は標準出力に結果メッセージを出力しません。
次のオペランドがサポートされています。
「サブコマンド」に示されているサブコマンドの名前。
選択したサブコマンドに対応する 1 つ以上のオプションまたは引数 (「サブコマンド」に示されているもの)。これらの引数としては、fmri、uuid、label などが挙げられます。これらは、fmadm サブコマンドの対象となるリソースを識別します。ある対象リソースの fmri、uuid、および label を取得するには、fmadm list を使用します。一般に、これらのオペランドの中でもっともユーザーにとってわかりやすいのは、label です。下の「使用例」のセクションを参照してください。
次のコマンドは list サブコマンドを呼び出すことで、あるコンポーネントの uuid、label、および fmri を表示しています。
# fmadm list
------------ ------------------------------------ ------------ ---------
TIME EVENT-ID MSG-ID SEVERITY
------------ ------------------------------------ ------------ ---------
Sep 09 16:15 96609fae-113c-e48c-b1cf-ebf4b0902d72 DISK-8000-3E Critical
Problem Status : open
Diag Engine : eft / 1.16
System
Manufacturer : Oracle-Corp.
Name : SUN-FIRE-X4170-SERVER
Part Number : unknown
Serial Number: 0920XF508B
----------------------------------------
Suspect 1 of 1:
Fault class: fault.io.scsi.cmd.disk.dev.rqs.derr
Certainty : 100%
Affects : dev:///:devid=id1,sd@n5000c5000940edbb//scsi_vhci/disk@g\
5000c5000940edbb
Status : faulted and taken out of service
FRU
Status : faulty
Location : "/SUN-Storage-J4410.1037QAQ052/HDD11"
Location Alias : "/RACK29.U25-28/HDD11"
Manufacturer : SEAGATE
Name : ST330057SSUN300G
Part Number : SEAGATE-ST330057SSUN300G
Revision : 0205
Serial Number : 000930G01CN4----3SJ01CN4
Chassis
Manufacturer : Oracle-Corp.
Name : SUN-Storage-J4410
Part Number : 594-5329
Serial Number : 1037QAQ052
...
...
前述の出力で、uuid は EVENT-ID 列の最初の項目 96609fae-113c-e48c-b1cf-ebf4b0902d72 です。label は、FRU セクション内の Location 行「/SUN-Storage-J4410.1037QAQ052/HDD11」にあります。この例では、シャーシの別名が設定されており、別名を付けた位置が Location Alias 行「/RACK29.U25-28/HDD11」に表示されます。
fmri は、fmdump –v で使用可能です:
# fmdump -v Sep 09 16:15:36.9252 96609fae-113c-e48c-b1cf-ebf4b0902d72 DISK-8000-3E \ Diagnosed 100% fault.io.scsi.cmd.disk.dev.rqs.derr Problem in: hc://:scheme=:chassis-mfg=Oracle-Corp.:chassis-name=SUN-\ Storage-J4410:chassis-part=594-5329:chassis-serial=1037QAQ052/ses-\ enclosure=0/bay=11/disk=0 Affects: dev:///:devid=id1,sd@n5000c5000940edbb//\ scsi_vhci/disk@g5000c5000940edbb FRU: hc://chassis-mfg=Oracle-Corp.:chassis-name=SUN-Storage-J4410\ :chassis-part=594-5329:chassis-serial=1037QAQ052:fru-mfg=SEAGATE\ :fru-name=SEAGATE-ST330057SSUN300G:fru-part=SEAGATE-ST330057SSUN300G\ :fru-revision=0205:fru-serial=000930G01CN4--------3SJ01CN4/\ ses-enclosure=0/bay=11/disk=0 FRU Location: "/SUN-Storage-J4410.1037QAQ052/HDD11"
label がもっとも使用しやすい識別子です。Location の別名を付けた形式または別名を付けない形式のどちらでも使用できます。
使用例 2 モジュール名の取得次のコマンドは、各コンポーネントのモジュール名を表示しています。モジュール名は、fmadm unload コマンドの入力として指定します。
# fmadm config MODULE VERSION STATUS DESCRIPTION cpumem-retire 1.1 active CPU/Memory Retire Agent disk-transport 1.0 active Disk Transport Agent eft 1.16 active eft diagnosis engine ..
次の終了ステータスが返されます。
正常終了。
エラーが発生した。エラーには、fmd との通信の失敗や、要求された操作の実行に必要な特権の不足などが含まれます。
無効なコマンド行オプションが指定されました。
属性についての詳細は、マニュアルページの attributes(5) を参照してください。
|
コマンド行オプションは「確実」です。人間が読める形式の出力は非インタフェースです。
fmd(1M), fmdump(1M), fmstat(1M), logadm(1M), syslogd(1M), attributes(5), devchassis(7FS)
Oracle Solaris 11.3 での障害、欠陥、およびアラートの管理