Integrating CA SYSVIEW and CA Insight DPM With CA APM › How You Integrate CA SYSVIEW and CA Insight DPM With CA APM › Install and Enable CA APM Java Agent Components

Install and Enable CA APM Java Agent Components

The following steps are necessary to install CA APM Java Agent files.

Follow these steps:

1. If the CTG, http, and Webservices tracers are not selected at installation time, copy the jar files from <Agent_Home>\wily\examples\Cross-Enterprise_APM\ext to <Agent_Home>\wily\core\ext.
2. Select and run the Java agent installer for your environment.

   Note: For more information, see the CA APM Java Agent Implementation Guide.

   After you run the installer, verify that these files are in the following directories:

   • <Agent_Home>\wily\examples\Cross-Enterprise_APM\ext\com.wily.introscope.ext.sysview.agent_<version>.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. Enable the CTG CA SYSVIEW tracer:
   1. Copy the ext\com.wily.introscope.ext.sysview.agent_<version>.jar and ext\ctg-tracer.jar files from the <Agent_Home>\wily\examples\Cross-Enterprise_APM\ext directory to the existing <Agent_Home>\wily\core\ext directory of the Introscope agent.
   2. Verify that the ctg-tracer.jar and com.wily.introscope.ext.sysview.agent_<version>.jar files are located in the <Agent_Home>\wily\core\ext directory.
   3. Verify that the CTG_ECI_Tracer_For_Sysview.pbd file is in the <Agent_Home>\wily\core\config directory. Make the following edits to the IntroscopeAgent.profile file in the <Agent_Home>\wily\core\config directory:
      • Append CTG_ECI_Tracer_For_Sysview.pbd to the introscope.autoprobe.directives property.

        For example:

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

      • Edit <EM hostname> to point to the Enterprise Manager computer.

        For example:

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

   4. Add the ctgclient.jar file to the classpath. For example, "C:\Program Files\IBM\CICS Transaction Gateway\classes\ctgclient.jar;". This path must be the same location that the monitored CTG client application uses.
   5. Configure the CTG CA SYSVIEW Agent:

      Copy the contents of the configuration template file Cross-Enterprise_APM_CTG_Config_Template.profile in the <Agent_Home>\wily\core\config directory into the IntroscopeAgent.profile file in the <Agent_Home>\wily\core\config directory. The template contains directions on how to use these additional configuration options. The options allow you to specify whether your installation supports CTG channels, and the transactions to be traced by matching on the program.

   6. Restart the CTG-based client application that the Java agent monitors. The client application can itself be an application server.
4. Enable the web services CA SYSVIEW tracer:
   1. Install the SOA Performance Management tracer in <Agent_Home>\wily\examples\SOAPerformanceManagement by copying all files in the ext directory to the <Agent_Home>\wily\core\ext directory.

      Note: For more information, see the CA APM for SOA Implementation Guide.

   2. Copy the ext\com.wily.introscope.ext.sysview.agent_<version>.jar and ext\WS-SYSVIEW-Tracer.jar files from the <Agent_Home>\wily\examples\Cross-Enterprise_APM\ext directory to the existing <Agent_Home>\wily\core\ext directory of the Introscope agent.
   3. Verify that the WS-SYSVIEW-Tracer.jar and com.wily.introscope.ext.sysview.agent_<version>.jar files are in the <Agent_Home>\wily\core\ext directory.
   4. Verify that the WS_Tracer_For_SYSVIEW.pbd file is in the <Agent_Home>\wily\core\config directory.
   5. Make the following edits to the IntroscopeAgent.profile file in the <Agent_Home>\wily\core\config directory:
      • Append WS_Tracer_For_SYSVIEW.pbd to the introscope.autoprobe.directives property.

        For example:

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

      • Edit <EM hostname> to point to the Enterprise Manager computer.

        For example:

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

   6. Restart the web services client application that the Java agent monitors. The client application can itself be an application server.
5. Enable the HTTP CA SYSVIEW tracer:
   1. Copy the ext\com.wily.introscope.ext.sysview.agent_<version>.jar and ext\http-tracer.jar files from the <Agent_Home>\wily\examples\Cross-Enterprise_APM\ext directory to the existing <Agent_Home>\wily\core\ext directory of the Introscope agent.
   2. Verify that the http-tracer.jar and com.wily.introscope.ext.sysview.agent_<version>.jar files are in the <Agent_Home>\wily\core\ext directory.
   3. Verify that the HTTP_Tracer_For_SYSVIEW.pbd file is in the <Agent_Home>\wily\core\config directory.
   4. Make the following edits to the IntroscopeAgent.profile file in the <Agent_Home>\wily\core\config directory:
      • Append HTTP_Tracer_For_SYSVIEW.pbd to the introscope.autoprobe.directives property.

        For example:

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

      • Edit <EM hostname> to point to the Enterprise Manager computer.

        For example:

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

   5. Restart the web services client application that the Java agent monitors. The client application can itself be an application server.