Administration Guide > Installation > Service Pack and Hotfix Installation > Setting up the Agent for Java EE/JMX (JBoss)

Setting Up the Agent for J2EE/JMX (JBoss)

The following document includes information about installing and configuring J2EE/JMX agents with a JBoss ApplicationServer.

Supplied Files

The files that belong to the J2EE/JMX agent are stored in the directory IMAGE:AGENTS\JMX.

Procedure

	1.	Setting up the JMX Agent

Host
Copy the file ucxjjmx.war to a folder and unpack it with an appropriate program.
Adjust the following two parameters in the configurationA set of constituent components that make up a system. This includes information on how the components are connected including the settings applied. file web.xml:

<load-on-startup> - Ensure that the value is always set to 1. Otherwise, the agent does not load and cannot be started.

<run-as><role-name> - Adjust this parameter if you intend to use roles. The role must then be defined (or deleted) in the section security (<security-role>).

Rename the folder in which the agent files are stored. The folder name must end with ".war".

The following is an example of an appropriate folder name: ucxjjmx.war

Move the folder to the JBoss Deploy directory. The agent is automatically deployed and the following message is displayed:

445 INFO [TomcatDeployer] deploy, ctxPath=/ucxjjmx, warUrl=file:/C:/jboss-3.2.7/server/default/deploy/ucxjjmx.war/

	2.	Using the Web configuration interface

Host
The JMX agent has a configuration WebInterface which can be called with a Web browser using the following address:

http://Server name:Port/ucxjjmx/uc4jmx

This example uses the term ucxjjmx in the address because it is also used in step one as part of the folder name (".war"). If you opted for a different name, use this name instead.

Adjust the settings of the JMX agent to your system environment. The most important ones are:

Name for the agent
Name of the computer on which a communication process is available
Port number of a communication process

Note that 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 applicationA web application is an application that is accessible over a network (Internet or intranet) and is typically coded in a programming language like Java or JavaScript, combined with a markup language like HTML. Web applications are provided on web servers and web browsers are used as GUI on client computers. after the deployment has taken place.

	3.	Important notes for creating jobs

Host
Select the option "Local Java VM" in the Job object's JMX tab.
Activate the sub-menu "Use existing MB Server."
It is not necessary to select the option "Generate new instance..."