2.5.01.01: Patch 1 for Service Pack 1

This topic contains information about updates in this patch, PAZGW.2.5.01.AJ01_Hotfix - Static Block, and provides instructions for downloading and installing the patch. 

• • Patch contents
  • Applicable versions
  • Changes
  • Downloading patch files
  • Installing or upgrading to the patch
  • Updating the recording configuration file

Patch contents

The patch contains the following files:

Applicable versions

The patch applies to BMC Application Diagnostics version 2.5.01 or earlier.

Changes

The patch reduces the footprint and impact of the BMC Application Diagnostics Agent for Java on the application server. By injecting code only into classes that are marked for recording the impact on performance is reduced and the possibility of interference with applications classes.

Downloading patch files

Download the patch file from the Electronic Product Distribution (EPD)  to a temporary directory on each BMC Application Diagnostics Agent computer and extract the files.

To download the patch files

1. Log on to the EPD website.

2. Under the Product Patches tab, expand the BMC Application Management Suite.
3. Drill down to the appropriate version, platform, and language for BMC Application Diagnostics.
4. Click BMC Application Diagnostics - Static Block to download the PAZGW.2.5.01.AJ01.gz (Linux) or PAZGW.2.5.01.AJ01.zip (Windows) patch file.

Installing or upgrading to the patch

All BMC Application Diagnostics Server components (Portal and Collector) must be at version 2.5.01.

The patch contains a full agent installation.

• To perform a new Diagnostics Agent installation, see Installing-the-Agent-for-Java.
• If you have version 2.5.01 of the Diagnostics Agent, uninstall the Agent and then install the Agent for Java patch.
• If you have a version earlier than 2.5.01 of the Diagnostics Agent, see Upgrading-the-Agent-for-Java.

BMC recommends that you upgrade all Diagnostics Agents to the patched version. Running Agents with versions different from the patched Agent can result in unexpected behavior; specifically, some database queries might be only partially recorded.

Updating the recording configuration file

The patch files contain new a text file, agent-recording.java.txt, that you copy to the recording configuration file in the BMC Application Performance Management Console.

To perform this procedure, you must have Administrator-level access or higher, or have tenant Application Owner-level access.

To update the recording configuration file

1. In the BMC Application Performance Management Console, on the Diagnostics tab, select Administration > Recording Configuration.
2. Click the name (Default) of the Java platform file.

3. (Recommended) Make a backup by copying and saving the contents of the current recording configuration file in a text file.

   Note

   If you have made changes to the default, out-of-the-box recording configuration file, you will need to integrate the changes into the new recording configuration file.

4. Select Edit from the shortcut menu.
5. Open the agent-recording.java.txt file and copy the contents.
6. Return to your current recording configuration file in the Console, delete the existing recording configuration, and paste the copied contents from the agent-recording.java.txt file.
7. If you previously made manual changes to the recording configuration file, integrate those changes into the patched configuration file.
8. Click Save.