Apache Tomcatスタートアップ設定

Apache Tomcat でアプリケーションをインストゥルメント化するには、Java エージェント JAR の場所を Catalina 環境または CATALINA_OPTS 変数として追加します。

Apache Tomcatのインストゥルメント化

  1. setenv.sh（Linux）ファイルまたは setenv.bat（Windows）ファイルを開きます（存在しない場合は作成します）。
    Tomcat 6 以降の場合は、ファイルを CATALINA_BASE/bin ディレクトリに置くことができます。それ以前のバージョンの Tomcat では、CATALINA_HOME/bin ディレクトリにファイルを置きます。
  2. 以下のとおり、-javaagent 引数を Catalina 環境変数としてファイルに追加します。
    Linuxの場合：
    CODE 
    export CATALINA_OPTS="$CATALINA_OPTS -javaagent:<agent_home>/javaagent.jar"

    <agent_home> を Java エージェント JAR ファイルへのフルパスと置き換えます。

    例：
    CODE 
    export CATALINA_OPTS="$CATALINA_OPTS -javaagent:/home/appserver/appagent/javaagent.jar"
    Windowsの場合：
    CODE 
    set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:"Drive:<agent_home>\javaagent.jar"
    例：
    CODE 
    set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:C:\appagent\javaagent.jar
  3. アプリケーションサーバーを再起動して変更を適用する。サービスとしての Tomcat の実行の詳細は、「起動時のプロパティおよびオプションの設定」を参照してください。

Windowsサービスとして実行中のTomcatのインストゥルメント化

Tomcat を Windows サービスとして実行する場合、Tomcat の起動プロパティに javaagent 引数を追加します。以下の手順は、Apache Tomcat 6.x 以降に適用されます。

Windows サービスとして実行中の Tomcat に Java エージェントをインストールするには、次の手順を実行します。

  1. 管理者権限を使用していることを確認する。
  2. Apache tomcat<version>w.exe ユーティリティを実行して、エージェントをロードするために tomcat サービスを構成します（<version> で、インストゥルメント化された Tomcat のメジャーバージョン番号を表します）。
    例：
    CODE 
    tomcat8w //ES//<servicename>
  3. [Java] タブをクリックし、[Java Options] で次のように追加します。
    CODE 
    -javaagent:<agent_home>\javaagent.jar
  4. Tomcatサービスを再起動して変更を適用する。