Tech Tip: HOTFIX for ‘CA Application Performance Management (APM) Data Adapter - 10.5 support’ (DE 296523)

Document created by biecl01 Employee on Jun 29, 2017
Version 1Show Document
  • View in full screen mode

After upgrading CA Application Performance Management (CA APM) from 10.3 or earlier to 10.5 (10.5.1), the APM Data Adapter fails to capture APM performance data. Apply the patch provided with this KB article to

  1. Update the data adapter drop-down list to display ‘CA APM 10.5’ or 'CA APM 10.5.1’, depending on your version of APM
  2. If applicable, fix a NullPointerException thrown while pulling performance data

 

Update the Data Adapter drop-down list

To update the data adapter drop-down list according to the version of CA APM you use to collect performance metrics, follow these steps:

 

Before deploying the patch:

  1. Verify that CCC 2.9.4 is installed and configured.
  2. Download and unpack the sql file that corresponds to your APM version:
  • APM10.5_Patch_DropDownList.zip for APM 10.5, containing 20170302182259_APM_10_5_Version.sql
  • APM10.5.1_Patch_DropDownList.zip for APM 10.5.1, containing 20170302182260_APM_10_5_1_Version.sql

 

Deploy the sql file:

Windows:

  1. Copy the sql file to the following location: <ccc_install_folder>\ccc-migrations\standard\scripts
  2. If not already set, provide the DM DB password in the ccc-db.properties file at the following two locations:
    • <ccc_install_folder>\ccc-migrations\standard\environments
    • <ccc_install_folder>\ccc-migrations\cml\environments
  3. Navigate to <ccc_install_folder>\ccc-migrations\bin and run the upgrade-ccc-db.bat script.

Linux:

  1. Copy the sql file to the following location: <ccc_install_folder>/ccc-migrations/standard/scripts
  2. If not already set, provide the DM DB password in the ccc-db.properties file at the following two locations:
    • <ccc_install_folder>/ccc-migrations/standard/environments
    • <ccc_install_folder>/ccc-migrations/cml/environments
  3. Navigate to <ccc_install_folder>/ccc-migrations/bin and run the upgrade-ccc-db.sh script.

 

Verify that the deployment was successful:

  1. Open the Data Manager application.
  2. Go to Manage Data Sources.
  3. Select CA APM as the Data Source Type.
  4. Verify that the Version drop-down list is showing CA APM 10.5 or CA APM 10.5.1, respectively.

 

Fix the NullPointerException

If you get a NullPointerException error in CCC 2.9.3 or 2.9.4 while loading performance metrics from APM, deploy the attached patch. Follow these steps:

 

Before deploying the patch:

Download and unpack APM_Patch_NullPointerException.zip. The zip file contains a file named APM_Engine.class.

 

Stop the CCC service:

 

Windows:

  1. Click Start, Control Panel, Administrative Tools. Click Services.
  2. Select the Apache Tomcat 7.0 CA_CCC service and stop it.

Linux:

  1. In a terminal, navigate to the bin directory of Apache Tomcat Server: <ccc_install_folder>/ApacheTomcat/bin
  2. Do: ./shutdown.sh

 

Deploy the class file:

  1. Make a backup copy of the following file:

    Windows:

    <ccc-install-folder>\ApacheTomcat\webapps\DM\WEB-INF\classes\com\hyperformix\DataGatherEngine\DataIntf\Engine\APM_Engine.class

    Linux:

    <ccc-install-folder>/ApacheTomcat/webapps/DM/WEB-INF/classes/com/hyperformix/DataGatherEngine/DataIntf/Engine/APM_Engine.class

  2. Replace the class file with the one you extracted from the attached zip file.

 

Start the CCC service:

Windows:

  1. Click Start, Control Panel, Administrative Tools. Click Services.
  2. Select the Apache Tomcat 7.0 CA_CCC service and start it.

Linux:

  1. In a terminal, navigate to the bin directory of Apache Tomcat Server: <ccc_install_folder>/ApacheTomcat/bin
  2. Do: ./startup.sh

Outcomes