41.2. コマンドラインで kdump の設定

手順

• 次のコマンドを入力して、メモリー使用量に関するレポートを生成します。

  # makedumpfile --mem-usage /proc/kcore
  
  
  TYPE        PAGES    EXCLUDABLE    DESCRIPTION
  -------------------------------------------------------------
  ZERO          501635      yes        Pages filled with zero
  CACHE         51657       yes        Cache pages
  CACHE_PRIVATE 5442        yes        Cache pages + private
  USER          16301       yes        User process pages
  FREE          77738211    yes        Free pages
  KERN_DATA     1333192     no         Dumpable kernel data

前提条件

• システムの root 権限がある。
• kdump 設定とターゲットの要件をすべて満たしている。詳細は サポートされている kdump 設定とターゲット を参照してください。

前提条件

• システムの root 権限がある。
• kdump 設定とターゲットの要件をすべて満たしている。詳細は サポートされている kdump 設定とターゲット を参照してください。

手順

• ローカルファイルシステムの /var/crash/ ディレクトリーにクラッシュダンプファイルを保存するには、/etc/kdump.conf ファイルを変更して、パスを指定します。

  path /var/crash

  path /var/crash オプションは、kdump がクラッシュダンプファイルを保存するファイルシステムへのパスを表します。

  注記
  • /etc/kdump.conf ファイルでダンプターゲットを指定すると、path は指定されたダンプ出力先に対する相対パスになります。
  • /etc/kdump.conf ファイルでダンプターゲットを指定しない場合、パスはルートディレクトリーからの 絶対 パスを表します。

  現在のシステムにマウントされているファイルシステムに応じて、ダンプターゲットと調整されたダンプパスが自動的に設定されます。

• kdump によって生成されるクラッシュダンプファイルと付随するファイルを保護するには、ユーザー権限や SELinux コンテキストなど、ターゲットの宛先ディレクトリーの属性を適切に設定する必要があります。さらに、次のように kdump.conf ファイルで kdump_post.sh などのスクリプトを定義することもできます。

  kdump_post <path_to_kdump_post.sh>

  kdump_post ディレクティブは、kdump がクラッシュダンプの取得と指定の保存先への保存を完了した 後に 実行されるシェルスクリプトまたはコマンドを指定するものです。このメカニズムを使用すると、kdump の機能を拡張して、ファイル権限の調整などの操作を実行できます。

• kdump ターゲット設定

• クラッシュダンプを保存するローカルディレクトリーを変更するには、root ユーザーとして /etc/kdump.conf 設定ファイルを編集します。

  1. #path /var/crash の行頭にあるハッシュ記号 (#) を削除します。

  2. 値を対象のディレクトリーパスに置き換えます。以下に例を示します。

     path /usr/local/cores

     重要

     RHEL 8 では、障害を回避するために、kdump systemd サービスの起動時に、path ディレクティブを使用して kdump ターゲットとして定義されたディレクトリーが存在している必要があります。以前のバージョンの RHEL とは異なり、サービス起動時にディレクトリーが存在しない場合、ディレクトリーは自動的に作成されなくなりました。

