IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1

Upgrade from ITCAM for WebSphere 6.1 and ITCAM for J2EE 6.1 on Windows, Linux and UNIX systems

ITCAM for WebSphere 6.1 monitors WASs. ITCAM for J2EE 6.1 monitors J2EE application servers. The Managing Server can be shared between the products. You can upgrade one or both of these products to ITCAM for Application Diagnostics 7.1.

An ITCAM for WebSphere 6.1 or ITCAM for J2EE 6.1 installation includes the following components:

If you are using ITCAM for J2EE 6.1, the Tivoli Enterprise Monitoring Agents and IBM Tivoli Monitoring support files were updated to 6.2 fix pack 5 (this fix pack is also used for version 6.1), and the data collectors were updated to 6.1 fix pack 4, you do not need to upgrade these components. The version that is part of ITCAM for Application Diagnostics 7.1 is the same.

To plan an upgrade from ITCAM for WebSphere 6.1 and ITCAM for J2EE 6.1 to ITCAM for Application Diagnostics 7.1 on Windows, Linux and UNIX systems, determine the following information:

You must perform the upgrade in the following order:

  1. Upgrade all installations of all components of the Managing Server at the same time. During the upgrade, the Managing Server is not available, but it does not affect the performance of the application servers, or of monitoring with Tivoli Monitoring. The new Managing Server communicates with the older data collectors; therefore, monitoring can resume immediately after this step.

    See ITCAM for Application Diagnostics Managing Server Installation Guide.

  2. If ITCAM for WebSphere Tivoli Enterprise Monitoring Agents are used, upgrade IBM Tivoli Monitoring to version 6.2.2 or later.

    See IBM Tivoli Monitoring: Installation and Setup Guide.

  3. If ITCAM for WebSphere Tivoli Enterprise Monitoring Agents are used, install new support files on the Tivoli Enterprise Monitoring Servers, on all Tivoli Enterprise Portal Servers, and on all Tivoli Enterprise Portal desktop clients. Monitoring with the older Tivoli Enterprise Monitoring Agents continues after this step.

  4. On all hosts where the ITCAM for WebSphere Tivoli Enterprise Monitoring Agent is installed, install ITCAM Agent for WebSphere Applications 7.1, using the same installation directory as the older Tivoli Enterprise Monitoring Agent. After installing version 7.1, immediately install version 7.1.0.1. This installation upgrades the monitoring agent to the new version. It communicates with older data collectors if they were updated to 6.1 fix pack 4 or later; so, for such data collectors, monitoring is only interrupted briefly. However, for any data collectors that were not updated to 6.1 fix pack 4, Tivoli Monitoring stops at this point. Performance of the application servers is not affected.

    See IBM Tivoli Composite Application Manager: Agent for WebSphere Applications Installation Guide; follow the installation process described in the chapters on installing the agent on Windows or on Linux and UNIX systems, as appropriate.

  5. On all hosts where the ITCAM for WebSphere data collector is installed, install ITCAM Agent for WebSphere Applications 7.1 (Do not install it a second time if you have already installed it on the same host in Step 4). After installing version 7.1, immediately install version 7.1.0.1. This installation makes the new data collector available; however, all application server instances are still monitored by the older data collector at this point. If the IBM Tivoli Monitoring Infrastructure is used, configure the agent communication to the Tivoli Enterprise Monitoring Server correctly on every host. See IBM Tivoli Composite Application Manager: Agent for WebSphere Applications Installation Guide; follow the installation process described in the chapters on installing the agent on Windows or on Linux and UNIX systems, as appropriate.

  6. Use ITCAM Agent for WebSphere Applications 7.1.0.1 configuration, upgrade monitoring of each application server instance to the new data collector. For data collectors that were not updated to 6.1 fix pack 4, this step is required to reenable Tivoli Monitoring monitoring. For 6.1 fix pack 4 or later data collectors, monitoring is not interrupted, so you can perform the upgrade at a convenient time. The upgrade involves restarting the application server instance. See IBM Tivoli Composite Application Manager: Agent for WebSphere Applications Installation Guide; follow the upgrade procedure described in the chapters on configuring the agent on Windows or Linux and UNIX systems, as appropriate.

    After the upgrade, the data collector always communicates with the monitoring agent on the same host, even if the older data collector communicated with a Monitoring Agent on a different host. This is the standard configuration for the current version of the agent; it is best practice to keep this configuration. However, if you want to restore communication to a Monitoring Agent on a different host, you can edit the DC_home/runtime/appserver_version.node_name.server_name/kwjdc.properties file for every application server instance. Set the host name and port for the monitoring agent in this file.

  7. Update all ITCAM for J2EE Tivoli Enterprise Monitoring Servers, Tivoli Monitoring support files, and data collectors to the version that is part of ITCAM for Application Diagnostics 7.1. See ITCAM Agent for J2EE data collector Installation Guide and ITCAM Agent for J2EE Monitoring Agent Installation Guide.

    If the Tivoli Enterprise Monitoring Agents and Tivoli Monitoring support files for J2EE support files are already updated to 6.2 fix pack 5 (this fix pack is also used for version 6.1) and the data collectors for J2EE are already updated to 6.1 fix pack 4, this step is not required because the version shipped with ITCAM for Application Diagnostics 7.1 is the same.


Parent topic:

Plan an upgrade installation