Java Agent のインストールおよび設定 › Java Agent を起動するためのアプリケーション サーバの設定 › Java エージェントを使用するための JBoss の設定

Java エージェントを使用するための JBoss の設定

Java エージェントを使用するために JBoss を設定するには、使用する JBoss バージョンに対応する JBoss 起動スクリプトを編集します。

• JBoss 7 以降のバージョン用の JBoss 起動スクリプト

  スタンドアロン モードのデフォルトの JBoss 起動スクリプトは、$JBOSS_HOME/bin ディレクトリの standalone.sh または standalone.bat です。 ドメイン モードのデフォルトは、$JBOSS_HOME/bin ディレクトリの domain.sh または domain.bat です。

• JBoss 6 およびそれ以前のバージョン用の JBoss 起動スクリプト

  デフォルトでは、JBoss 起動スクリプトは $JBOSS_HOME/bin ディレクトリの run.sh または run.bat です。

Web サーバの要件に応じて、別の起動スクリプトまたは起動スクリプトの別の場所を使用できます。

以下の手順に従います。

1. JBoss 起動スクリプトがあるディレクトリに移動します。以下に例を示します。

   cd /jboss.GA/bin

2. JBoss 起動スクリプトをテキスト エディタで開きます。以下に例を示します。

   vi run.sh / vi standalone.sh

3. Java オプションを設定するコマンド ラインを入力します。 エージェントの起動 .jar ファイルおよびエージェント プロファイルへのパスを指定するための以下のコマンド ライン オプションを追加します。
   • JBoss 7 以降の場合

     -Djboss.modules.system.pkgs=com.wily,com.wily.* -javaagent:<Agent.jar のパス> -Dcom.wily.introscope.agentProfile=<エージェント プロファイルのパス>

   • JBoss 6 およびそれ以前のバージョンの場合

     -javaagent:<Agent.jar のパス> -Dcom.wily.introscope.agentProfile=<エージェント プロファイルのパス>

   たとえば Agent.jar を使用する場合は、サーバを起動するコマンドの前に以下の例のようなコードを追加します。

   • JBoss 7 以降の場合

     set JAVA_OPTS= %JAVA_OPTS% -Djboss.modules.system.pkgs=com.wily,com.wily.* -javaagent:%JBOSS_HOME%¥wily¥Agent.jar -Dcom.wily.introscope.agentProfile=%JBOSS_HOME%¥wily¥core¥config¥IntroscopeAgent.profile

   • JBoss 6 およびそれ以前のバージョンの場合

     set JAVA_OPTS= -javaagent:%JBOSS_HOME%¥wily¥Agent.jar -Dcom.wily.introscope.agentProfile=%JBOSS_HOME%¥wily¥core¥config¥IntroscopeAgent.profile %JAVA_OPTS%

4. run.bat または standalone.bat ファイルを保存します。
5. （オプション） JMX メトリックを収集するようにエージェント プロファイルを設定することで、JBoss JMX メトリックのレポートを有効にします。
   1. テキスト エディタで IntroscopeAgent.profile を開き、introscope.agent.jmx.enable=true を設定します。

      注： JMX リモート管理サーバをプラットフォーム固有の MBeanServer と共に使用することによって、JConsole で JBoss からの JMX メトリックを表示する場合は、IntroscopeAgent.profile に com.wily.use.platform.mbeanserver=true を追加します。 この設定は、プラットフォーム固有の MBeanServer の使用がコマンド ラインで設定されていた Introscope の以前のバージョンから変更されています。

   2. introscopeAgent.profile ファイルを保存して閉じます。
   3. JBoss 7 以降の場合、JBoss インストールの <Agent_Home>/wily/common ディレクトリに移動し、WebAppSupport.jar ファイルを <Agent_Home>¥wily¥core¥ext ディレクトリに移動します。
   4. JBoss 6 およびそれ以前のバージョンの場合
      • <Agent_Home>/wily/common ディレクトリに移動し、WebAppSupport.jar ファイルを /server/<server_configuration>/lib ディレクトリに移動します。
      • <Agent_Home>/wily/deploy ディレクトリに移動し、introscope-jboss-service.xml ファイルを /server/<server_configuration>/deploy ディレクトリに移動します。

      注： これらのパスはデフォルト設定を使用していることを想定しています。 使用していない場合は、ファイルを対応する JBoss インストール ディレクトリへ移動します。