dumpctrl コマンド

目的

システム・ダンプとライブ・ダンプを管理します。

構文

dumpctrl -k

dumpctrl -R [ l | s ] [ -P]

dumpctrl -s [ -c | -C comp-path-list ] [-l | -L comp-alias-list] [ -t | -T type_subtype ] [-r] [ -u]

dumpctrl -qc [-c comp-path-list] [-l comp-alias-list] [-t type_subtype] [-r] [-u] [-p | -P]

dumpctrl -ql [-p | -P]

dumpctrl -qs [-p | -P]

dumpctrl [-P] [ global_attribute]

dumpctrl [-c comp-path-list ] [l comp-alias-list] [-t type_subtype] [ -r] [-u] [ -n | -p | -P | -x] [ per-component_attribute]

説明

ダンプ・コンポーネントには、次の 2 つのタイプがあります。
component
RAS インフラストラクチャーで指定されたコンポーネント (ras_register() カーネル・サービスで作成されたもの) を参照します。
legacy component
dmp_add() または dmp_ctl() カーネル・サービスで指定されたダンプ・コンポーネントを参照します。

dumpctrl コマンドは、どのコンポーネントがライブ・ダンプまたはシステム・ダンプに登録されるかについての情報を入手し、ダンプ特性を照会して変更するために使用します。

コンポーネントは、絶対パス名、デバイス論理の別名、タイプまたはサブタイプで指定されます。複数のコンポーネントまたはコンポーネント・リストを指定するために、複数のフラグを使用できます。

フラグ

少なくとも 1 つのフラグを指定する必要があります。

項目 説明
-c comp-path-list コンポーネントをパス名で指定します。 ワイルドカードを使用できます。-c all コマンドを使用すると、すべてのコンポーネントを指定できます。
-k カーネルのダンプ・リストをリフレッシュします。このフラグは、デフォルトで 5 分ごとに実行されます。この時間を変更するには、root ユーザーの crontab コマンドを編集し、/usr/sbin/dumpctrl -k のエントリーを変更します。詳しくは、crontab コマンドを参照してください。ダンプを手動で追加したり除去した場合は、その後に dumpctrl -k コマンドを実行する必要があります。

システムは、前回ファイルシステムに書き込めなかったダンプをヒープ内に保持している場合、それらのダンプの書き込みを試行し、この時点でそれらのストレージ・スペースを再利用します。
-l comp-alias-list コンポーネントを別名で指定します。 ワイルドカードを使用できます。
-r 指定されたコンポーネントのサブコンポーネントをダンプします。
-q cmd ライブ・ダンプまたはシステム・ダンプの属性を照会します。
  • -qc フラグは、コンポーネント固有のライブ・ダンプ属性とシステム・ダンプ属性を表示します。-qc フラグを -p または -P フラグと一緒に使用すると、コンポーネントごとの永続的属性を照会できます。-qc フラグは、-c、-l、-t のいずれのフラグも指定されていない場合、すべてのコンポーネントの属性を表示します。すなわち、-c all がデフォルトです。
    このコマンドの出力例を次に示します。 
    dumpctrl -qc -r -l vmm -l proc

--------------------------------------------------------------------------
     Component name                       | Have | Live Dump | System Dump
                                          |Alias |  /level   |  /level
--------------------------------------------------------------------------
vmm                                       | no   |  on/3     |  on/3
     .pft                                 | no   |  on/3     |  on/3
	 ...
proc                                      | no   |  on/4     |  on/3
     ...
  • -ql フラグはグローバル・ライブ・ダンプ設定をリストします。-ql フラグを -p または -P フラグと一緒に使用すると、永続的なグローバル・ライブ・ダンプ設定を照会できます。
  • -qs type フラグは、グローバル・システム・ダンプ属性を表示します。-qs を -p または -P フラグと一緒に使用すると、グローバル・システム・ダンプ属性を照会できます。
