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:
- The data collector, installed on every monitored node and configured for every monitored application server instance. ITCAM for WebSphere 6.1 data collectors monitor WASs. ITCAM for J2EE 6.1 data collectors monitors J2EE application servers.
- The Managing Server, which communicates with the data collectors and provides the Visualization Engine user interface. The Managing Server can be installed on one host, or its components can be "split" between several hosts. The same Managing Server can communicate with ITCAM for WebSphere data collectors and ITCAM for J2EE data collectors.
- Optional: Tivoli Enterprise Monitoring Agents, which provide monitoring with IBM Tivoli Monitoring. A Tivoli Enterprise Monitoring Agent communicates with data collectors on one or several hosts and with the Tivoli Enterprise Monitoring Server. ITCAM for WebSphere Tivoli Enterprise Monitoring Agent and ITCAM for J2EE Tivoli Enterprise Monitoring Agent are different. For each Tivoli Enterprise Monitoring Agent in use, support files must be installed on the Tivoli Enterprise Monitoring Servers, on all Tivoli Enterprise Portal Servers, and on all Tivoli Enterprise Portal desktop clients.
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:
- On which hosts the Managing Server is installed
- On which hosts the data collectors are installed and configured
- Which of the data collectors were updated to 6.1 fix pack 4 or later
- Whether Tivoli Enterprise Monitoring Agents are used; if so, on which hosts they are installed
You must perform the upgrade in the following order:
- 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.
- If ITCAM for WebSphere Tivoli Enterprise Monitoring Agents are used, upgrade IBM Tivoli Monitoring to version 6.2.2 or later.
- 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.
- 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.
- 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.
- 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.
- 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