Installation d'Automation Engine

Installation d'Automation Engine

Installation d'Automation Engine pour Windows

---

Installation de Automation Engine pour UNIX

Vous trouverez ici des indications pour la nouvelle installation de Automation Engine pour UNIX.

Automation Engine pour UNIX est disponible pour diverses plateformes; a three-figure code is supplied for each supported UNIX platform. The codes are the same as for agents and are described in the terminology. In this document, the specific code is replaced by the characters "???." This document describes the installation of the Automation Engine for Oracle and DB2 databases. Specific differences are described in the individual processing steps.

Automic strongly recommends installing the Automation Engine in a separate directory (such as /opt/uc4/server).

Prérequis

Généralités :

• Autorisation root pendant l'installation. Pas nécessaire au fonctionnement de Automation Engine.
• Après l'installation, un réamorçage du système UNIX n'est pas nécessaire.
• Identification utilisateur UNIX individuelle pour Automation Engine(Par défaut : uc4, Home : /opt/uc4, Shell: ksh). Le shell n'est nécessaire que pendant l'installation.
• Particularité de Solaris : grappe de correctifs la plus récente pour Sun OS.
• Attention : le fichier syntax.bin doit se impérativement se trouver dans le même répertoire que le fichier INI !
•  Tenez toujours compte des conseils sur les processus sur l'AIX !
•  Attention, sur AIX, la taille des fichiers centraux doit être étendue !

Conditions pour l'utilisation d'une base de données Oracle :