-r コンポーネントの階層で指定されたコンポーネントの下にコンポーネントを組み込みます。
-Rx ダンプ設定をそのデフォルトに復元します。x には、ライブ・ダンプ設定では l、システム・ダンプ設定では s を指定できます。 これは、グローバルなダンプ設定のみをリセットします。コンポーネントを個別に指定することはできません。これらのすべての設定を再始動後も有効にするには、-P フラグと新しいブート・イメージが必要です。
-t type_subtype コンポーネントを type_subtype 名で指定します。
-s ダンプ・リポジトリーですべてのライブ・ダンプのパス名とタイトルをリストします。コンポーネントが -c、-l、または -t フラグで指定されている場合は、指定されたコンポーネントのダンプのみが、表示されるダンプのリストに含まれます。コンポーネントが -C、-L、または -T フラグで指定されている場合は、指定された障害のあるコンポーネントのダンプのみが、表示されるダンプのリストに含まれます。
-C comp-path-list コンポーネントをパス名で指定します。 ワイルドカードを使用できます。予約名 all を使用してすべてのコンポーネントを指定することもできます。-C フラグは、-s フラグとともに使用する場合のみ有効です。
-L comp-alias-list コンポーネントを別名で指定します。 ワイルドカードを使用できます。-L フラグは、-s フラグとともに使用する場合のみ有効です。
-T type_subtype コンポーネントを type_subtype 名で指定します。 -T フラグは、-s とともに使用する場合のみ有効です。
-u コンポーネントの階層で指定されたコンポーネントの上にコンポーネントを組み込みます。
Persistence flags
項目 説明
-p 変更内容は、新規に作成されるコンポーネントにのみ適用されます。これは dumpctrl コマンドの実行後に作成される RAS インフラストラクチャーのコンポーネントです。
-P 指定された変更を永続的なものにします。変更内容は再始動後も有効のままです。新しいブート・イメージが必要な場合は、それについて通知するメッセージが生成されます。-P フラグが適用されるのは、コンポーネント属性、ライブ・ダンプのグローバルな使用可能化または使用不可化、グローバル・ライブ・ダンプのレベル、レガシー・コンポーネントの使用可能化または使用不可化、およびシステム・ダンプ・デバイスの指定です。
-n 変更内容は既存のコンポーネントに適用されます。-p または -P のいずれも指定しない場合は、-n フラグがデフォルトです。 変更内容を現行のコンポーネントと新規作成のコンポーネントの両方に適用するには、-n フラグと -p フラグを使用します。
-x この永続性の指定を削除します。-x フラグは、永続的な (-P) パーシスタンスの指定を削除します。この指定は、当初 -P フラグで指定したのと同じ方法で指定する必要があります。

再帰的に下るカスタマイズ (-r フラグにより指定) は、他のすべてのカスタマイズよりも優先されます。この場合、再帰的に下るカスタマイズではない他のカスタマイズに対してそれらが指定される順序は関係ありません。

設定されたカスタマイズが不明だが、デフォルトのシステム設定を復元したい場合は、以下のいずれかのアクションを実行できます。
  • /var/adm/ras/raspertune ファイルで、カスタマイズに関連する行を削除し、bosboot コマンドを実行して AIX® を再始動します。
  • /var/adm/ras/raspertune ファイルで、指定されている該当のフラグとパラメーターを見つけます。 -x フラグを使用して、そのカスタマイズを削除します。 bosboot コマンドを実行し、AIX を再始動します。

さまざまなダンプ属性が永続性とどのように相互作用するかについては、属性のライブ・ダンプ属性とシステム・ダンプ属性テーブルを参照してください。

属性

ダンプ属性は attribute=value の形式を使用できます。次に例を示します。
dumpctrl dir=/usr/dumps freespc=20
この例では、ダンプ・ディレクトリーが /usr/dumps、フリー・スペースのしきい値が 20% に設定されています。

ショートカットがいくつかあります。例えば、ldmpenable=yes と同じ ldmpon 属性などです。

