コマンド行からの Liberty サーバー・ダンプの生成

コマンド行から、 server dump または server javadump コマンドを使用して、 Liberty サーバーの状況情報をキャプチャーできます。

このタスクについて

server dump コマンドは、 Liberty サーバーの問題診断に役立ちます。結果ファイルには、 workarea ディレクトリーにデプロイされたアプリケーションのサーバー構成、ログ情報、および詳細が含まれているためです。 このコマンドは稼働中のサーバーにも停止しているサーバーにも適用できます。

稼働しているサーバーの場合は、以下の情報も含まれます。
  • サーバー内の各 OSGi バンドルの状態
  • サーバー内の各 OSGi バンドルのワイヤリング情報
  • Service Component Runtime (SCR) 環境によって管理されるコンポーネント・リスト
  • SCR からの各コンポーネントの詳細情報
  • 各 OSGi バンドルの構成管理データ
  • 登録された OSGi サービスに関する情報
  • Java™ 仮想マシン (JVM)、ヒープ・サイズ、オペレーティング・システム、スレッド情報、ネットワーク状況などのランタイム環境設定
server javadump コマンドは、JVM レベルでの問題 (ハング・スレッド、デッドロック、過剰な処理、過剰なメモリー消費、メモリー・リーク、仮想マシンの障害など) を診断するのに役立ちます。 このコマンドは、稼働中のサーバーでのみ使用できます。 ダンプ・タイプごとにファイルを作成しますが、 すべてのダンプ・タイプがすべての仮想マシンによってサポートされるとは限りません。 サーバー・コマンド・オプションを参照してください。 ダンプ・ファイルのデフォルト・ディレクトリーは ${server.output.dir} です。 別のデフォルト・ディレクトリーを設定するには、 IBM® JVM を使用し、以下の環境変数を設定する必要があります。            
  • IBM_HEAPDUMPDIR
  • IBM_COREDIR
  • IBM_JAVACOREDIR

手順

  1. コマンド行を開き、 wlp/bin ディレクトリーに移動します。
  2. 以下のいずれかのコマンド行ツールを使用して状況情報をキャプチャーします。 サーバー名を指定しない場合、defaultServer が使用されます。
    • サーバー状況のスナップショットを作成するには、 server dump コマンドを使用します。
      • IBM i プラットフォームの場合分散: [AIX MacOS Linux Windows]
        server dump server_name --archive=package_file_name.dump.zip --include=heap
        ここで、 package_file_name.dump.zip は選択したファイル名です。 このファイル名には、絶対パス名を含めることができます。 絶対パスを省略すると、 package_file_name.dump.zip という名前の圧縮ファイルがデフォルト・ディレクトリー ${server.output.dir}に作成されます。

      --include パラメーターはオプションです。 追加のメモリー・ダンプ・タイプを要求することができます。 例えば、--include=heap というオプションではヒープ・ダンプを要求します。 --include=thread,heap,system というオプションではスレッド・ダンプ、ヒープ・ダンプ、およびシステム・ダンプを要求します。

    • JVM 状況のスナップショットを作成するには、 server javadump コマンドを使用します。
      • IBM i プラットフォームの場合分散: [AIX MacOS Linux Windows]
        server javadump server_name --include=heap

      --include パラメーターはオプションです。 追加のメモリー・ダンプ・タイプを要求することができます。 例えば、--include=heap オプションはヒープ・ダンプを要求し、 --include=heap,system オプションはヒープ・ダンプとシステム・ダンプを要求します。 出力ファイルは、デフォルト・ディレクトリー ${server.output.dir}に作成されます。 別のデフォルト・ディレクトリーを設定するには、 IBM JVM を使用し、 IBM_HEAPDUMPDIR、 IBM_COREDIR、および IBM_JAVACOREDIR 環境変数を設定する必要があります。

    注: 結果のファイルは、項目名に UTF-8 エンコードを使用して作成されるため、ファイルを開くために使用するツールは、項目名に UTF-8 エンコードを使用できなければなりません。 Java SDK の jar コマンドは、この形式を使用します。

結果

指定したサーバーがまだ存在していない場合、コマンドは成功しません。 指定したサーバーが存在する場合、サーバーの状況情報を含む結果ファイルが作成されます。