Manuel d'administration > Installation > Nouvelle installation > Configuration de l'Agent pour Java EE/JMX

Configuration de l'agent pour J2EE/JMX

L'agent JMX peut également s'exécuter en dehors d'un serveur d'application. Ces instructions d'installation décrivent les étapes nécessaires.

Les instructions suivantes décrivent l'installation de l'agent dans un système AE sans procédure d'authentification. Si vous désirez utiliser une méthode d'authentification, vous devez effectuer certaines opérations supplémentaires avant de démarrer et d'utiliser l'agent. Vous trouverez plus d'informations sur la Sécurisation avancée dans ce document.

Automic recommande d'installer l'agent dans un répertoire distinct (par exemple UC4/agents/jmx ou C:\AUTOMIC\Agent\jmx).

Attention : avant l'installation, assurez-vous que les Agents Java ne peuvent se connecter aux ports CP que jusqu'à un maximum de 65 535. Pour des numéros de ports plus élevés, l'agent nepeut pas démarrer et est interrompu avec un message d'erreur. Cette limitation est conditionnée par Java et concerne les Agents pour JMX, les bases de données, SAP et RA.

Fichiers fournis

Les fichiers de l'agent J2EE/JMX se trouvent dans le répertoire IMAGE:AGENTS\JMX.

Nom de fichier	Description
ucxjjmx.jar	Agent pour J2EE/JMX
ucxjjmx.ini	Fichier de configuration
uc.msl	Bibliothèque de messages
setup.exe	Programme d'installation

Déroulement

	1.	Installation de Java Standard Edition

Si Java Standard Edition est déjà installé dans la version nécessaire, vous pouvez passer cette étape de l'installation.

Ordinateur administrateur et/ou ordinateur utilisateur
Vérifiez la version de la machine virtuelle Java (VM) du système à l'aide de la commande suivante :

java -version

Si plusieurs versions de JRE ou de Java SDK sont installées sur l'ordinateur, l'ordre des répertoires donnés est important. Faites-y attention lorsque vous paramétrez %PATH% et $PATH. L'environnement Java Runtime à utiliser est le premier trouvé dans la liste des répertoires.

Téléchargez le Java Runtime Environment nécessaire depuis le site http://java.sun.com et installez-le.

	2.	Configuration de l'agent

Hôte
Créez un dossier séparé pour l'agent JMX et copiez-y les fichiers fournis ainsi que le sous-dossier "Logs". Il est également possible d'exécuter l'installation avec le programme SETUP.EXE que vous trouverez dans le répertoire fourni de l'agent.
Plusieurs paramètres sont disponibles pour adapter l'agent JMX à votre environnement système. Le nom de l'agent, le nom de l'ordinateur ainsi que le port du processus de communication auquel l'agent doit se connecter sont à noter. Configuration ces paramètres à l'aide du fichier INI de l'agent.

	3.	Démarrer l'agent

Utilisez la commande suivante pour démarrer l'agent à partir de la ligne de commande (UNIX et Windows) :

java -jar -Xrs -Xmx256M ucxjjmx.jar

L'agent peut également être démarré avec le gestionnaire de services.

Notez que la limite de stockage doit être définie au minimum à 256 Mo (ou 512 Mo) pour démarrer les agents Java (bases de données, RA, JMX, SAP). Vous pouvez spécifier la valeur limiter de stockage des applications Java en utilisant le paramètre de démarrage -XmX. Spécifier une valeur trop faible peut entraîner un blocage de l'agent. La valeur par défaut dépend de la version Java utilisée.

Le paramètre Java -Xrs permet de garantir l'arrêt correct de l'agent si une fin normale est demandée. Automic recommande d'utiliser ce paramètre. Vous trouverez plus d'informations à ce sujet dans la documentation de Java.

	4.	Remarques importantes sur la création de Jobs

Hôte
Dans l'onglet JMX de l'objet Job, sélectionnez l'option "Java VM locale".
Les sous-points "Utiliser les serveurs MBean existants" et "Créer nouvelle instance..." doivent être activés.