Manuel d'administration > Installation > Service Pack et installation de correctif > Installation de l'Agent pour Rapid Automation

Configurer un Agent pour Rapid Automation

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/Agent/rapidautomation or C:\AUTOMIC\Agent\rapidautomation).

Fichiers fournis

Les fichiers de l'agent RA se trouvent dans le répertoire IMAGE:AGENTS\RAPIDAUTOMATION.

Nom de fichier	Description
SETUP.EXE	L'objet exécutable de l'installation de Windows pour le centre des Agents RA.
uc.msl	Bibliothèque de messages
ucxjcitx.jar	Agent pour Rapid Automation
ucxjcitx.ini	Fichier de configuration
*.jar	Bibliothèques

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 distinct pour l'agent RA et copiez y les fichiers fournis. Sous Windows, il est également possible d'exécuter l'installation avec le programme SETUP.EXE que vous trouverez dans le répertoire IMAGE:AGENTS\RAPIDAUTOMATION\WINDOWS.
La solution RA utilisée par l'agent est sauvegardée dans un dossier nommé "cache". Créez ce dossier dans le répertoire d'installation.
Plusieurs paramètres permettent d'adapter l'agent RA possède à 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. Adaptez le fichier INI.

	3.	Chargement de la Solution RA

Hôte

Démarrez l'utilitaire AE.DB Load et sélectionnez le fichier JAR de la Solution RA. L'utilitaire le charge dans la base de données AE. Le fichier JAR peut être chargé via l'interface graphique ou le mode batch Java (ucybdbld.jar) de l'AE.DB Load. Il est impossible de charger le mode batch (ucybdbld.exe) de l'AE DB Load sous Windows.
Un Agent RA ne peut se connecter qu'à une seule Solution RA. Si vous désirez faire l'usage de plusieurs Solutions RA, chacune doit disposer de son propre Agent RA.
Attention : il est impossible de charger le même fichier JAR d'une solution RA simultanément dans plusieurs systèmes ! Toute tentative de le faire peut entraîner l'interruption de l'AE DB Load.

	4.	Création des objets de connexion

Hôte
Connectez-vous au Client système 0000.
Selon la Solution RA, un ou plusieurs modèles d'objet Connexion nécessaires ont été créés lors du chargement et sauvegardés dans le dossier "TEMPLATE". Créez le ou les objets de connexion nécessaires et complétez les champs de leurs onglets qui seront nécessaires à l'agent RA par la suite.

	5.	Démarrer l'agent

Hôte
L'agent RA ne démarre que si un objet agent du même nom existe dans le client système 0000. Cette règle est indépendante de la méthode d'authentification.
Lors du chargement de la Solution RA, un modèle de l'objet Agent à utiliser a été créé et sauvegardé dans le dossier "TEMPLATE". Créez dans le dossier "HOST" un objet Agent et complétez les champs de son onglet.
Utilisez la commande suivante pour démarrer l'agent via la ligne de commande (UNIX et Windows) :

java -jar -Xrs -Xmx256M ucxjcitx.jar

Il peut être aussi démarré avec le ServiceManager.
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.

	6.	Remarques importantes sur la création de Jobs

Hôte
Le chargement de la Solution RA a entraîné la création dans le dossier "TEMPLATE" d'un ou de plusieurs modèles d'objet Job. Utilisez-les pour créer des Jobs pour la Solution RA.
Les Jobs RA ne contiennent pas d'objet Login. Les données de connexion seront stockées lors de l'installation dans un ou plusieurs objets Connexion. Choisissez ces objets Agent.