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 › Run with Legacy Mode PBDs

Run with Legacy Mode PBDs

You can run with legacy versions of the PBDs instead of the new mode versions that are already placed in the directory <Agent_Home>\wily\core\config.

Follow these steps:

1. Select and run the Java agent installer for your environment.

   Note: For more information about legacy mode PBDs, see the CA Application Performance Management Java Agent Implementation Guide.

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

   <Agent_Home>\wily\examples\legacy\CTG_ECI_Tracer_For_SYSVIEW-legacy.pbd
   <Agent_Home>\wily\examples\legacy\WS_Tracer_For_SYSVIEW-legacy.pbd
   <Agent_Home>\wily\examples\legacy\HTTP_Tracer_For_SYSVIEW-legacy.pbd

2. Copy the legacy PBD files to the existing <Agent_Home>\wily\core\config directory of the CA Introscope agent.
3. Copy the following files from the <Agent_Home>\wily\examples\Cross-Enterprise_APM\ext directory to the existing <Agent_Home>\wily\core\ext directory of the CA Introscope agent:
   • com.wily.introscope.ext.sysview.agent_<version>.jar
   • ctg-tracer.jar
   • WS-SYSVIEW-Tracer.jar
   • http-tracer.jar
4. Enable the legacy CTG CA SYSVIEW tracer:
   1. Make the following edits to the IntroscopeAgent.profile file in the <Agent_Home>\wily\core\config directory:
      • Append CTG_ECI_Tracer_For_SYSVIEW-legacy.pbd to the introscope.autoprobe.directivesFile property, for example:

        introscope.autoprobe.directivesFile=CTG_ECI_Tracer_For_SYSVIEW-legacy.pbd,hotdeploy
        

      • Identify the Enterprise Manager computer, <EM hostname>, for example:

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

   2. Add the ctgclient.jar file to the class path, 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.

   3. Configure the CTG CA SYSVIEW tracer:

      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.

   4. Restart the CTG-based legacy client application that the Java agent monitors. The client application can itself be an application server.
5. Enable the legacy 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. Install the legacy version of the SOA tracer.

   2. Make the following edits to the IntroscopeAgent.profile file in the <Agent_Home>\wily\core\config directory:
      • Append spm.pbl and WS_Tracer_For_SYSVIEW-legacy.pbd to the introscope.autoprobe.directivesFile property, for example:

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

      • Identify the Enterprise Manager computer, <EM hostname>, for example:

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

   3. Restart the web services client application that the Java agent monitors. The client application can itself be an application server.
6. Enable the legacy HTTP CA SYSVIEW tracer:
   1. Make the following edits to the IntroscopeAgent.profile file in the <Agent_Home>\wily\core\config directory:
      • Append HTTP_Tracer_For_SYSVIEW-legacy.pbd to the introscope.autoprobe.directivesFile property, for example:

        introscope.autoprobe.directivesFile=HTTP_Tracer_For_SYSVIEW.pbd,hotdeploy
        

      • Identify the Enterprise Manager computer, <EM hostname>, for example:

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

   2. Restart the HTTP-based client application that the Java agent monitors. The client application can itself be an application server.