Manuel d'administration > Installation > Nouvelle installation > Installation de l'Agent pour Windows

Installation de l'Agent pour Windows

Vous trouverez ici des indications pour la nouvelle installation d'un Agent Windows.

L'Agent Windows prend en charge la version 32 bits et la version 64 bits. Des codes à trois caractères permettent de faire la distinction. Ils sont présents dans tous les noms de fichiers de l'Agent et sont également décrits dans la terminologie. Dans le présent document, le code en question est remplacé par les caractères "???".

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.

Installez toujours l'Agent dans un répertoire distinct (par exemple C:\AE\AGENTS\WINDOWS).

Fichiers fournis

Les fichiers de l'Agent de base de données se trouvent dans le répertoire IMAGE:AGENTS\WINDOWS.

Nom du fichier	Description
UCXJ???.EXE	Agent Windows
UCXJ???M.EXE	Programme de connexion pour l'Agent Windows
UCXJ???.INI	Fichier d'initialisation pour l'Agent Windows
UC.MSL	Bibliothèque de messages
UCSMTP.DLL	Bibliothèque pour la connexion e-mail via SMTP
ZU00132.DLL	Bibliothèque d'exécution pour fonctions communes
SETUP.EXE	Programme d'installation (uniquement pour Intel IA-32)

D'autres fichiers de ce sous-répertoire font partie du programme d'installation et du système d'exécution UC4. Rubrique connexe : Base de connaissances.

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

Problèmes possibles

Casse des caractères dans le nom HOST
Adresse IP avec zéros en tête

Agent Windows pour connexion e-mail du système

La connexion e-mail du système AE peut être réalisée à l'aide d'un Agent Windows. Vous trouverez des informations détaillées sur la configuration de la connexion e-mail dans la base de connaissances.

Déroulement

	1.	Installation de Microsoft Visual C++ 2010 Redistributable Package

Si le package est déjà installé dans la version nécessaire, vous pouvez passer cette étape de l'installation. Pour savoir si cette version est présente, et si oui dans quelle version, consultez Panneau de configuration -> Logiciels.

Hôte (32 bits)
Installez le package à partir du répertoire IMAGE:CRTS\WINDOWS\X86.

Hôte (64 bits)
Installez le package à partir du répertoire IMAGE:CRTS\WINDOWS\X64 ou IMAGE:CRTS\WINDOWS\IA64.

	2.	Installation de l'Agent

Hôte (32 bits)
Démarrez le programme SETUP.EXE dans le répertoire IMAGE:AGENTS\WINDOWS\X86.
Sélectionnez un répertoire distinct pour l'Agent (par exemple C:\AE\AGENTS\WINDOWS). L'installation démarre dès que vous cliquez sur le grand bouton (ordinateur, emballage et disquette).
Le groupe de programmes AE est créé automatiquement, c'est-à-dire que l'Agent est entré.

Hôte (64 bits)
Démarrez le programme SETUP.EXE dans le répertoire IMAGE:AGENTS\WINDOWS\X64 ou IMAGE:AGENTS\WINDOWS\IA64.
Sélectionnez un répertoire distinct pour l'Agent (par exemple C:\AE\AGENTS\WINDOWS). L'installation démarre dès que vous cliquez sur le grand bouton (ordinateur, emballage et disquette).
Le groupe de programmes AE est créé automatiquement, c'est-à-dire que l'Agent est entré.

	3.	Configuration de l'environnement système

Hôte
Adaptez le fichier INI UCXJ???.INI à l'environnement système.
Si vous avez défini le paramètre logon= sur la valeur "1" dans le fichier INI, l'Utilisateur avec lequel l'Agent est démarré nécessite les droits suivants :

Utilisation en tant qu'élément du système d'exploitation
Remplacement d'un jeton au niveau du processus
Connexion comme service
Connexion comme requête de batch *)
Restauration de fichiers et répertoires
Adaptation des quotas de mémoire pour un processus

*) Ce droit est uniquement nécessaire si les Jobs sont démarrés avec l'option de démarrage "Connexion comme Utilisateur Batch".

Dans Windows, exécutez pour cela la directive de sécurité locale via Panneau de configuration -> Outils d'administration. Les droits sont définis dans "Stratégies locales" sous "Attribution des droits utilisateur".

Tous les utilisateurs Windows qui doivent effectuer des Jobs avec le Type "BAT" ont besoin du droit de "lecture et exécution" sur les répertoires "bin" et "temp" de l'Agent. Sinon, un message d'erreur apparaît lors du démarrage du Job (accès interdit). Ceci est seulement nécessaire si dans le fichier INI des Agents, le paramètre LOGON=1 ou dans le UC_HOSTCHAR_* le paramètre ANONYMOUS_JOB est défini par la valeur "N".

Ordinateur administrateur ou ordinateur utilisateur
Adaptez éventuellement HEADER.WINDOWS, TRAILER.WINDOWS et RESTART.WINDOWS. Rubrique connexe : Job - Exécution.

	4.	Démarrage de l'Agent

Serveur
Le système AE doit être en cours d'exécution.
Hôte
Démarrez l'Agent à partir du groupe de programmes AE.
Un objet Agent sera alors automatiquement créé dans le Client système 0000 et sauvegardé dans le dossier "HOST".
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. Il est maintenant possible d'attribuer à l'Agent nouvellement installé les droits souhaités à l'aide de l'objet Agent du Client.

Utilisez le ServiceManager pour démarrer ou arrêter l'Agent comme service.

	5.	Fermeture de l'Agent

Hôte
Fermeture de l'Agent.
Cliquez avec le bouton droit de la souris sur l'icône de l'Agent dans la barre des Tâches. Sélectionnez la commande Quitter.

Rubriques connexes :

Configuration du débogueur pour d'éventuelles interruptions du programme