コンポーネントが指定されると、未知の属性が RASCD_DMP_PASS_THROUGH を使用してこれらのコンポーネントのコールバックに渡されます。

次の表では、ライブ・ダンプ属性を示します。

表 1. ライブ・ダンプ属性とデフォルト
属性 指定 デフォルト値
ldmpenable ライブ・ダンプを使用可能にするかを指定します。

使用可能な値は yes と no です。

ldmpenable=yes の代わりに ldmpon 属性、ldmpenable=no の代わりに ldmpoff 属性を使用することができます。

yes

詳しくは、以下の注 (1) を参照してください。
dir ライブ・ダンプのディレクトリー名を指定します。 /var/adm/ras/livedump
freespc ライブ・ダンプのフリー・スペースのしきい値を 0 から 99 の 10 進数を使用して指定します。 25 (25% の意味)
ldmplevel ライブ・ダンプのレベルを 0 から 9 の 10 進数を使用して指定します。

ldmplevel=1, 3, 7 の代わりに、ldmpminimal、ldmpnormal、または ldmpdetail 属性を指定することができます。

 3 (normal)

詳しくは、以下の注 (1) を参照してください。
heapsz ライブ・ダンプのヒープ・サイズを 10 進数 (メガバイト) を使用して指定します。 0

詳しくは、以下の注 (2) を参照してください。
duptype 重複ダンプの抑止タイプを指定します。使用可能な値は次のとおりです。
  • all
  • pre
  • post
  • none
 all
maxfreeze 推奨されるシステム・フリーズの最大インターバルを 10 進数 (ミリ秒) を使用して指定します。 100 ms

次の表では、システム・ダンプ属性を示します。

表 2. システム・ダンプ属性とデフォルト
属性 指定 デフォルト値
sdmpenable システム・ダンプを使用可能にするかを指定します。

使用可能な値は yes と no です。

sdmpenable=yes または sdmpenable=no の代わりに、sdmpon または sdmpoff を指定することができます。

yes

詳しくは、以下の注 (3) を参照してください。
legacyenable ダンプのレガシー・コンポーネントを使用可能にするかを指定します。

使用可能な値は yes と no です。

legacyenable=yes または legacyenable=no の代わりに、legacyon または legacyoff を指定することができます。

yes
sdmplevel システム・ダンプのレベルを 0 から 9 の 10 進数を使用して指定します。

sdmplevel=1, 3, 7 の代わりに、sdmpminimal、sdmpnormal、または sdmpdetail 属性を指定することができます。

 3 (normal)

詳しくは、以下の注 (4) を参照してください。
copydir コピー・ディレクトリーのパス名を指定します。 /var/adm/ras
forcecopy forcecopy 属性を使用可能にするかを指定します。

使用可能な値は yes と no です。

ダンプをブート時にページング・スペースからコピーしなければならないときに、コピー・ディレクトリーにスペースがない場合は、forcecopy 値が yes になっていると、そのダンプを取り外し可能メディアにコピーするようにプロンプトが出されます。この値が no になっていると、ダンプはコピーされずに、システムは通常どおりにブートします。ただし、ダンプは失われる可能性があります。

yes
keyseq キー・シーケンスで常にダンプを行うかを指定します。

使用可能な値は yes と no です。

no
primary 1 次ダンプ・デバイスのパス名を指定します。 /dev/hd6 または /dev/lg_dumplv
secondary 2 次ダンプ・デバイスのパス名を指定します。 /dev/sysdumpnull
注:
  1. ldmpenable 属性と ldmplevel 属性は、コンポーネントとともに指定するか、またはコンポーネントなしで指定することができます。コンポーネントなしで指定すると、属性は対応するグローバル属性に適用されます。
  2. heapsz 属性 (ヒープ・サイズ) を 0 に設定することができます。ダンプの初期化時に、システムは実メモリーの量に基づいてライブ・ダンプのヒープ・サイズを計算します。これは最小で 64 MB および実メモリーのサイズの 1/64 です。
  3. sdmpenable 属性が指定されている場合は、コンポーネントを個別に指定する必要があります。コンポーネントが指定されていない場合は、sdmpenable 属性を指定することはできません。システム・ダンプを使用不可にすることはできないためです。
  4. sdmplevel 属性は、コンポーネントとともに指定するか、またはコンポーネントなしで指定することができます。コンポーネントなしで指定すると、システム・デフォルト・レベルに適用されます。 sdmplevel がグローバル sdmplevel 値より大きなコンポーネントは、システム・ダンプには含まれません。

