ナビゲーションリンクをスキップ | |
印刷ビューの終了 | |
マニュアルページセクション 1M: システム管理コマンド Oracle Solaris 11 Information Library (日本語) |
- 障害管理構成ツール
fmadm [-q] [subcommand [arguments]]
fmadm ユーティリティーは、管理者とサービス担当者が Solaris Fault Manager (fmd(1M)) によって管理されているシステム構成パラメータを表示および変更するために使用できます。 fmd は、システムソフトウェアが検出した問題に関する遠隔測定情報を受け取り、問題を診断し、障害のあるコンポーネントの無効化などの予測的自己修復操作を開始します。
fmadm を使って次の操作を実行できます。
障害管理に現在関与している一連の診断エンジンおよびエージェントの表示
障害があると診断されたシステムコンポーネントのリストの表示
前述のエンティティーに関連する管理タスクの実行
Fault Manager ができるだけ多くの操作を自動化しようとするため、通常は fmadm を使用する必要はありません。Fault Manager が管理者、サービス修復技術者、または Oracle の助けを必要とする場合は、その必要性を示すメッセージが生成されます。また、Sun の Web サイトのナレッジ記事が参照先として示されます。この Web サイトでは、fmadm またはほかの障害管理ユーティリティーを使った詳細情報の収集や追加タスクの実行を求められることがあります。fmd(1M)、fmdump(1M)、および fmstat(1M) の各ドキュメントには、障害管理操作を監視するツールに関する詳しい説明があります。
Fault Manager が行う処理の 1 つに、コンポーネントの位置の追跡があります。シャーシレベルでは、fmadm *-alias サブコマンドはシャーシの product-id.chassis-id から alias-id へのマッピングを管理します。管理された alias-id は、なんらかの意味のある方法でシャーシの物理的な位置を記述するためのものです。
fmadm ユーティリティーを使用するユーザーは、SYS_CONFIG 特権を持っている必要があります。Solaris の特権を構成する方法の詳細については、『Oracle Solaris の管理: セキュリティーサービス』 を参照してください。fmadm load サブコマンドを使用するユーザーは、すべての特権を持っている必要があります。
fmadm で使用できるサブコマンドは、次のとおりです。一部のサブコマンドは追加のオプションやオペランドを受け入れるか、または追加のオプションやオペランドが必要です。load、unload、reset、および rotate は、トレーニングを受けた技術担当者向けのサブコマンドです。これらのサブコマンドを使用する際には、ナレッジベース記事などの具体的な指針に従うことをお勧めします。
Fault Manager に、指定したリソースが uuid で識別される障害イベントで、または UUID が指定されていない場合は、検出されたどの障害でも疑わしいとは見なされないことを通知します。fmadm acquit サブコマンドは、Sun のマニュアルに記載されている修復手順で指示された場合にのみ使用してください。管理者は、以前に障害が発生したリソースを再度有効にするために、追加のコマンドを適用しなければならない場合があります。
Fault Manager に、uuid で識別された障害イベントを安全に無視できることを通知します。fmadm acquit サブコマンドは、Sun のマニュアルに記載されている修復手順で指示された場合にのみ使用してください。管理者は、以前に障害が発生したリソースを再度有効にするために、追加のコマンドを適用しなければならない場合があります。
Fault Manager 自体の構成を表示します。これには、各コンポーネントモジュールのモジュール名、バージョン、および説明が含まれます。Fault Manager のモジュールは、システムに存在するハードウェアおよびソフトウェアに対して自動診断、自己修復、メッセージ配信などのサービスを提供します。
Fault Manager で現在障害があると見なされているリソースのステータス情報を表示します。
次のオプションがサポートされています。
すべての障害を表示します。 fmadm faulty コマンドのデフォルトでは、現時点で存在し、障害のあるリソースに関する出力が一覧表示されます。-a オプションを指定すると、自動的に修正された障害や、復旧操作を必要としない障害も含め、Fault Manager によってキャッシュされたすべてのリソース情報が表示されます。この一覧表示には、システムにすでに存在しない可能性があるリソースの情報も含まれます。
障害のある FRU (現場交換可能ユニット) を表示します。
FRU、クラス、および障害メッセージが同じ障害をグループ化します。
Fault Manager 内の各リソースの永続的キャッシュ識別子を表示します。
障害またはリソースが -a または -g オプションでグループ化されている場合は、出力を max 個のエントリに制限します。
各障害の間にフォームフィードを挿入して出力をページャーを介してパイプします。
障害管理リソースを識別子 (FMRI) と障害管理状態とともに表示します。
障害イベントごとに 1 行の障害要約を表示します。
指定された uid の障害のみを表示します。
完全な出力を表示します。
障害の原因が、別のクラスまたは別の FRU のどちらかに複数存在する場合は、確実性の割合 (パーセント) が表示されます。同じ FRU 上に複数のリソースがあり、障害がその FRU に関連していることが 100% 確実でない場合は、原因がその FRU にある確実性の最大の割合 (パーセント) が表示されます。
Fault Manager は、受け取った遠隔測定情報を持つすべてのリソースに次の状態を割り当てます。
リソースが存在し、使用中であり、Fault Manager に関するかぎり既知の問題はありません。
リソースが存在しないか、または使用不能ですが、既知の問題はありません。これは、管理者によってリソースが無効化または構成解除されたことを示している場合があります。詳細については、適切な管理ツールを参照してください。
リソースは存在しますが、Fault Manager の診断によって 1 つ以上の問題が見つかったため、使用不能です。システムにこれ以上の損害を与えないように、このリソースは無効化されています。
リソースが存在し、使用できますが、Fault Manager の診断によってこのリソースに 1 つ以上の問題が見つかりました。
影響を受けるすべてのリソースが同じ状態にある場合は、これがリストの最後にあるメッセージに反映されます。それ以外の場合は、影響を受ける各リソースのあとに状態が表示されます。
Fault Manager によってキャッシュされたリソースの情報を FMRI で指定してフラッシュします。このサブコマンドは、Sun のマニュアルに記載されている修復手順で指示された場合にのみ使用してください。Fault Manager がキャッシュを自動的に最新の状態に維持するため、通常はこのコマンドを使用する必要はありません。キャッシュから障害のあるリソースをフラッシュした場合、管理者は指定したリソースを有効にするために追加のコマンドを適用しなければならないことがあります。
指定された Fault Manager モジュールを読み込みます。path は、絶対パスで指定し、モジュール用に定義されたいずれかのディレクトリに存在するモジュールを参照する必要があります。Fault Manager が Solaris の初期起動時や必要な場合に自動的にモジュールを読み込むため、通常はこのコマンドを使用する必要はありません。
指定された Fault Manager モジュールを読み込み解除します。module は、fmadm config の出力に表示されたベース名を使って指定します。Fault Manager がシステム構成に基づいて自動的にモジュールの読み込みと読み込み解除を行うため、通常はこのコマンドを使用する必要はありません。
Fault Manager に、指定したリソースに対して修復手順が実行されたことを通知します。fmadm repaired サブコマンドは、Sun のマニュアルに記載されている修復手順で指示された場合にのみ使用してください。管理者は、以前に障害が発生したリソースを再度有効にするために、追加のコマンドを適用しなければならない場合があります。
Fault Manager に、指定したリソースが交換されたことを通知します。このコマンドは、Fault Manager が交換を自動的に検出できない場合に使用してください。fmadm replaced サブコマンドは、Sun のマニュアルに記載されている修復手順で指示された場合にのみ使用してください。管理者は、以前に障害が発生したリソースを再度有効にするために、追加のコマンドを適用しなければならない場合があります。
指定された Fault Manager モジュールまたはモジュールのサブコンポーネントをリセットします。-s オプションを指定すると、モジュール内部の指定した Soft Error Rate Discrimination (SERD) エンジンがリセットされます。-s オプションを指定しないと、モジュール全体がリセットされ、モジュールに関連付けられたすべての永続状態が削除されます。fmadm reset サブコマンドは、Sun のマニュアルに記載されている修復手順で指示された場合にのみ使用してください。Fault Manager がモジュールを自動的に管理するため、通常はこのコマンドを使用する必要はありません。
rotate サブコマンドは、logadm が有効なログファイルを正しくローテーションできるようにするための、logadm(1M) のヘルパーコマンドです。これは、直接呼び出すようには設計されていません (直接呼び出すとログ履歴が失われる可能性が高くなります)。現在のログファイルのサイズが 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
add-alias サブコマンドは、alias-id を product-id.chassis-id シャーシの管理された別名として確立するために使用します。管理された別名が定義されている場合、シャーシの /dev/chassis devchassis(7FS) 名前空間表現では、product-id.chassis-id ではなく、より意味のある alias-id が使用されます。
# fmadm add-alias SUN-Storage-J4410.1039QAQ007 RACK29.U25-28
上記のコマンドでは、新しいマッピングが既存のマッピングと競合しないことを検証します。競合する場合は、マッピングの変更は行われません。このサブコマンドは、関連付けられた名前空間の更新が完了したときに完了します。更新された名前空間が新しい alias-id を使用しない場合、警告が出力されますが、マッピングは更新されます。名前空間の更新に時間がかかりすぎる場合、警告が出力されます。
省略可能な注釈を指定した場合、注釈は保持され、後続の lookup-alias または list-alias コマンドによって表示されます。
remove-alias サブコマンドは、product-id.chassis-id から alias-id へのマッピングを削除するために使用します。
# fmadm remove-alias RACK29.U25-28
上記のサブコマンドは、関連付けられた名前空間の更新が完了したときに完了します。
lookup-alias サブコマンドは、現在のマッピングの内容を確認するために使用できます。コマンドの例を次に示します。
# fmadm lookup-alias SUN-Storage-J4410.1039QAQ007
list-alias サブコマンドは、すべての注釈とマッピングを表示するために使用します。
sync-alias サブコマンドは、一連のマッピングを一括で手動インポートするために使用します。現在のマッピングは 2 つのコピーが保持されます。
/etc/dev/chassis_aliases
/etc/dev/.chassis_aliase
一連のマッピングを一括でインポートするには、/etc/dev/chassis_aliases ファイルを更新してから、sync-alias を実行します。
次のオプションがサポートされています。
非出力モードを設定します。操作が成功したときに、fmadm は標準出力に結果メッセージを出力しません。
次のオペランドがサポートされています。
「サブコマンド」に示されているサブコマンドの名前。
選択したサブコマンドに対応する 1 つ以上のオプションまたは引数 (「サブコマンド」に示されているもの)。これらの引数としては、fmri、uuid、label などが挙げられます。これらは、fmadm サブコマンドの対象となるリソースを識別します。ある対象リソースの fmri、uuid、および label を取得するには、fmadm faulty を使用します。「使用例」を参照してください。一般に、これらのオペランドの中でもっともユーザーにとってわかりやすいのは、label です。
例 1 faulty サブコマンドの呼び出し
次のコマンドは faulty サブコマンドを呼び出すことで、あるコンポーネントの uuid、label、および fmri を表示しています。
# fmadm faulty ------------ ------------------------------------ ------------ --------- TIME EVENT-ID MSG-ID SEVERITY ------------ ------------------------------------ ------------ --------- Sep 09 16:15 96609fae-113c-e48c-b1cf-ebf4b0902d72 DISK-8000-3E Critical injected Host : x4170-brm-02 Platform : SUN-FIRE-X4170-SERVER Chassis_id : 0920XF508B Product_sn: Fault class: fault.io.scsi.cmd.disk.dev.rqs.derr Affects : dev:///:devid=id1,sd@n5000c5000940edbb//scsi_vhci/disk@g5000c\ 5000940edbb out of service, but associated components no longer faulty FRU : "DISK 11" (hc://:product-id=SUN-Storage-J4410:server-id=:chassis-id=:serial=000930\ G01CN4----3SJ01CN4:part=SEAGATE-ST330057SSUN300G:revision=0205/\ ses-enclosure=0/bay=11/disk=0) replaced ... ...
前述の出力で、uuid は EVENT-ID 列の最初の項目 96609fae-113c-e48c-b1cf-ebf4b0902d72 です。label は、FRU 行の DISK 11 です。fmri は次のとおりです。
dev:///:devid=id1,sd@n5000c5000940edbb//scsi_vhci/disk@g5000c\ 5000940edbb hc://:product-id=SUN-Storage-J4410:server-id=:chassis-id=:serial=000930\ G01CN4--------3SJ01CN4:part=SEAGATE-ST330057SSUN300G:revision=0205/\ ses-enclosure=0/bay=11/disk=0)
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=:product-id=SUN-Storage-J4410:chassis-id=:\ server-id=/ses-enclosure=0/bay=11/disk=0 Affects: dev:///:devid=id1,sd@n5000c5000940edbb//\ scsi_vhci/disk@g5000c5000940edbb FRU: hc://:product-id=SUN-Storage-J4410:server-id=:chassis-id=:\ serial=000930G01CN4--------3SJ01CN4:part=SEAGATE-ST330057SSUN300G:\ revision=0205/ses-enclosure=0/bay=11/disk=0 Location: DISK 11
label がもっとも使用しやすい識別子です。
例 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)