Setting Up the Agent for Java EE/JMX (JBoss)

The following guide describes how to install an agent"Programme permettant l'exécution de Traitements sur des systèmes cible comme un ordinateur ou des solutions d'entreprise. Egalement un type d'objet distinct dans l'Automation Engine. [Anciennement appelé ""Exécuteur de tâches"".]" 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. More detailed information is provided in the document Advanced Security.

Procedure

	1.	Setting up the JMX Agent

• Host
• Copy the file ucxjjmx.war to a folder and use an appropriate program to unpack it.
• Then, in the configurationUn ensemble de composants qui constituent un système. Ceci comprend des informations relatives à la manière dont les composants sont connectés, ainsi que les paramètres appliqués. file web.xml, adjust the following two parameters:

<load-on-startup> - Ensure that the value is always set to 1. Otherwise, the agent is not loaded 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 security section (<security-role>).

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

A sample 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 web interface that can be called with a Web browser using the following address:

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

The sample address uses the string ucxjjmxbecause that is the string used in the sample folder name, before the file extension (".war"):ucxjjmx. If you chose a different name, use that name instead.

• Adjust the settings of the JMX agent to suit your system environment. The most important settings are:
• Name of 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 applicationUne application est un logiciel qui aide l'utilisateur à réaliser des tâches spécifiques. Dans un environnement ARA, voir aussi : Entité d'application. after the deployment has taken place.

	3.	Important notes for creating jobs

• Host
• Select the option "Local Java VM" in the JobTraitement sur un système cible. Egalement un type d'objet distinct dans l'Automation Engine. object's JMX tab.
• Activate the sub-menu "Use existing MB Server".
• It is not necessary to select the option "Generate new instance..."