Installation de l'Agent pour Siebel (Windows)

Installation des Agents

Installation de l'Agent pour VMS

---

Installation de l'agent pour UNIX

Ce document décrit la nouvelle installation d'un agent UNIX.

Un code à trois caractères a été attribué à chaque variante UNIX supportée. Ce code apparait dans tous les noms de fichiers de l'agent et est décrit dans la terminologie. Dans ce document, ce code est remplacé par les caractères "???".

Plateformes UNIX 64 bit : Automic recommande d'utiliser un agent 64 bits afin de démarrer des programmes et des applications 64 bits. Des problèmes peuvent se produire lorsque vous utilisez un agent 32 bits à cet effet.

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écurité avancée dans ce document.

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

Automic recommande d'exécuter l'agent UNIX avec les droits root. Sans droits root, l'agent ne peut pas acquérir le contexte d'un autre utilisateur et les jobs et transferts de fichiers doivent toujours être exécutés sous l'utilisateur sous lequel l'agent a démarré.
Vous pouvez définir les droits appropriés pour l'agent en le démarrant sous le vrai utilisateur "root". Une autre méthode consiste à définir le sbit pour l'agent et définir "root" comme propriétaire. Il en résulte que chaque utilisateur du groupe qui est attribué à l'agent peut démarrer. 

Prérequis

• L'ID utilisateur AE a été créé.
• Les répertoires "out" et "temp" nécessitent les autorisations suivantes :
  
  Pour le propriétaire : droit d'écriture et d'exécution
  Pour le groupe : droit d'exécution
  Pour les autres : droit d'exécution

  Notez que les autorisations ne doivent pas être modifiées lorsque l'agent est en cours d'exécution.

  Lorsqu'une connexion est spécifiée dans l'élément de script PREP_PROCESS, le fichier d'événement est créé dans le répertoire HOME de l'utilisateur pour des raisons de sécurité. Si aucun Login n'est spécifié, le système suppose que le job de l'événement suivant fonctionne avec des droits de l'agent. Ainsi, PREP_PROCESS crée le nom du fichier avec le chemin temporaire de l'agent.
  Au moment où PREP_PROCESS est traité, le système ne sait pas si le job utilisera une connexion ou non. D'un point de vue technique, cela ne peut pas actuellement être déterminé, car l'événement de job pourrait également spécifier le Login de façon dynamique (avec une instruction de script PUT_ATT). Il y a deux solutions possibles :

  1. Spécifiez un Login dans PREP_PROCESS (recommandé par Automic et solution sûre).
  2. Attribuez l'accès en lecture et en écriture au répertoire temporaire de l'agent à l'utilisateur qui est défini dans le job d'événement.

  Les autorisations pour les fichiers de rapport de job sont spécifiées en utilisant le paramètre ReportMode= du fichier INI.

• Automic recommande d'ajouter le répertoire "$HOME/bin" aux variables d'environnement PATH.

  Voir l'étape 1 : Décompresser les fichiers tar et configurer l'environnement système.

  Lisez la note sur les processus sur l'AIX.

  Notez que sur AIX, la taille pour les fichiers core doit être étendue.

Fichiers fournis

Les fichiers de l'agent UNIX sont fournis compressés :
ucxj???.tar.gz ... les fichiers de l'agent réel,
ucxb???c.tar.gz ... fichiers de CallAPI.

Chaque fichier tar est situé dans le sous-répertoire IMAGE:AGENTS\UNIX qui correspond à la variante d'UNIX.

Les fichiers de CallAPI et leur mise en œuvre sont décrits dans un document séparé.

Déroulement

	0.	Droits de l'ID utilisateur "AE"

• Hôte
• Les jobs peuvent être démarrés par la fonction "fork" ou la commande batch. Définissez dans le fichier INI de l'agent le paramètre start_type= avec la valeur correspondante. En fonction de cette configuration, les règles suivantes s'appliquent à l'agent :
• Avec "fork" : les jobs peuvent être démarrés sous n'importe quel ID utilisateurl si l'agent est démarré sous un ID utilisateur possédant les droits root. Si les droits root n'ont pas été assignés, les jobs doivent être exécutés sous l'ID utilisateur sous lequel l'agent a été démarré.
• Pour "batch" : l'agent doit être démarré sous un ID utilisateur qui possède les droits root.

	1.	Transfert des fichiers tar vers l'hôte et configuration de l'environnement système

• Hôte
• Connexion à l'aide de l'ID utilisateur AE.
• Transférez le fichier tar ucxj???.tar.gz via FTP.
• Décompression du fichier tar.
  gzip -d ucxj???.tar.gz ou gunzip ucxj???.tar.gz
  tar -xvf ucxj???.tar
  (Linux: tar -zxvf ucs???.tar.gz)
  
  Les fichiers décompréssés sont affichés. Le fichier tar peut être supprimé après la décompression.
