CA APM Cross-Enterprise のインストールおよび設定方法 › CA APM Java エージェント コンポーネントのインストールと有効化

CA APM Java エージェント コンポーネントのインストールと有効化

CA APM Java エージェント ファイルをインストールするには、以下の手順に従う必要があります。

次の手順に従ってください：

1. インストール時に CTG、http、および Webservices トレーサが選択されていない場合、<Agent_Home>¥wily¥examples¥Cross-Enterprise_APM¥ext から <Agent_Home>¥wily¥core¥ext に jar ファイルをコピーします。
2. 環境に応じて、Java エージェント インストーラを選択して実行します。

   注： 詳細については、「CA APM Java Agent 実装ガイド」を参照してください。

   インストーラを実行した後、これらのファイルが以下のディレクトリにあることを確認します。

   • <Agent_Home>¥wily¥examples¥Cross-Enterprise_APM¥ext¥com.wily.introscope.ext.sysview.agent_<バージョン>.jar
   • <Agent_Home>¥wily¥examples¥Cross-Enterprise_APM¥ext¥ctg-tracer.jar
   • <Agent_Home>¥wily¥examples¥Cross-Enterprise_APM¥ext¥WS-SYSVIEW-Tracer.jar
   • <Agent_Home>¥wily¥examples¥Cross-Enterprise_APM¥ext¥http-tracer.jar
3. 以下のように、CTG CA SYSVIEW トレーサを有効にします。
   1. <Agent_Home>¥wily¥examples¥Cross-Enterprise_APM¥ext ディレクトリから ext¥com.wily.introscope.ext.sysview.agent_<バージョン>.jar ファイルと ext¥ctg-tracer.jar ファイルを、既存の Introscope エージェントの <Agent_Home>¥wily¥core¥ext ディレクトリにコピーします。
   2. ctg-tracer.jar ファイルと com.wily.introscope.ext.sysview.agent_<バージョン>.jar ファイルが、<Agent_Home>¥wily¥core¥ext ディレクトリに存在することを確認します。
   3. CTG_ECI_Tracer_For_Sysview.pbd ファイルが <Agent_Home>¥wily¥core¥config ディレクトリに存在することを確認します。 <Agent_Home>¥wily¥core¥config ディレクトリの IntroscopeAgent.profile ファイルを以下のように編集します。
      • introscope.autoprobe.directives プロパティに CTG_ECI_Tracer_For_Sysview.pbd を追加します。

        例：

        introscope.autoprobe.directivesFile=CTG_ECI_Tracer_For_Sysview.pbd,hotdeploy.

      • Enterprise Manager コンピュータに指すように、<EM hostname> を編集します。

        例：

        introscope.agent.enterprisemanager.transport.tcp.host.DEFAULT=<EM hostname>.

   4. ctgclient.jar ファイルをクラスパスに追加します。 たとえば、「C:¥Program Files¥IBM¥CICS Transaction Gateway¥classes¥ctgclient.jar;」のように追加します。 このパスは監視対象の CTG クライアント アプリケーションが使用するのと同じ場所である必要があります。
   5. CTG CA SYSVIEW エージェントを設定します。

      <Agent_Home>¥wily¥core¥config ディレクトリの設定テンプレート ファイル Cross-Enterprise_APM_CTG_Config_Template.profile の内容を、<Agent_Home>¥wily¥core¥config ディレクトリの IntroscopeAgent.profile にコピーします。 テンプレートには、これらの追加設定オプションの使用方法の説明が含まれています。 このオプションでは、インストールで CTG チャネルをサポートするかどうか、およびプログラムによって照合することによりトランザクションを追跡するかどうかを指定できます。

   6. Java エージェントが監視する CTG ベースのクライアント アプリケーションを再起動します。 クライアント アプリケーションは、それ自体がアプリケーション サーバの可能性があります。
4. Web サービス CA SYSVIEW トレーサを有効にします。
   1. ext ディレクトリのすべてのファイルを <Agent_Home>¥wily¥core¥ext ディレクトリにコピーすることにより、<Agent_Home>¥wily¥examples¥SOAPerformanceManagement にある SOA パフォーマンス管理トレーサをインストールします。

      注： 詳細については、「CA APM for SOA 実装ガイド」を参照してください。

   2. <Agent_Home>¥wily¥examples¥Cross-Enterprise_APM¥ext ディレクトリから ext¥com.wily.introscope.ext.sysview.agent_<バージョン>.jar ファイルと ext¥WS-SYSVIEW-tracer.jar ファイルを、既存の Introscope エージェントの <Agent_Home>¥wily¥core¥ext ディレクトリにコピーします。
   3. WS-SYSVIEW-tracer.jar ファイルと com.wily.introscope.ext.sysview.agent_<バージョン>.jar ファイルが、<Agent_Home>¥wily¥core¥ext ディレクトリに存在することを確認します。
   4. WS_Tracer_For_Sysview.pbd ファイルが <Agent_Home>¥wily¥core¥config ディレクトリに存在することを確認します。
   5. <Agent_Home>¥wily¥core¥config ディレクトリの IntroscopeAgent.profile ファイルを以下のように編集します。
      • introscope.autoprobe.directives プロパティに WS_Tracer_For_SYSVIEW.pbd を追加します。

        例：

        introscope.autoprobe.directivesFile=websphere-typical.pbl, hotdeploy, spm.pbl,WS_Tracer_For_SYSVIEW.pbd

      • Enterprise Manager コンピュータを指すように、<EM hostname> を編集します。

        例：

        introscope.agent.enterprisemanager.transport.tcp.host.DEFAULT=<EM hostname>

   6. Java エージェントが監視する Web サービス クライアント アプリケーションを再起動します。 クライアント アプリケーションは、それ自体がアプリケーション サーバの可能性があります。
5. HTTP CA SYSVIEW トレーサを有効にします。
   1. <Agent_Home>¥wily¥examples¥Cross-Enterprise_APM¥ext ディレクトリから ext¥com.wily.introscope.ext.sysview.agent_<バージョン>.jar ファイルと ext¥http-tracer.jar ファイルを、既存の Introscope エージェントの <Agent_Home>¥wily¥core¥ext ディレクトリにコピーします。
   2. http-tracer.jar ファイルと com.wily.introscope.ext.sysview.agent_<バージョン>.jar ファイルが、<Agent_Home>¥wily¥core¥ext ディレクトリに存在することを確認します。
   3. HTTP_Tracer_For_SYSVIEW.pbd ファイルが <Agent_Home>¥wily¥core¥config ディレクトリに存在することを確認します。
   4. <Agent_Home>¥wily¥core¥config ディレクトリの IntroscopeAgent.profile ファイルを以下のように編集します。
      • introscope.autoprobe.directives プロパティに HTTP_Tracer_For_SYSVIEW.pbd を追加します。

        例：

        introscope.autoprobe.directivesFile=websphere-typical.pbl, hotdeploy, spm.pbl,HTTP_Tracer_For_SYSVIEW.pbd

      • Enterprise Manager コンピュータを指すように、<EM hostname> を編集します。

        例：

        introscope.agent.enterprisemanager.transport.tcp.host.DEFAULT=<EM hostname>

   5. Java エージェントが監視する Web サービス クライアント アプリケーションを再起動します。 クライアント アプリケーションは、それ自体がアプリケーション サーバの可能性があります。