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

Installation de l'Agent pour VMS

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

Pour chaque variante VMS prise en charge, un code à deux caractères a été attribué. Il est présent dans tous les noms de fichiers de l'Agent et est également décrit dans la terminologie. Dans le présent document, le code en question est remplacé par les caractères "??".

Dans VMS, l'entrée de commandes, l'affichage de fichiers etc. ne tiennent pas compte de la casse. Les majuscules et les minuscules peuvent être combinées de façon quelconque. Dans le présent document, nous utiliserons des majuscules. Exception : les commandes du programme FTP.EXE doivent toujours être entrées en minuscules.

L'Agent pour VMS peut être démarré automatiquement lors du démarrage du système d'exploitation. La configuration est décrite à la fin du présent document. Les fichiers de commande nécessaires UC4$STARTUP.COM et UC4$STARTUP_BAT.COM doivent être transférés dans le répertoire SYS$STARTUP. Les noms de ces fichiers de commande, correspondant aux conventions 8.3 du CD AE, peuvent être sélectionnés librement. Les noms modifiés nécessitent des adaptations dans les fichiers de commande.

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.

Conditions

L'Utilisateur "UC4" a été créé avec les privilèges "CMKRNL", "BYPASS", "SYSNAM", "SYSPRV" et "WORLD".
La file de batch SYS$BATCH doit être initialisée et en cours d'exécution. Il est également possible d'utiliser pour les Jobs de l'Automation Engine une file de batch préparée et classée en conséquence. Celle-ci doit être indiquée dans le fichier INI de l'Agent VMS en tant que paramètre de la commande VMS pour démarrer les Jobs en mode batch. Si vous travaillez avec une file de batch, celle-ci doit être initialisée et en cours d'exécution.
Pour que UC4 puisse exécuter des Jobs en mode batch, la limite des Jobs doit être définie sur un nombre supérieur à zéro.

Fichiers fournis

Vous trouverez les fichiers dans un sous-répertoire conforme à la variante VMS de IMAGE:AGENTS\VMS.

Nom du fichier	Description	Répertoire cible	Type de fichier
UCXJV??.EXE	Agent VMS	BIN	binaire
UCXJV??M.EXE	Programme de connexion	BIN	binaire
UCXE???F.EXE	Pour Evènement de fichier	BIN	binaire
UCXJV??.INI	Fichier INI	BIN	Texte
UCX.MSL	Bibliothèque de messages	BIN	Texte
UC$CRDIR.COM	Fichier de commandes qui crée des répertoires et définit les autorisations	CMD	Texte
UC$START.COM	Fichier de commandes pour démarrer l'Agent	CMD	Texte
UC_START.COM	Fichier de commandes d'aide pour démarrer l'Agent	CMD	Texte
UC$STOP.COM	Fichier de commandes pour quitter l'Agent	CMD	Texte
UC4$STARTUP.COM	Fichier de commandes (1) pour démarrer automatiquement l'Agent	SYS$STARTUP	Texte
UC4$STARTUP_BAT.COM	Fichier de commandes (2) pour démarrer automatiquement l'Agent	SYS$STARTUP	Texte

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

Particularité : nom logique pour l'Agent

Dans VMS, des Variables globales, aussi appelées noms logiques, sont souvent utilisées pour transférer des informations.

L'Agent VMS de l'Automation Engine utilise également cette Variable globale. Son nom est formé comme suit : UC4_nom du système AE_nom de l'Agent _Agent. Le nom du système AE et de l'Agent sont tirés du fichier INI. Vous pouvez cependant définir un nom logique différent. Pour ce faire, utilisez le paramètre uc4_logical= dans le fichier INI.

La Variable globale est créée automatiquement lorsque vous démarrez l'Agent et supprimée lorsque vous fermez l'Agent normalement. Le contenu des Variables est "OK" par défaut. Pour fermer l'Agent, le contenu de Variable est modifié avec le fichier de commandes UC$STOP.COM sur "TERM". L'Agent réagit dans les 20 secondes et se termine normalement.

Déroulement

	1.	Transfert du fichier de commandes vers l'hôte

Ordinateur administrateur
Transférez le fichier UC$CRDIR.COM via FTP en mode texte.

	2.	Définition des répertoires et autorisations

Hôte
Connexion à l'aide de l'ID utilisateur "UC4".
Exécutez le fichier de commandes :
$ @UC$CRDIR
Supprimez le fichier de commandes :
$DELETE UC$CRDIR.COM;*

Le fichier de commandes UC$CRDIR.COM crée tous les répertoires et autorisations nécessaires.

Répertoire Autorisations

BIN SYSTEM: RE, OWNER: RWED, GROUP: E, WORLD: E

CMD SYSTEM: RWE, OWNER: RWED, GROUP: R, WORLD: -

TEMP SYSTEM: RE, OWNER: RWED, GROUP: WE, WORLD: WE

OUT SYSTEM: RW, OWNER: RWD, GROUP: RW, WORLD: RWE

Répertoire	Autorisations
BIN	SYSTEM: RE, OWNER: RWED, GROUP: E, WORLD: E
CMD	SYSTEM: RWE, OWNER: RWED, GROUP: R, WORLD: -
TEMP	SYSTEM: RE, OWNER: RWED, GROUP: WE, WORLD: WE
OUT	SYSTEM: RW, OWNER: RWD, GROUP: RW, WORLD: RWE

	3.	Transfert d'autres fichiers vers l'hôte

