Manuel d'administration > Installation > Nouvelle installation > Installation de l'Agent pour les Jobs et les Evènements de la base de données

Installation de l'agent pour les jobs et les événements de la base de données

Le guide suivant décrit la procédure d'installation de l'agent qui est utilisé pour exécuter des jobs et des événements de base de données.

Ces instructions d'installation s'appliquent autant à Windows qu'à Unix.

L'agent de base de données pour les jobs et les événements n'est disponible que pour un type de base de données spécifique (tel que MS SQL) et peut être défini dans le fichier INI de l'agent.Un agent séparé doit être installé pour chaque type de base de données auxquels doivent avoir accès les jobs et les événements. Les noms de la base de données et du serveur doivent être définis dans chaque objet job ou événement.

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 de toujours installer l'agent dans un répertoire distinct.

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 de base de données se trouvent dans le répertoire IMAGE:AGENTS\SQL.

Nom de fichier	Description
UCXJSQLX.JAR	Agent de base de données
UCXJSQLX.INI	Fichier d'initialisation pour l'agent de base de données
UC.MSL	Bibliothèque de messages
SETUP.EXE	Programme d'installation (Windows)

De plus, les dossiers vides temp et jdbc sont également fournis. Le premier dossier contient les fichiers log et les pilotes JDBC doivent être installés dans le second dossier.

Déroulement

	1.	Installation de Java Runtime Environment (JRE)

Si JRE 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. Le processus d'installation comprend l'installation automatique du plug-in Java pour les navigateurs Web. Vous pouvez le désactiver dans le panneau de configuration. Automation Engine n'en a pas besoin.

	2.	Installation de l'agent

Hôte
Créez un répertoire distinct pour l'agent (par exemple : C:\AUTOMIC\AGENTS\SQL\BIN or UC4/AGENTS/SQL/BIN).
Copiez le contenu de IMAGE:AGENTS\SQL dans ce répertoire. 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.

	3.	Installation du pilote JDBC

Hôte
Un pilote JDBC adapté doit être installé pour toutes les bases de données devant être utilisées par l'agent. Reportez-vous aux instructions d'installation de l'éditeur.
Créez un dossier JDBC dans le dossier BIN de l'agent de base de données. Après l'installation du pilote JDBC, copiez les fichiers dans ce dossier.

Microsoft SQL Server
Installer le pilote Microsoft JDBC pour SQL Server ou Microsoft JDBC 4.0 pour SQL Server
Copiez le fichier sqljdbc4.jar dans le dossier du répertoire JDBC après l'installation du pilote.
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.
Si l'agent est démarré sous Windows, l'utilisateur du système d'exploitation correspondant peut être utilisé pour la connexion à la base de données MS SQL (authentification Windows). Lors de l'installation du pilote JDBC, il faut également copier le fichier "sqljdbc_auth.dll" dans le répertoire BIN de l'agent de base de données. Veillez à ce que l'architecture de ce fichier corresponde à celle du JVM utilisé (p. ex. : x64).

Oracle
Installez le pilote.
Après l'installation du pilote, copiez le fichier ojdbc5.jar ou ojdbc6.jar dans le répertoire du dossier JDBC.
En raison d'une erreur de programmation dans le pilote, le pilote JDBC de la version 9.0.1 et inférieure ne peut pas être utilisé avec l'agent.
L'agent recherche les classes appropriées des fichiers jar dans le dossier JDBC. Le nom du fichier n'a alors aucune importance. Ce qui est important est d'utiliser toujours le fichier jar disponible le plus récent. Automic recommande de toujours conserver un seul fichier jar dans le dossier JDBC.

MySQL
Installez le pilote.
Après l'installation du pilote, copiez le fichier mysql-connector-java-5.0.3-bin.jar dans le dossier du répertoire JDBC.

DB2
Le pilote JDBC fait partie de l'installation de DB2 et se trouve dans le répertoire SQLLIB/java (sous Windows par exemple : C:\Program Files\IBM\SQLLIB\java)
Copiez les deux fichiers suivants dans le répertoire JDBC de l'agent :

db2jcc.jar (pilote JDBC de type 4)
db2jcc_license_cu.jar (licence de Serveur)

Le pilote JDBC peut également être téléchargé de la page d'accueil d'IBM.
Cliquez sur l'élément "DB2 Personal Developers Edition : Redistributable JDBC Type 4 Driver".

Sybase
Installez le pilote (jConnect 5.5/6.05)
Après l'installation du pilote, copiez le fichier jconn2.jar ou jconn3.jar dans le dossier du répertoire JDBC.

Informix
Installez le pilote (V3.5).
Après l'installation du pilote, copiez les fichiers ifxjdbc.jar et ifxlang.jar dans le répertoire jdbc de l'agent.
Notez que l'agent requiert des bases de données Informix avec prise en charge des transactions.
En raison de l'erreur Informix, la valeur de la Variable d'environnement DB_LOCALE doit être indiquée sur certaines versions. Si DB_LOCALE n'est pas définie correctement, l'erreur "Database locale information mismatch." survient.
Dans ce cas, définissez la valeur correspondante dans le fichier INI de l'agent section [INFORMIX] avec le paramètre db_locale= (respectez les minuscules !).
Exemple : [INFORMIX] db_locale=EN_US.CP1252

Ingres
Installez le pilote JDBC.
Après l'installation du pilote, copiez le fichier iijdbc.jar dans le répertoire JDBC de l'agent.

SAP HANA
Copiez le fichier ngdbc.jar disponible dans le répertoire d'installation du client HANA, dans le répertoire jdbc de l'agent.

	4.	Autres remarques importantes

Oracle RAC
L'agent peut également être configuré de telle sorte qu'il se connecte à une base de données Oracle dans RAC.

	5.	Configuration de l'environnement système

Hôte
Adaptez le fichier INI UCXJSQLX.INI à l'environnement système.
Si l'agent est démarré sous Windows et accède à la base de données MS SQL, l'utilisateur Windows correspondant peut être utilisé pour la connexion à la base de données. Veuillez prendre les mesures préventives suivantes :

Installez le pilote JDBC conformément aux instructions ci-dessus.
Fichier INI de l'agent : WindowsAuthentication=1
UC_HOSTCHAR_DEFAULT : ANONYMOUS_JOB = Y
Dans les jobs de la base de données, vous devez spécifier un objet Login contenant une entrée adaptée à l'agent correspondant même si vous utilisez l'authentification Windows. L'utilisateur et le mot de passe dans l'objet Login ne sont ni utilisés, ni vérifiés.

Ordinateur administrateur ou ordinateur utilisateur
Adaptez HEADER.WINDOWS, TRAILER.WINDOWS et RESTART.WINDOWS, au besoin. Voir : Job - Exécution.

	6.	Démarrer l'agent

Ordinateur serveur
Le système AE doit être en cours d'exécution.
Hôte
Démarrez l'agent avec la commande suivante :
java -jar -Xrs -Xmx256M ucxjsqlx.jar

Un objet Agent est créé automatiquement dans le client système 0000 et il est enregistré dans le dossier HOST.

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.

Ordinateur administrateur ou Serveur
Vérifiez que l'agent s'est connecté au système AE.
- Démarrez l'interface utilisateur pour le client 0000. Affichez les informations sur les Agents dans la Supervision Système. Comme un Agent nouvellement connecté n'est pas encore attribué à un Client, il est uniquement visible dans le Client 0000. L'agent nouvellement installé peut maintenant être assigné aux clients avec les droits requis à l'aide de l'objet agent.

Utilisez le gestionnaire de services pour démarrer et arrêter l'agent en tant que service.