CLM Server Monitoring with IBM Tivoli Monitoring

Authors: BorisKuschel
Build basis: CLM 4.0.5, ITM 6.2.1+, Monitoring Agent for CLM Server Monitoring 4.0.5, Monitoring Agent for CLM Server Monitoring for WebSphere Application Server 4.0.5

This page gives the instructions on how to set up the IBM Tivoli Monitoring Agents for CLM Server Monitoring so that the performance data can be consumed by IBM Tivoli Monitoring components, namely Tivoli Enterprise Monitoring Server (hereby referred to as TEMS) and Tivoli Enterprise Portal Server (hereby referred to as TEPS).

The following server host names are assumed:

* itm.jazz.net - Server hosting an instance of TEMS and TEPS * clmjts.jazz.net - instance of the JTS Server application fin which the Tivoli OS agent is installed and the Monitoring Agent for CLM Server Monitoring is installed.

These instructions will cover both the installation on CLM applications hosted WebSphere Application Server and/or Tomcat, in either case the application server is installed on clmjts.jazz.net.

It is recommended to set up the agent on the same machine as the application server it is monitoring and to ensure that the JConsole tool is able to connect cleanly to the CLM Server Monitoring JMX interface.

Tivoli Agent Setup

This section assumes that the machine on which the agent is installed is able to connect cleanly to the CLM Server Monitoring interface using JConsole.

In order for Agent metadata and configuration to appear as available datasets in Tivoli Enterprise Monitoring Server and Tivoli Enterprise Portal Server, the appropriate support files need to be installed on those servers.

Preparing TEMS and TEPS

On the TEMS and TEPS machines (itm.jazz.net) unzip the installation package for the Application Servers you have CLM application deployed on. If your environment contains WebSphere and Tomcat then the following instructions will need to be performed for both.

The package of WebSphere is KCH.zip while for Tomcat it's KCD.zip. Unzip the one which you wish to install and run the following script for TEPS (ensure TEMS and TEPS are started):

installIraAgentTEPS.(bat || sh) (eg. C:\IBM\ITM)

and for TEMS:

installIraAgentTEMS.(bat || sh) (eg. C:\IBM\ITM)

Installing agent

On each machine (clmjts.jazz.net) with an application server hosting the CLM applications you wish to monitor, ensure that an ITM OS Agent is installed on the machine and then run the following script from the package corresponding to the application server type:

installIraAgent.(bat || sh) (eg. C:\IBM\ITM)

Once the agent is installed it needs to be configured.

We will follow the graphical setup of the agent, there is also a possibility to run the configuration from the command like. Please follow the Tivoli documentation on how to do this and substitute the same values as specified in the ITM manager GUI instructions.

Run the “Manage Tivoli Monitoring Service” either from Programs on Windows or “itcmd manage” command on Unix. (Make sure to launch as administrator on windows)

Right click on the newly installed template and navigate to Advanced->Configure Advanced...

When configuring the agent, ensure to follow the general configuration information regarding the default configuration settings for the agents.

Configuring the Monitoring Agent for CLM Server Monitoring for WebSphere Application Server (KCH)

It is possible to create an instance of the agent for each application server on the machine. We will configure one for the WebSphere Application Server hosted locally. To do this double click on the template entry for the agent.

Assign a name to the new instance. Put name of websphere server being monitored here.

In the Java configuration window, use the jdk included with the WebSphere Application Server:

eg. C:\Program Files\IBM\WebSphere\AppServer\java

In the JVM Arguments, allocate a maximum of 1G to the agent. -Xmx1024

Click next.

In the WebSphere Application Server Configuration window, enter the parameters used in the JConsole connection script from the previous section.

Ensure that the WAS base paths include the WebSphere Application server directory. Also ensure that the WAS class path has the correct versin of the var for the version of WebSphere Application Server begin used (look for the version of the file in . For example:

runtimes/com.ibm.ws.admin.client_8.0.0.jar;plugins/com.ibm.ws.security.crypto.jar

Click next.

Add a monitored Application for each domain found in the Mbeans tab of Jconsole. (ie. team.server.*). The name of the monitored application should be something recognizable for the application being monitored.

Configuring the Monitoring Agent for CLM Server Monitoring (KCD)

It is possible to create an instance of the agent for each application server on the machine. We will configure one for the a Tomcat instance hosted locally. To do this double click on the template entry for the agent.

Assign a name to the new instance. Put name of the server being monitored here.

In the Java configuration window, use the jdk used by the tomcat server:

In the JVM Arguments, allocate a maximum of 1G to the agent. -Xmx1024

Click next.

In the “JSR-160-Compliant Server” Configuration window, enter the parameters used when connecting using JConsole om the previous section. (Include any paths or jars required for a secure connection)

Click next. Add a monitored Application for each domain found in the Mbeans tab of Jconsole. (ie. team.server.*). The name of the monitored application should be something recognizable for the application being monitored.

Related topics: Deployment web home, Deployment web home

External links:

• IBM

Additional contributors: TWikiUser, TWikiUser