• Parcourez les messages du tar et vérifiez que tous les fichiers ont bien été décompressés.
• Vérifiez que tous les fichiers possèdent le propriétaire et le groupe qui conviennent. AE doit être propriétaire. Le groupe doit correspondre au code "AE". Seul un utilisateur privilégié, tel que root, peut effectuer ces modifications.
  chown AE * remplace les propriétaires de tous les fichiers par AE
  chgrp nom du groupe * change le groupe d'utilisateurs de tous les fichiers.
• Modifiez le fichier INI avec un éditeur, par exemple vi. Vous pouvez également éditer le fichier INI dans l'ordinateur administrateur puis le transférer via FTP. Le programme ucxj??? et le fichier INI doivent se trouver dans le même répertoire.

• Pour le fonctionnement réel, le programme ucxj??? doit posséder les droits d'un utilisateur privilégié tel que root.
• Remplacement du propriétaire par root

  chown root ucxj???

• Définition du S-Bit (Set-Userid)

  chmod 4755 ucxj???

• Ordinateur administrateur ou serveur
• Modifiez éventuellement HEADER.UNIX, TRAILER.UNIX et RESTART.UNIX. Voir : Job - Exécution

	2.	Configuration de l'authentification via PAM (facultatif)

• Hôte

• L'authentification via (Pluggable Authentication Modules) est maintenant prise en charge pour les agents des plates-formes UNIX suivantes : Solaris, Linux et AIX.

1. Installation de la bibliothèque PAM
   La bibliothèque PAM doit être installée sur votre système (dépend de la plateforme que vous utilisez).
   
   
2. Configuration de la bibliothèque PAM
   Le processus de configuration dépend de la plate-forme UNIX que vous utilisez. Typiquement, vous le traitez en utilisant les fichiers /etc/pam.d ou /etc/pam.conf
   Le nom du service est conforme avec le nom du fichier exécutable de l'agent (ucxj???).
   
   
3. Configuration l'agent
   Dans le fichier INI de l'agent UNIX , définissez le paramètre authentification= (section [MISC]) à "pam". Dans le paramètre libname= (section [PAM]), vous devez spécifier le chemin et le nom du fichier de la bibliothèque PAM :
   
   [MISC]
   authentication=pam
   
   [PAM]
   libname=/usr/lib/libpam32.o

	3.	Démarrer l'agent

• Serveur
• Le système AE doit être en cours d'exécution.
• Hôte
• Si vous démarrez l'agent pour un test dans un dialogue, notez ce qui suit :

  A partir de la version 1.20, la fermeture à l'aide de la touche SUPPR n'est possible que si le paramètre correspondant est défini dans le fichier INI. Automic déconseille de définir ce paramètre et recommande plutôt de fermer à partir d'un autre terminal avec kill -TERM.

• Démarrez l'agent en arrière-plan à partir du répertoire $HOME/bin.

  Si le répertoire $HOME/bin a été défini dans la variable d'environnement système PATH, saisissez :
  nohup ucxj??? 1> ucxj???.log 2>&1 &
  Si le répertoire "$HOME/bin" n'a pas été défini dans la variable d'environnement système PATH, saisissez :
  nohup ./ucxj??? 1> ucxj???.log 2>&1 &
  Notez de l'ID du processus affiché pid.
  Informations sur ce processus avec ps -ppid. Pas toujours disponible.
  Informations sur tous les processus UCX avec ps -ef | grep UCX.
  Informations sur tous les processus avec ps -e.
   

• Un objet agent est créé automatiquement dans le client système 0000 et il est enregistré dans le dossier HOST.
• Le répertoire de sauvegarde pour le rollback des fichiers est créé automatiquement lorsque vous démarrez l'agent. Ce répertoire est disponible pour les Jjbs et les transferts de fichiers. Vous pouvez définir le chemin du répertoire de sauvegarde dans la variable de l'agent UC_EX_PATH_BACKUP. Notez que pour l'utilisation du rollback basé sur les fichiers, vous devez disposer de l'utilisateur du système d'exploitation sous lequel les jobs liés et les transferts de fichiers sont lancés, et écrire l'accès au répertoire de sauvegarde.
• Ordinateur administrateur ou serveur
• Vérifiez que l'agent s'est connecté.
  • 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. Le nouvel agent peut maintenant être assigné aux clients avec les droits requis via l'objet agent.

Utilisez le gestionnaire de services pour démarrer ou arrêter l'agent.

	4.	Fermeture de l'agent

• Hôte
• Fermez l'agent de façon normale :

  kill-TERM pid

• En cas d'urgence, interrompez l'agent. Dans ce cas, les connexions de réseau ne sont pas fermées proprement.

  kill -KILL pid ou
  kill -9 pid