Installing the Agent for Java EE/JMX (IBM WebSphere) with RMI Connector

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 (IBM WebSphere) with RMI Connector

1. Set up the JMX Agent (host).

   • Select the menu item Applications -> Install New Application on the WebSphere interface.
   • Specify the path to ucxjjmx.war in "Local File System." "Context root" can be used to name the application.
   • The next window can be used to activate the option Generate Default Bindings." If required, other settings can also be specified.
   • Follow the installation procedure as described. In step 4, select the option Everyone? next to "administrators."
   • When all six steps are complete, complete the installation procedure by clicking FINISH. Refer to the log to verify that the installation was successful. Click "Save to Master Configuration", and then Click Save.
   • Click Applications -> Enterprise Applications. The list now also includes the agent. Activate it by clicking the button of the same name.  
   • The agent can be started via the configuration WebInterface.

2. Use the configuration WebInterface (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.

   • Adjust the settings of the JMX agent to your system environment. The most important settings are:
   • Name for the agent
   • Name of the computer on which a communication process is available
   • 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.

3. Important notes for creating jobs (host).

   • "Remote Java VM" must be selected in the Job object's JMX tab.
   • Enter the term "websphere" in the field Initial Context Factory .
   • Specify the Server URL in the following format:

   Host name of the WebSphere:port of BOOTSTRAP_ADDRESS

   Retrieve the port number as follows: Log on to the administrator console. Click "Servers" -> "Applications servers", and then click the name of your server. Select "Communications" -> "Ports." The table contains the entry BOOTSTRAP_ADDRESS. Use the port number shown in the URL.