DX Operational Intelligence

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

06-29-2017 06:31 AM

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

Statistics
0 Favorited
0 Views
3 Files
0 Shares
0 Downloads
Attachment(s)
zip file
APM10.5_Patch_DropDownList.zip   14K   1 version
Uploaded - 05-29-2019
zip file
APM10.5.1_Patch_DropDownList.zip   14K   1 version
Uploaded - 05-29-2019
zip file
APM_Patch_NullPointerException.zip   22K   1 version
Uploaded - 05-29-2019

Tags and Keywords

Comments

06-29-2017 06:46 AM

Thanks for posting this update.

 

It's good to have it available as a Hot Fix.  In terms of self-service support, I'm sure some people will be ok with making these sorts of changes themselves, so this is great information to have.

 

If an end user is uncomfortable making these kinds of changes themselves, presumably they can still raise a support ticket and one of our wonderful support staff will work through the process with them?

 

Thanks.

Related Entries and Links

No Related Resource entered.