Steps to configure CA Application Performance Management (APM) to monitor the Service Desk Manager Tomcat instance

Document ID : KB000047636
Last Modified Date : 14/02/2018
Show Technical Document Details

Summary

CA Application Performance Management (APM) is a tool that can be used to monitor the health of other applications. This document provides the steps to configure APM to monitor Service Desk Manager's Apache Tomcat instance.

Instructions

1. Download the version of the APM Java Agent from the CA Download Center applicable for the version of APM being used

2. Extract the archive.  You will see another zip file within it with a name similar to "IntroscopeAgentFiles-NoInstaller*allappserver.windows.zip"  (the name will vary based on the version of the agent being used)

3. Extract "IntroscopeAgentFiles-NoInstaller*allappserver.windows.zip", which will provide a folder named "wily" 

4. Copy the extracted "wily" folder to the Service Desk Manager server (for example, to: C:\wily)

5. Edit the file C:\wily\core\config\IntroscopeAgent.tomcat.profile in a plain text editor 

6. Change the value of this property: 

introscope.agent.enterprisemanager.transport.tcp.host.DEFAULT=localhost 

Alter the value "localhost" to the IP address of Wily MOM Server and save the file.

7. Browse to the Service Desk Manager installation folder (NX_ROOT) and edit the NX.ENV file in a plain text editor. Find the value "@NX_JAVA_OPTIONS".  It should look similar, but may vary, to this:

@NX_JAVA_OPTIONS=-Djava.net.preferIPv4Stack=false -Xms64M -Xmx512M 

Change this parameter to include the Java Agent options. For example:

@NX_JAVA_OPTIONS=-Djava.net.preferIPv4Stack=false -javaagent:C:/CA/APM/wily/Agent.jar -Dcom.wily.introscope.agentProfile=C:/CA/APM/wily/core/config/IntroscopeAgent.tomcat.profile -Xms64M -Xmx512M 

NOTE: A back slash is considered as an escape character, hence use forward slash for path of the files. The Java Agent arguments must be placed before the heap size parameters (-Xms -Xmx) or they will be ignored by the Service Desk process that parses this configuration file. 

8. Save the NX.ENV file 

9. Restart the Service Desk Manager service for the changes to take effect

Additional Information

General information on APM:

http://www.ca.com/us/services-support/ca-support/ca-support-online/support-by-product/ca-application-performance-management.html