Manuel d'administration > Installation > Service Pack et installation de correctif > 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.

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

Fichiers fournis

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

Nom de fichier	Description
SETUP.EXE	Programme d'installation
uc.msl	Bibliothèque de messages
ucxbo.jar.ucc	MBean "CrystalReports"
ucxjjmx.ini	Fichier de configuration
ucxjjmx.jar	Agent pour J2EE/JMX

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 peuvent être configurés pour adapter l'agent JMX à votre environnement système. Le nom de l'agent, le nom l'ordinateur ainsi que le port du processus de communication auquel l'agent doit se connecter sont particulièrement importants ici. Configurez ces paramètres à l'aide du fichier INI de l'agent.

	3.	Configurer MBean for Business Objects XI R2 (facultatif)

AE vous permet de produire des rapports automatisés. Cette fonction est offerte par MBean "CrystalReports", offert par Automic. Nommé l’Agent pour J2EE/JMX.
Utilisez le programme UCYBCRYP.EXE pour décrypter le fichier ucxbo.jar.ucc. Il est stocké dans le dossier CD:\TOOLS\ENCRYPT du CD AE. Exécutez maintenant le programme via la ligne de commande avec les paramètres suivants :

UCYBCRYP.EXE -d -f ucxbo.jar.ucc -lFichier de licence

Le fichier de licence est fournie par le soutien UC4 (customer_number.TXT).

Vous obtenez le fichier compressé nommé ucxbo.jar. Copiez-le dans le dossier dans lequel le fichier ucxjjmx.jar est stocké.

	4.	Démarrer l'agent

Démarrez l'agent à partir de la ligne de commande (UNIX et Windows) avec la commande suivante :

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.

	5.	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.