次の表では、ライブ・ダンプ属性とその永続性を示します。

表 3. ライブ・ダンプ属性と永続性
属性 説明 永続性
ldmpenable ライブ・ダンプが使用可能 永続性フラグによって制御され、-P フラグには新しいブート・イメージが必要です。
dir ライブ・ダンプのディレクトリー 即時およびシステムの再始動後に有効になります。
freespc ライブ・ダンプのフリー・スペースのしきい値 即時およびシステムの再始動後に有効になります。
ldmplevel ライブ・ダンプのレベル 永続性フラグによって制御され、-P フラグには新しいブート・イメージが必要です。
heapsz ライブ・ダンプのヒープ・サイズ 即時およびシステムの再始動後に有効になります。
duptype 重複ダンプの抑止タイプ 即時およびシステムの再始動後に有効になります。
maxfreeze 推奨されるシステム・フリーズの最大インターバル 即時およびシステムの再始動後に有効になります。
注: 永続性が属性に影響を与えるのは、これらが RAS インフラストラクチャーのコンポーネントに適用される場合のみです。また、永続性は、グローバルなライブ・ダンプのレベルとグローバルな使用可能状況または使用不可状況を制御します。

次の表では、システム・ダンプ属性とその永続性を示します。

表 4. システム・ダンプ属性と永続性
属性 説明 永続性
sdmpenable システム・ダンプが使用可能 永続性フラグによって制御され、-P フラグには新しいブート・イメージが必要です。
legacyenable ダンプのレガシー・コンポーネント 即時、および -P フラグによるシステムの再始動後に有効になります。-P フラグに新しいブート・イメージは必要ありません。
sdmplevel システム・ダンプのレベル 永続性フラグによって制御され、-P フラグには新しいブート・イメージが必要です。
copydir コピー・ディレクトリー 即時およびシステムの再始動後に有効になります。
forcecopy コピーできない場合はブート時メニューを提示する 即時およびシステムの再始動後に有効になります。
keyseq キー・シーケンスで常にダンプを行う 即時およびシステムの再始動後に有効になります。
primary 1 次ダンプ・デバイス 即時、および -P フラグによるシステムの再始動後に有効になります。-P フラグに新しいブート・イメージは必要ありません。
secondary 2 次ダンプ・デバイス 即時、および -P フラグによるシステムの再始動後に有効になります。-P フラグに新しいブート・イメージは必要ありません。
注: 永続性が属性に影響を与えるのは、これらがコンポーネントに適用される場合です。

copydir、forcecopy、keyseq、primary、secondary の各属性は、sysdumpdev コマンドの -d、-D、-k、-K、-p、-s の各フラグで指定された、対応する属性のように機能します。詳しくは、「コマンド・リファレンス 第 5 巻」の sysdumpdev コマンドを参照してください。

終了状況

このコマンドは次の終了値を戻します。

項目 説明
0 正常終了。
ゼロ以外の値 エラーが発生しました。 このコマンドは以下の条件の場合に失敗します。
  • 1 つ以上のパラメーターが無効である。
  • 1 つ以上の属性が無効である。
  • コンポーネントを指定できない。
  • 少なくとも 1 つのコンポーネントを指定する必要がある。
  • 永続性の指定が見つからない。(それは -x フラグで発生する場合があります。)

セキュリティー

このコマンドは、root ユーザーのみが実行できます。