IBM Application Performance Management 8.1.3 8.1.3.0-IBM-IPM-MSEXCH-AGENT-IF0001 Readme

IMPORTANT NOTE: To download this update, you must first login to IBM Fix Central. Once logged in, you may select from the individual download packages. When selecting fixes, ensure your download options are set to "Include requisites: Yes".
http://www.ibm.com/support/fixcentral/

Below is a list of components, platforms, and file names that apply to this Readme file.

General description
This is a cumulative interim fix for the Monitoring Agent for Microsoft Exchange Server provided with the Performance Management version 8.1.3.0 family of products and the IBM Performance Management on Cloud family of products.
It upgrades the Microsoft Exchange Server agent and application support from version 06.31.09.00 or 06.31.09.01 to 06.31.09.02.

Platforms and prerequisites
The Monitoring Agent for Microsoft Exchange Server is supported on the platforms documented here.

The interim fix for the Microsoft Exchange Server agent is intended to be applied to the Monitoring Agent for Microsoft Exchange Server version 06.31.09.00 or 06.31.09.01 which is provided with:

IBM Monitoring, Version 8.1.3.0
IBM Application Performance Monitoring, Version 8.1.3.0
IBM Application Performance Monitoring Advanced, Version 8.1.3.0.

None

Note: After the patch is applied, the Attribute Details tab on the APM UI will not display the new attributes that were added to the MS Exchange Reachability dataset. There is no workaround for this issue.

Prior to installation

The Microsoft Exchange Server agent version 06.31.09.00 or 06.31.09.01 must be installed and running before applying the agent interim fix.

Installing

Installing the Monitoring agent for Microsoft Exchange Server application support

1. On the computer system where the IBM Performance Management server is installed, check if the msexch-agent-appsupport-6.3.1.09.01.xml file exists in the <apm-server-home>/fixes directory. If the file does not exist then install the 8.1.3.0-IBM-IPM-Server-IF0004 or later Interim Fix on the IBM Performance Management server. When installing the latest server patch, skip the step for updating applications that contain the Microsoft Exchange agent.


2. Download kex_sda_6.3.1.0902.jar file from IBM Fix Central to a temporary directory (e.g. /tmp/if01-patch) on the computer where you installed the Performance Management server.


3. Run the following commands on the IBM Performance Management server:


1. cd <APM-SERVER-HOME>/ccm
2. ./install_app_support.sh -force <path to the kex_sda_6.3.1.0902.jar file>
   
   For example: ./install_app_support.sh -force /tmp/if01-patch/kex_sda_6.3.1.0902.jar
   


4. Perform these steps on the Performance Management console:


1. Edit each application that contains the Microsoft Exchange agent and delete the agent from the application
2. Save the application.
3. Then edit the application a second time and add the agent components back to the application.

1. Download the patch bundle, 8.1.3.0-IBM-IPM-MSEXCH-AGENT-WIN64-IF0001.zip from Fix Central
   
2. Unpack the patch bundle on each computer system where the agent is already installed.
3. Enter the created directory
   
   
4. Run the apmpatch.bat tool as the same user who installed the agent:
   
   apmpatch.bat <APM-AGENT-HOME>
   
   where the <APM-AGENT-HOME> value specifies the directory where the agent is installed. This value is a required parameter for Windows.
   

Performing the necessary tasks after installation of the interim fix

A successful installation modifies the Microsoft Exchange Server agent version to 06.31.09.02.

- Ensure that version number 06.31.09.02 is displayed for the Monitoring Agent for Microsoft Exchange Server on the Performance Management window.
- The agent interim fix installation logs are written to the <APM-AGENT-HOME>\INSTALLITM\ directory.

Troubleshooting installation problems from the Support site

For more detailed information, refer to the Troubleshooting and support Guide:
http://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.3/com.ibm.pm.doc/install/trouble_intro.htm

Uninstalling if necessary

This maintenance package cannot be rolled back. If necessary you can uninstall and reinstall the monitoring agent and patches.

For detailed instructions to uninstall monitoring agents, please refer to the IBM Performance Management guide, here:
http://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.3/com.ibm.pm.doc/install/uninstall_agents.htm

The Secure Hash Algorithm 1 (SHA1) checksum of the images is as follows:
SHA1(8.1.3.0-IBM-IPM-MSEXCH-AGENT-WIN64-IF0001.zip) = ac59f204b28fcd2d45f3ab52a33567f266881c9e
SHA1(kex_sda_6.3.1.0902.jar) = 976a0dbba2fe8202add56ffbd2bd44ce32741220

Image Contents
The following files implement this fix.
- 8.1.3.0-IBM-IPM-MSEXCH-AGENT-README-IF0001.readme.html - This README file

- kex_sda_6.3.1.0902.jar - File for updating application support on IBM Performance Management server)

- 8.1.3.0-IBM-IPM-MSEXCH-AGENT-WIN64-IF0001.zip - Contains the Agent patch for Windows. Extract the patch files using WinZip or similar zip utility.

Extracting the above bundle (.zip) creates the following directory and patch files:

8.1.3.0-IBM-IPM-MSEXCH-AGENT-WIN64-IF0001/
|-- apmpatch.bat
|-- patches
|-- patch.properties

New Features

The following changes are included in Microsoft Exchange Server agent interim fix:

• Defect fixes and other stability improvements

The following problems are addressed by this interim fix.

APARs
None

Agent defects:
None

Enhancements:
112687: Add support for Mailbox Reachability

APARS and defects from superseded agent interim fixes:
IV85017: User sees an error when they click on a mailbox name in the Microsoft Exchange Database Copy Status group widget