Ordinateur administrateur
Le fichier de l'Agent VMS (UCXJV??.EXE), de l'Evènement de fichier (UCXE???F.EXE) ainsi que les fichiers du programme de connexion (UCXJV??M.EXE) doivent être transférés au format binaire. Tous les autres fichiers sont des fichiers texte.

	4.	Configuration de l'environnement système

Hôte
Passez du répertoire de Login au répertoire BIN :
$SET DEF [.BIN]
Modifiez le fichier INI avec un éditeur.
Passez au répertoire CMD :
$SET DEF [-.CMD]
Adaptez le fichier de commandes avec un éditeur pour quitter l'Agent UC$STOP.COM.
Vous devez adapter le nom du système AE et le nom de l'Agent pour que le nom logique de l'Agent puisse être trouvé.

Vous pouvez également modifier les deux fichiers avant le transfert sur l'ordinateur administrateur.

Si vous n'avez pas installé l'Agent dans le répertoire HOME, il faut adapter le fichier de commandes UC$START.COM. Il contient une Variable dans laquelle vous pouvez entrer le répertoire d'installation.

$ rel_dir = ""

Si vous ne modifiez pas le fichier de commandes, le répertoire HOME est utilisé par défaut pour le démarrage de l'Agent.

Les ID utilisateur sous lesquels UC4 doit exécuter les Jobs nécessitent, outre le droit TMPMBX, également le droit NETMBX dans certains cas.
Ordinateur administrateur ou ordinateur utilisateur
Adaptez éventuellement HEADER.VMS, TRAILER.VMS et RESTART.VMS. Rubrique connexe : Job - Exécution.

	5.	Démarrage de l'Agent

Serveur
Le système AE doit être en cours d'exécution.
Hôte
La connexion s'est effectuée à l'aide de l'ID utilisateur "UC4".
Exécutez le fichier de commandes du répertoire CMD :
$ @UC$START
La Tâche de l'Agent peut être identifiée par son ID processus ou son nom de processus.
Vous obtenez des informations sur la Tâche de deux façons :

Le nom de processus est formé lors du démarrage de l'Agent : UC4_ID utilisateur.
Par défaut, le nom du processus est alors UC4_UC4.
$ SHOW PROC UC4_UC4
L'ID processus s'affiche lors du démarrage de l'Agent.
$ SHOW PROC/ID=ID processus

Un objet Agent est créé automatiquement dans le Client système 0000 et il est enregistré 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.

	6.	Fermeture de l'Agent

Hôte
La connexion s'est effectuée à l'aide de l'ID utilisateur "UC4".
Fermez l'Agent normalement en exécutant le fichier de commandes dans le répertoire CMD.
$ @UC$STOP
En cas d'urgence, interrompez l'Agent. Dans ce cas, les connexions de réseau ne sont pas fermées de façon habituelle.

Interruption avec le nom de processus :
$ STOP UC4_UC4
ou
Interruption avec l'ID processus :
$ STOP PROC/ID=ID processus

Démarrage automatique de l'Agent lors du démarrage du système d'exploitation

Lors du démarrage du système d'exploitation, le fichier de commandes SYS$MANAGER:SYSTARTUP_VMS.COM est exécuté. Pour démarrer l'Agent VMS automatiquement avec VMS, le script de démarrage pour l'Agent est ajouté à la fin de ce fichier de commandes. Dans le script de démarrage, si disponible, le fichier de commandes (1) UC4$STARTUP.COM est exécuté.

Exemple de script de démarrage

$!
$ FILE = F$SEARCH("SYS$STARTUP:UC4$STARTUP.COM")
$ IF FILE .NES. ""
$ THEN
$ @SYS$STARTUP:UC4$STARTUP.COM
$ ENDIF
$!

Dans le fichier de commandes fourni (1) UC4$STARTUP.COM, les paramètres suivants doivent être adaptés à l'environnement système :

UC4_BAT - Fichier de commandes (2) UC4$STARTUP_BAT.COM.
UC4_LOG - Répertoire dans lequel les fichiers log de l'Agent sont enregistrés.
UC4_USER - ID utilisateur de l'Agent.

Le fichier de commandes (1) UC4$STARTUP.COM exécute le fichier de commandes (2) UC4$STARTUP_BAT.COM. A l'aide du fichier de commandes UC$START.COM, l'Agent VMS est alors démarré. Adaptez éventuellement le paramètre UC4_COM si le nom ou le répertoire de ce fichier de commandes fourni a été modifié.

Conseils

Le fichier de commandes (2) UC4$STARTUP_BAT.COM doit être démarré sous l'ID utilisateur de l'Agent.
La file de batch doit être initialisée et en cours d'exécution.
L'environnement et la gestion de réseau UCX doivent être en cours d'exécution.
Le fichier de commandes (2) UC4$STARTUP_BAT.COM doit avoir des privilèges WORLD-READ pour lire l'ID utilisateur de l'Agent : $ SET FILE /PRIV=(W:R) SYS$STARTUP:UC4$SUPB.COM.