Manuel d'administration > Installation > Service Pack et installation de correctif > Installation de l'Agent pour bases de données

Installation de l'agent pour bases de données

Le document suivant descrit l'installation des correctifs de l'agent de la base de données.

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

L'agent des bases de données peut être utilisé pour exécuter des jobs et des événements ou pour récupérer des valeurs d'objets variables dynamiques (source : SQL). La différence ici étant la configuration et le démarrage (paramètres de démarrage).

Agent de base de données pour les jobs et les événements
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) qui peut être défini dans le fichier INI de l'agent. Un agent spécifique doit être installé pour chaque type de base de données qui doit être utilisé par des jobs ou des événements. Le nom de la base de données, du serveur, etc. doit être déterminé dans l'objet événement ou Job correspondant.
Agent de base de données pour les Variables
L'agent pour les variables SQL peut accéder à tout type de base de données pris en charge. Le type doit être déterminé dans l'objet Connexionpour bases de données qui est attribué aux Variables. Ainsi, seul un Agent pour Variables doit être installé. Le nom de la base de données et les paramètres de connexion (nom du serveur, numéro de port, usw.) sont également déterminés dans l'objet Connexion de la base de données. Notez que l'agent est configuré dans le fichier INI de l'Automation Engine.
L'agent est uniquement requis pour les objets variable de source SQL. Les Variables SQLI ne nécessitent pas d'Agent.

Automic recommande de toujours installer l'agent dans un répertoire distinct.

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
SETUP.EXE	Programme d'installation (Windows)
uc.msl	Bibliothèque de messages
ucxjsqlx.ini	Fichier d'initialisation pour l'agent de base de données
ucxjsqlx.jar	Agent de base de données

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. AE 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\SQL\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
Installez le pilote.
Après l'installation du pilote, copiez le fichier sqljdbc.jar dans le dossier du répertoire JDBC.
En raison d'une erreur de programmation dans le pilote, le pilote SQL Server 2000 JDBC ne peut pas être utilisé avec l'agent.
Si l'agent est démarré sous Windows, l'utilisateur du système d'exploitation peut être utilisé pour la connexion à la base de données MS SQL (authentification Windows). Lors de l'installation du pilote JDBC, le fichier "sqljdbc_auth.dll" doit être copié dans le répertoire BIN de l'agent. 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 ojdbc14.jar dans le dossier du répertoire JDBC.
En raison d'une erreur de programmation dans le pilote, le pilote JDBC version 9.0.1 et inférieure ne peut pas être utilisé avec l'agent.

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.

EXASOL
Installez le pilote à partir de EXASOL.
Copiez le pilote JDBC exajdbc.jar dans le répertoire JDBC de l'agent.
Sélectionnez le type de la base de données dans le fichier de configuration vers EXASOL.
Définir la valeur pour
connect=60
et
retention_time=180

PostgreSQL
Installez le pilote à partir de PostgreSQL.
Copiez les le pilote JDBC exajdbc.jar dans le répertoire JDBC de l'agent (postgresql-9.3-1100.jdbc4.jar par exemple).
Sélectionnez le type de la base de données dans le fichier de configuration vers POSTGRESQL.
Définir la valeur pour
connect=60
et
retention_time=180

	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

Agent de base de données pour les jobs et les événements

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 base de données, vous devez spécifier un objet Login contenant une entrée adaptée à l'agent correspondant même su 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 Serveur
Adaptez HEADER.WINDOWS, TRAILER.WINDOWS et RESTART.WINDOWS, au besoin. Voir : Job - Exécution.

Agent de base de données pour les Variables

Ordinateur serveur
L'agent de la base de données pour les variables utilise le fichier INI de Automation Engine. Adaptez la section [DB_SERVICE] qui contient les paramètres spécifiques pour l'agent de la base de données. Le fichier INI de l'agent n'est pas nécessaire.
Créez ensuite pour chaque base de données utilisée un Objet de connexion base de données dans le système AE. Les connexions vers différents types de bases de données peuvent alors être établies.
Si l'agent est démarré sous Windows, l'utilisateur Windows peut être utilisé pour la connexion aux bases de données MS SQL. Saisissez à cet effet "IntegratedSecurity" dans l'objet de connexion de la base de données correspondant comme paramètre supplémentaire et définissez la valeur correspondante sur la valeur "vrai".

	6.	Démarrer l'agent

Ordinateur serveur
Le système AE doit être en cours d'exécution.
Hôte
Démarrez l'agent pour les jobs ou les événements :
java -jar ucxjsqlx.jar

Pour démarrer l'agent dans le mode pour les variables de base de données, spécifiez le paramètre - le service, le chemin et le nom du fichier INI du Automation Engine.
Exemple : java -jar ucxjsqlx.jar -iC:\AUTOMIC\server\bin\ucsrv.ini -service

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.