• Installation Oracle en état de marche (l'accès sqlplus à la base de données doit être possible).
• ID utilisateur pour la base de données Oracle.

Conditions pour l'utilisation d'une base de données DB2 :

• Installation DB2 en état de marche.
• ID utilisateur pour la base de données DB2.
• Contrôle et attribution d'autorisations :
  exécutez le centre de commande et sélectionnez le bon hôte. Sélectionnez la base de données pour AE et cliquez sur "Objets utilisateur et groupe". Lorsque vous sélectionnez "Utilisateur", la fenêtre de droite affiche tous les utilisateurs. Utilisez le menu contextuel pour ouvrir la fenêtre des autorisations de l'utilisateur sélectionné.
  Dans l'onglet Base de données, les options suivantes doivent être activées :
• Connecter à la base de données
• Créer des tables
• Créer des paquets
• Créer des schémas implicites.
• La variable LANG de l'utilisateur qui a démarré Automation Engine doit être identique à la variable DB2CODEPAGE afin d'éviter tout problème lors du démarrage du serveur.

Fichiers fournis

Les fichiers de Automation Engine pour UNIX sont fournis compressés dans des fichiers tar. Vous trouverez le fichier tar en question dans un sous-répertoire conforme à la plateforme UNIX de IMAGE:AUTOMATIONENGINE\UNIX\.
UCS???.tar.gz (Fichiers de Automation Engine).

Déroulement

	1.	Installation de Automation Engine

• Serveur lors d'une utilisation d'une base de données Oracle
• Se connecter en tant que AE.
• Créez le répertoire /opt/uc4/server.
• Transférez via FTP binaire le fichier ucs???.tar.gz du répertoire /cdrom/cdrom0/<version>/AutomationEngine/unix/<plateforme> dans le répertoire créé.
• Décompressez le fichier tar :
  gzip -d ucs???.tar.gz
  gunzip ucs???.tar.gz
  tar xvf ucs???.tar
•  Si le Automation Engine ne s'exécute pas sur le même ordinateur que les utilitaires, vous devez définir les Variables d'environnement dans $HOME/.profile. Un exemple est fourni dans les instructions d'installation des utilitaires.
• Renommez le fichier ucsrv.ori.ini en ucsrv.ini :
  mv ucsrv.ori.ini ucsrv.ini
• Adaptez le fichier INI ucsrv.ini à l'environnement système. Dans la liste suivante, vous voyez les éléments du fichier INI qu'il faut de toute façon adapter. Tous les autres paramètres peuvent être configurés selon vos besoins.
• Nom du système AE (system= )
• Jusqu'à présent, l'activation utilise la connexion SNMP (snmp= ).
• Numéro de port du processus de travail primaire (pwpport= )
• Attribution de processus de communication et de numéros de port (cp1= ... cpn= )
• Attribution de processus de travail et de numéros de port (wp1= ... wpn= )
• connexion à la base de données (SQLDRIVERCONNECT= )
• Ejection du CD AE :
  umount /cdrom oueject cdrom
• Contrôle des bibliothèques :
  Pour AIX :
  

• Vérifier la bibliothèque Oracle libclntst9.a (voir Paramétrer une base de données Oracle).
• Espace après "dump"
  dump -H ucsrvcp > wk.txt
• Ouvrez le fichier ainsi créé avec un éditeur de texte (sed ou vi). Contrôlez que toutes les bibliothèques ont été trouvées.
• Répétez le processus ci-dessus avec ucuoci.a et ucsrvwp. Dans le fichier ucuoci.a, plusieurs entrées manquantes s'affichent étant donné qu'il ne s'agit pas d'un programme principal, mais d'une bibliothèque. Si les messages se réfèrent aux bibliothèques ucuoci.a, libzu00132.a et libucudb32.a, ils peuvent être ignorés. Si une entrée n'est pas trouvée dans une autre bibliothèque (Oracle, etc.), c'est qu'il s'agit d'une erreur.

Pour HP-UX :

• Contrôlez la bibliothèque libclntsh.so.9.0 (voir Paramétrer une base de données Oracle).
• Contrôle de la bibliothèque :
  ldd -r ucsrvcp > wk.txt
  L'option -s peut remplacer -r pour ldd.
• Ouvrez le fichier ainsi créé avec un éditeur de texte (sed ou vi). Contrôlez que toutes les bibliothèques ont été trouvées.
• Répétez le processus ci-dessus avec ucuoci.sl et ucsrvwp. Dans le fichier ucuoci.sl, plusieurs entrées manquantes s'affichent étant donné qu'il ne s'agit pas d'un programme principal, mais d'une bibliothèque. Cela ne fait rien tant qu'il s'agit des bibliothèques ucuoci.sl, libzu00132.sl et libucudb32.sl. Si une entrée n'est pas trouvée dans une autre bibliothèque (Oracle, etc.), c'est qu'il s'agit d'une erreur.

Pour Linux, Solaris et zLinux :

• Contrôlez la bibliothèque Oracle libclntsh.so.9.0 (voir Paramétrer une base de données Oracle).
• Contrôle de la bibliothèque :
  ldd -r ucsrvcp > wk.txt
  L'option -s peut remplacer -r pour ldd.
• Ouvrez le fichier ainsi créé avec un éditeur de texte (sed ou vi). Contrôlez que toutes les bibliothèques ont été trouvées.
• Répétez le processus ci-dessus avec ucuoci.so et ucsrvwp. Dans le fichier ucuoci.so, plusieurs entrées manquantes s'affichent étant donné qu'il ne s'agit pas d'un programme principal, mais d'une bibliothèque. Cela ne fait rien tant qu'il s'agit des bibliothèques ucuoci.so, libzu00132.so et libucudb32.so. Si une entrée n'est pas trouvée dans une autre bibliothèque (Oracle, etc.), c'est qu'il s'agit d'une erreur.

• Serveur lors de l'utilisation d'une base de données DB2
• Se connecter en tant que AE.
• Créez le répertoire /opt/uc4/server.
• Transférez via FTP binaire le fichier ucs???.tar.gz du répertoire /cdrom/cdrom0/<version>/AutomationEngine/unix/<plateforme> dans le répertoire créé.
• Décompressez le fichier tar :
  gzip -d ucs???.tar.gz
  gunzip ucs???.tar.gz
  tar xvf ucs???.tar
• Si le Automation Engine ne s'exécute pas sur le même ordinateur que les utilitaires, vous devez définir les Variables d'environnement dans $HOME/.profile. Un exemple est fourni dans les instructions d'installation des utilitaires.
• Renommez le fichier ucsrv.ori.ini en ucsrv.ini :
  mv ucsrv.ori.ini ucsrv.ini
• Adaptez le fichier INI ucsrv.ini à l'environnement système. Dans la liste suivante, vous voyez les éléments du fichier INI qu'il faut de toute façon adapter. Tous les autres paramètres peuvent être configurés selon vos besoins.
• Nom du système AE (system= )
• Jusqu'à présent, l'activation utilise la connexion SNMP (snmp= ).
• Numéro de port du processus de travail primaire (pwpport= )
• Attribution de processus de communication et de numéros de port (cp1= ... cpn= )
• Attribution de processus de travail et de numéros de port (wp1= ... wpn= )
• connexion à la base de données (SQLDRIVERCONNECT= )
• Ejection du CD AE :
  umount /cdrom ou eject cdrom
• Contrôle de la bibliothèque DB2 :

AIX:

• AE utilise $DB2DIR/lib/libdb2.a
• Contrôle de la bibliothèque :
  dump -H ucsrvcp > wk.txt
• Ouvrez le fichier ainsi créé avec un éditeur de texte (sed ou vi). Contrôlez que toutes les bibliothèques ont été trouvées.
• Répétez le processus ci-dessus avec ucucli.sl et ucsrvwp. Dans le fichier ucucli.sl, plusieurs entrées manquantes s'affichent étant donné qu'il ne s'agit pas d'un programme principal, mais d'une bibliothèque. Si les messages se réfèrent aux bibliothèques libzu00132.a, ou libucudb32.a, ils peuvent être ignorés. Si une entrée n'est pas trouvée dans une autre bibliothèque (DB2, etc.), c'est qu'il s'agit d'une erreur.

HP-UX:

• AE utilise $DB2DIR/lib/libdb2.sl.
• Contrôle de la bibliothèque :
  ldd -r ucsrvcp > wk.txt
  L'option -s peut remplacer -r pour ldd
• Ouvrez le fichier ainsi créé avec un éditeur de texte (sed ou vi). Contrôlez que toutes les bibliothèques ont été trouvées.
• Répétez le processus ci-dessus avec ucucli.sl et ucsrvwp. Dans le fichier ucucli.sl, plusieurs entrées manquantes s'affichent étant donné qu'il ne s'agit pas d'un programme principal, mais d'une bibliothèque. Cela ne fait rien tant qu'il s'agit des bibliothèques ucucli.sl, libzu00132.sl et libucudb32.sl. Si une entrée n'est pas trouvée dans une autre bibliothèque (DB2, etc.), c'est qu'il s'agit d'une erreur.

Linux, Solaris and zLinux:

• AE uses $DB2DIR/lib/libdb2.so.
• Library check:
  ldd -r ucsrvcp > wk.txt
  The option -s can be used instead of -r for ldd
• Open the created file with a text editor (sed or vi). Verify that all libraries were found.
• Repeat the above procedure with ucucli.so and ucsrvwp. Some missing entries might be reported that refer to the file ucuoci.so, because it is a library instead of a main program. If these messages refer to the libraries ucucli.so, libzu00132.so, or libucudb32.so, they can be disregarded. If an entry cannot be found in a different library (DB2, for example), this is an error.

	2.	Installation du sous-agent SNMP AE (facultatif)

• Ordinateur serveur
• Installez le Sous-Agent SNMP AE si vous avez l'intention d'utiliser ses fonctions.

	3.	Démarrer le Automation Engine

Automation Engine peut être démarré manuellement pour un test.

• Ordinateur serveur
• Connectez-vous à l'aide de l'ID utilisateur AE.
• Dans le répertoire d'installation, changez de programme exécutable :
  cd $UC4/bin
• Démarrez le processus de communication en arrière-plan :
  ./ucsrvcp &
• Démarrez le processus de travail en arrière-plan :
  ./ucsrvwp &
• Contrôlez queAutomation Engine est exécuté :
  ps -ef|grep ucsrv ou ps -fu uc4
• Il doit maintenant être possible de se connecter à Automation Engine à l'aide d'une interface utilisateur. Il est possible d'afficher les informations concernantAutomation Engine en cours d'exécution dans la Supervision Système.

	4.	Fermeture de Automation Engine

• Ordinateur serveur

Arrêt normal :
• Recherchez l'ID de processus pid :
  ps -ef|grep ucsrv
• Mettez fin au processus serveur :
  kill -TERM pid

Interruption :
• Recherchez l'ID de processus pid :
• Arrêtez le processus serveur :
  kill -KILL pid

Utilisez le gestionnaire de services pour démarrer et arrêter les processus serveur.

Problèmes possibles

Lors du démarrage du programme :

• Automation Engine est arrêté au démarrage :
  activez les fichiers Traces (notamment le fichier Trace de la base de données).

Les librairies partagées manquantes ou les autres erreurs sont plus aisément identifiées en démarrant Automation Engine à l'aide de :
truss 2>truss.out -f ucsrvcp.
Le fichier truss.out généré comporte toutes les exécutions système du Automation Engine, ainsi que toutes les tentatives de chargement des objets partagés.

Si une bibliothèque manque, il est possible qu'elle existe dans le système, mais que le chemin ne soit pas entré dans la Variable d'environnement (LIBPATH, SHLIB_PATH ou LD_LIBRARY_PATH). Recherchez la bibliothèque sous root à l'aide de la commande
find / -name 'library' -print
(caractères génériques autorisés).
Ajoutez le chemin trouvé dans la Variable d'environnement. Si la bibliothèque n'a pas été trouvée, c'est qu'elle n'est pas installée sur ce système ou qu'elle a été supprimée. Recherchez la bibliothèque à contrôler si elle est accessible :

Sous AIX, Linux, Solaris et zLinux : /var/sadm/install/contents Sous HP-UX :
/var/adm/sw/ sw install.log et /var/adm/sw/ sw remove.log

• Si elle ne s'y trouve pas, c'est qu'elle a été supprimée. Le nom du package dans lequel se trouve les bibliothèques se trouve à la fin de la ligne en question. En l'occurrence, il est recommandé de réinstaller le package.
• Automation Engine plante et/ou ne semble par réagir.
  
  truss -f -p pid 2>&1 | tee -a truss.out
  permet de suivre les processus en cours d'exécution sur le système.
• Supprimez les <CR> (^M) des fichiers texte :
  vi Fichier texte
  %s/<Strg-V><Strg-M>$//g
  :wq!

See also:

Number of Server Processes
Installing the AE SNMP Subagent (UNIX)