• ファイルを別のパーティションに書き込むには、/etc/kdump.conf 設定ファイルを編集します。

  1. 必要に応じて #ext4 の行頭にあるハッシュ記号 (#) を削除します。

     • デバイス名 (#ext4 /dev/vg/lv_kdump 行)
     • ファイルシステムラベル (#0ext4 LABEL=/boot 行)
     • UUID (#ext4 UUID=03138356-5e61-4ab3-b58e-27507ac41937 の行)

  2. ファイルシステムタイプとデバイス名、ラベル、または UUID を必要な値に変更します。UUID 値を指定するための正しい構文は、UUID="correct-uuid" と UUID=correct-uuid の両方です。以下に例を示します。

     ext4 UUID=03138356-5e61-4ab3-b58e-27507ac41937

     重要

     LABEL= または UUID= を使用してストレージデバイスを指定することを推奨します。/dev/sda3 などのディスクデバイス名は、再起動した場合に一貫性が保証されません。

     IBM Z ハードウェアで Direct Access Storage Device (DASD) を使用する場合は、kdump に進む前に、ダンプデバイスが /etc/dasd.conf で正しく指定されていることを確認してください。

• クラッシュダンプを直接書き込むには、/etc/kdump.conf 設定ファイルを修正します。

  1. #raw /dev/vg/lv_kdump の行頭にあるハッシュ記号 (#) を削除します。

  2. 値を対象のデバイス名に置き換えます。以下に例を示します。

     raw /dev/sdb1

• NFS プロトコルを使用してクラッシュダンプをリモートマシンに保存するには、次の手順を実行します。

  1. #nfs my.server.com:/export/tmp の行頭にあるハッシュ記号 (#) を削除します。

  2. 値を、正しいホスト名およびディレクトリーパスに置き換えます。以下に例を示します。

     nfs penguin.example.com:/export/cores

  3. 変更を有効にするには、kdump サービスを再起動します。

     sudo systemctl restart kdump.service

     注記

     NFS ディレクティブを使用して NFS ターゲットを指定すると、kdump.service が自動的に NFS ターゲットをマウントしてディスク容量をチェックしようとします。NFS ターゲットを事前にマウントする必要はありません。kdump.service がターゲットをマウントしないようにするには、kdump.conf で dracut_args --mount ディレクティブを使用します。これにより、kdump.service が --mount 引数を使用して dracut ユーティリティーを呼び出して NFS ターゲットを指定できるようになります。

• SSH プロトコルを使用してクラッシュダンプをリモートマシンに保存するには、次の手順を実行します。

  1. #ssh user@my.server.com の行頭にあるハッシュ記号 (#) を削除します。
  2. 値を正しいユーザー名およびホスト名に置き換えます。

  3. SSH キーを設定に含めます。

     1. #sshkey /root/.ssh/kdump_id_rsa の行頭にあるハッシュ記号 ("#") を削除します。

     2. 値を、ダンプ先のサーバー上の正しいキーの場所に変更します。以下に例を示します。

        ssh john@penguin.example.com
        sshkey /root/.ssh/mykey

• クラッシュダンプファイルのサイズを圧縮し、さまざまなダンプレベルを使用して必要なページのみをコピーする
• 不要なクラッシュダンプページを除外する
• クラッシュダンプに含めるページタイプをフィルタリングする

オプション

• -c、-l、または -p: zlib (-c オプションの場合)、lzo (-l オプションの場合)、または snappy (-p オプションの場合) のいずれかを使用して、ページごとに圧縮ダンプファイルの形式を指定します。
• -d (dump_level): ページを除外して、ダンプファイルにコピーされないようにします。
• --message-level: メッセージタイプを指定します。このオプションで message_level を指定すると、出力の表示量を制限できます。たとえば、message_level で 7 を指定すると、一般的なメッセージとエラーメッセージを出力します。message_level の最大値は 31 です。

前提条件

• システムの root 権限がある。
• kdump 設定とターゲットの要件をすべて満たしている。詳細は サポートされている kdump 設定とターゲット を参照してください。

• -c を使用してクラッシュダンプファイルを圧縮するには、次のコマンドを実行します。

  core_collector makedumpfile -c -d 31 --message-level 1

• -p を使用してクラッシュダンプファイルを圧縮するには、次のコマンドを実行します。

  core_collector makedumpfile -p -d 31 --message-level 1

前提条件

• root 権限
• kdump 設定とターゲットの要件をすべて満たしている。詳細は サポートされている kdump 設定とターゲット を参照してください。

• パッケージのアップグレード。
• ハードウェアレベルの変更 (ストレージやネットワークの変更など)。
• ファームウェアのアップグレード。
• サードパーティーのモジュールを含む新規のインストールおよびアプリケーションのアップグレード。
• ホットプラグメカニズムを使用した、このメカニズムをサポートするハードウェアへのメモリーの追加。
• /etc/kdump.conf ファイルまたは /etc/sysconfig/kdump ファイルに対する変更。

前提条件

• システムの root 権限がある。
• 重要なデータがすべて保存されている。kdump をテストするコマンドにより、カーネルがクラッシュし、データが失われます。
• システムアーキテクチャーに応じて、十分なマシンメンテナンス時間が確保されている。

• vmcore - クラッシュ時のシステムメモリーを含む主なカーネルメモリーダンプファイル。これには、kdump 設定で指定されている core_collector プログラムの設定に従ってデータが追加されます。デフォルトでは、カーネルデータ構造、プロセス情報、スタックトレース、およびその他の診断情報が含まれます。
• vmcore-dmesg.txt - パニックになったプライマリーカーネルからのカーネルリングバッファーログ (dmesg) の内容。
• kexec-dmesg.log - vmcore データを収集するセカンダリーの kexec カーネルの実行に基づくカーネルおよびシステムログメッセージが含まれます。

前提条件

• システムの root 権限がある。
• kdump の設定とターゲットの要件をすべて満たしている。サポートされている kdump 設定とターゲット を参照してください。
• kdump をインストールするためのすべての設定が、要件に応じてセットアップされている。

• rd.driver.blacklist=<modules>
• modprobe.blacklist=<modules>

前提条件

• システムの root 権限がある。