Installing the Agent for Java EE/JMX (Tomcat)

The following guide describes how to install an agent in an AE system in which authentication is not used. Additional installation steps are required before the agent can be started and used if you intend to use one of the available authentication methods. For more information, see Agent Authentication.

Installing the Agent for Java EE/JMX (Tomcat)

1. Set up the JMX agent.

   • Host
   • Start Tomcat and call the Tomcat Web Application Manager.
   • Select the file ucxjjmx.war in the "Install - load local WAR file for installation." section. The installation can then be started using the button of the same name.
   • Note that the role "administrators" must exist. Adjust the file tomcat-users.xml if it does not yet exist. Enter the role and add it to a user.

   Example:

   <role rolename="administrators"/>
   
   <user username="admin" password="" roles="admin,manager,administrators"/>

   Restart Tomcat to apply the roles.

   • The JMX agent is displayed in the applications section of the Web Application Manager.

2. Use the web configuration interface.

   • Host

   • The JMX agent has a configuration web interface that can be called with a Web browser using the following address:

     http://Server name:port/context root

     For more information, see Web Configuration Interface for the Java EE/JMX Agent.

   • Use this interface to adjust the JMX agent to your system environment. It is particularly important to configure the following:
   • The agent name
   • The name of the computer on which a communication process is available
   • The port number of a communication process

   Note: the configuration file will be overwritten when you deploy the WAR file again. As a result you will have to redefine your configuration settings. Instead, you can also save a copy of your configuration file (INI file) before you start the deployment and copy it to the folder that includes the web application after the deployment has taken place.