Hitachi

 Hitachi Application Server V10 コマンドリファレンス（Windows®用）

2.10.2　collect-snapshot

ドメイン管理サーバ稼働時のシステム情報の収集

書式

asadmin [asadmin-options] collect-snapshot
    [--infotype info-type1[,info-type2]...]
    --targettype={domain|node|server}
    [--targetname target-name1[,target-name2]...] [--timeout timeout]

格納先

Application Serverインストールディレクトリー\javaee\glassfish\bin

機能

collect-snapshotサブコマンドは、Application Serverを構成する製品のシステム情報を収集します。ドメインを構成するノードやサーバが存在する複数のホストで収集します。収集した情報は各ホスト内にシステム情報アーカイブファイルとして出力されます。

このサブコマンドの実行中に強制終了した場合、システム情報アーカイブファイルの出力先ディレクトリーに、次に示すファイルやディレクトリーが残ることがあります。

出力先ディレクトリーに生成されるシステム情報アーカイブファイルの数は上限値を設定できるため、拡張子が"zip"のファイルが残り続けることはありません。これ以外のファイルおよびディレクトリーは適宜削除してください。削除するときは、collect-snapshotサブコマンドおよびcollect-local-snapshotサブコマンドが動作中でないことをメッセージログで確認してください。

重要

  • collect-snapshotサブコマンドを実行するごとにスレッドダンプファイルが生成されます。スレッドダンプファイルを残しておく必要がない場合は、サブコマンドの実行完了後に削除してください。スレッドダンプファイルは、デフォルトではカレントディレクトリーに出力されます。ドメイン管理サーバのカレントディレクトリーは「Application Serverインストールディレクトリー/javaee/glassfish/domains/ドメイン名/config」、Java EEサーバのカレントディレクトリーは「Application Serverインストールディレクトリー/javaee/glassfish/nodes/ノード名/サーバインスタンス名/config」になります。

  • スレッドダンプファイルの出力先をカレントディレクトリーから変更した場合は、システム情報アーカイブファイルにスレッドダンプファイルが含まれなくなります。

  • タイムアウトによってシステム情報の収集が中断された場合は、collect-snapshotサブコマンドが内部で呼び出したプロセスの実行も中断されます。ただし、collect-snapshotサブコマンドが呼び出したプロセスがさらに別のプロセスを呼び出している場合、このプロセスを中断できない場合があります。

  • ドメイン管理サーバのあるホストから通信できないホストがある場合は、そのホストにあるノードおよびサーバを収集対象から除外して、collect-snapshotサブコマンドを実行してください。

実行権限

標準ユーザーアカウント

前提条件

引数

--infotype info-type1[,info-type2]...

収集するシステム情報の種類を指定します。複数の種類をコンマで区切って記述できます。

型：String

指定できる値を次に示します。

  • initinfo

    問題点の切り分けに最低限必要な、初期調査用のシステム情報を収集します。

  • sysinfo

    原因の調査に必要な、すべてのシステム情報を収集します。初期調査用のシステム情報も含みます。

デフォルト値：initinfo,sysinfo

--targettype={domain|node|server}

システム情報を収集する対象を指定します。

型：String

指定できる値を次に示します。

  • domain

    ドメインを構成する全サーバのシステム情報を収集します。--targetnameの指定値は使用されません。

  • node

    --targetnameで指定したノードを構成する全サーバのシステム情報を収集します。

  • server

    --targetnameで指定したサーバ（Java EEサーバ、Webサーバ、PRF）のシステム情報を収集します。

デフォルト値：なし

--targetname target-name1[,target-name2]...

システム情報を収集するノードまたはサーバの名称を指定します。複数の名称をコンマで区切って記述できます。

--targettypeにdomainを指定した場合は、このオプションの指定値は使用されません。

型：String

指定できる値を次に示します。

  • ノード名またはサーバ名

デフォルト値：server

--timeout timeout

このサブコマンドが呼び出したcollect-local-snapshotサブコマンドが、システム情報の収集を中止してコマンド実行を終了するまでの時間を指定します。

システム情報の収集が中止された場合、システム情報アーカイブファイルの出力先ディレクトリーに生成途中のファイルが残ることがあるため、適宜削除してください。

型：Integer

指定できる値を次に示します。

  • 1〜2147483647

デフォルト値：なし（collect-local-snapshotサブコマンドはタイムアウトしない）

使用例

次の例では、ドメインを構成する全サーバのシステム情報を収集します。

asadmin collect-snapshot --targettype=domain

戻り値

戻り値

説明

0

正常終了

1

異常終了

出力形式

このサブコマンドは、--infotypeオプションで指定したシステム情報を収集して、それぞれに対応するシステム情報アーカイブファイルを生成します。システム情報アーカイブファイルは次の名称で生成されます。

snapshot-info-type※1-収集対象名※2-日時※3-プロセスID※4-スレッドID※5.zip
※1

--infotypeオプションの指定値です。複数の値を指定した場合は、各指定値に対応する複数のシステム情報アーカイブファイルが生成されます。

※2

ドメイン管理サーバがあるホストに出力するファイルではドメイン名、ドメイン管理サーバがないノードに出力するファイルではドメイン名-ホスト名となります。

※3

形式はyyyyMMddHHmmssです。--targetnameオプションで複数のホスト上にあるノードやサーバを指定した場合、各ホストで出力するファイル名の日時は、すべてcollect-snapshotサブコマンドを実行した時点の日時になります。

※4

ドメイン管理サーバのプロセスIDの16進数表記です。

※5

ドメイン管理サーバ上で動作しているcollect-snapshotサブコマンドのスレッドIDの16進数表記です。

システム情報アーカイブファイルは、--targetnameオプションで指定したサーバが存在するホストの、次に示すディレクトリーに出力されます。

Application Serverインストールディレクトリー/javaee/snapshot

出力先ディレクトリーの場所や出力先ディレクトリーに生成できるシステム情報アーカイブファイル数は、asadminユーティリティーのsetサブコマンドおよびgetサブコマンドの次のプロパティーで設定および確認できます。

注※

アクセス権のないディレクトリーを出力先に指定した場合は、エラーメッセージ（KDKD10211-E）を出力してシステム情報収集処理が中断されます。

プロパティーの詳細は、「setサブコマンドおよびgetサブコマンドで使用するパラメーター一覧」を参照してください。

ページの先頭へ

Copyright (C) 2014, 2017, Hitachi, Ltd.

Copyright (C) 2013, Oracle and/or its affiliates. All rights reserved.