Manuel d'administration > Installation > Nouvelle installation > 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).

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 RA se trouvent dans le répertoire IMAGE:AGENTS\RAPIDAUTOMATION.

Nom de fichier	Description
ucxjcitx.jar	Agent pour Rapid Automation
ucxjcitx.ini	Fichier de configuration
*.jar	Bibliothèque
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 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 sera 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.
Après avoir chargé la solution RA, vous devez redémarrer l'interface utilisateur.
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. L'agent RA en aura besoin 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.
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 disable_cache

Si vous chargez la solution RA, puis démarrer l'agent immédiatement après, vous pourriez obtenir un agent en cache et non pas celui que vous avez chargé. Vous pouvez éviter ceci en ajoutant disable_cache à la fin de la commande de démarrage. La version chargée est ainsi toujours démarrée.

Vous pouvez aussi démarrer l'agent via 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.

	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.