Manuel d'administration > Installation > Service Pack et installation de correctif > Installation de l'Agent pour NSK

Installation de l'agent pour NSK

Ce document décrit la procédure d'installation du correctif pour l'agent NSK.

Pour chaque version NSK prise en charge, un code à trois caractères a été attribué. Ce code est utilisé dans le nom du fichier de l'agent et est décrit dans la terminologie (NS1 pour NSK à partir de la version D40).

Conditions

Le protocole de réseau TCP/IP est disponible.
Un ID utilisateur a été créé pour l'installation.
Entrée #set #informat tacl dans le fichier TACLCSTM pour chaque Utilisateur qui exécute des Jobs dans AE.
OSS et NetBatch doivent être correctement installés pour que vous puissiez les utiliser pour exécuter des Jobs.
Attention: l'agent doit fonctionner sous l'utilisateur SUPER.SUPER pour éviter tout problème en cas d'interruption des processus.

Fichiers fournis

Les fichiers sont compressés dans un fichier d'archive et sont stockés dans le répertoire IMAGE:AGENTS\NSK.

Nom du fichier	Type de fichier	Description
UC4DDL	Texte	Description DDL pour utilisation dans les événements EMS, pour filtrer les événements liés à Automic.
UC4MACS	Texte	Des macros TACL utilisées pour le fonctionnement interne d'AE
UC4TMPL	Texte	Le fichier de modèle EMS à utiliser avec EMS, si requis.
UCMSL	Binaire	Les textes des messages utilisés par l'agent.
UCXBNI6C	Binaire, exécutable	Exemple affichant l'utilisation de l'API d'appel.
UCXBNI6O	Binaire, bibliothèque	Bibliothèque de lien d'API d'appel
UCXFTSRV	Binaire, exécutable	Le programme de serveur d'Automic utilisé pour le transfert de fichier sera automatiquement arrêté et démarré par l'agent lorsque le transfert de fichier est utilisé.
UCXJNI6	Binaire, exécutable	Automic agent
UCXJNI6M	Binaire, exécutable	Automic programme used to shutdown the agent.
UCXJNI6O	Binaire, exécutable	Collecteur de sortie utilisé par l'agent.
UCXJNI6R	Binaire, exécutable	Utilisé à des fins internes seulement, n'affichera que les arguments de la ligne de commande dans un certain format.
UCXJNI6T	Binaire, exécutable	Programme de terminal virtuel, utilisé pour les pseudo-appareils d'entrée et de sortie
UCXSCAN	Binaire, exécutable	Programme d'analyse utilisé en interne par l'agent si les analyses de système de fichiers pour les modèles sont requises.
UCYBWAIT	Binaire, exécutable	Utilisé à des fins internes seulement, créera un délai.

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

Déroulement

	1.	Transfert des fichiers vers l'hôte

Ordinateur administrateur
Etablissez une connexion vers l'hôte via un client FTP et transférez les deux fichiers fournis OINSTALL et UC4AR sur le même sous-volume.
Attention: le fichier OINSTALL doit être transféré en mode texte (code 101) et le fichier UC4AR en mode binaire (code 0)!
Nous vous recommandons vivement de stocker les fichiers sur un sous-volume vide.
Le fichier UC4AR est un fichier d'archive auto-extractible qui contient tous les fichiers requis de l'agent NSK.

	2.	Lancement de la procédure d'installation

Hôte
Lancez un programme d'émulation de terminal et connectez-vous avec l'utilisateur qui doit être le propriétaire du programme.
Basculez sur le sous-volume sur lequel vous avez transféré les deux fichiers.
Tapez la commande suivante dans les lignes de saisie TACL :

O OINSTALL

Ceci décompresse le fichier INSTINI dans le sous-volume. Il doit rester sur le même volume que les autres fichiers d'installation pour la suite de la procédure !

	3.	Adaptation du fichier de configuration INSTINI

Hôte
Le fichier INSTINI que vous avez décompressé à l'étape précédente contient quelques paramètres.
Adaptez-les à votre environnement système.
Les lignes vides n'ont pas de signification particulière.
Les paramètres sont indiqués sous la forme suivante: <nom paramètre>=<valeur>
Le nom du paramètre est prédéfini et ne peut pas être modifié. La valeur correspondante dépend de votre système.
Le fichier INSTINI doit être copié sur le même sous-volume que les autres fichiers d'installation (OINSTALL, INSTALL)!
Lorsque vous spécifiez le sous-volume, nous vous recommandons vivement d'utiliser le sous-volume vide pour éviter des conflits avec d'autres programmes.

Paramètres	Description
UC4-PROGRAM-SUBVOLUME=	Sous-volume pour les fichiers exécutables de l'agent.
UC4-STATUS-STORE-SUBVOLUME=	Sous-volume pour les fichiers StatusStore des transferts de fichiers. L'agent crée automatiquement les fichiers StatusStore. Ils enregistrent les informations de reprise des transferts de fichiers actifs. Ce mécanisme permet de relancer des transferts de fichiers interrompus à partir d'une certaine position de fichier (= dernier point de reprise). Les points de reprise sont créés à intervalles réguliers (réglables à l'aide du paramètre FT_RESTART_INTERVAL dans la Variable UC_HOSTCHAR_DEFAULT). Sur les systèmes non-stop, il s'agit des 4 fichiers Enscribe pour StatusStore, qui contiennent par défaut les noms suivants: UC4SST, UC4SSD, UC4SSL, UC4SSH. Vous pouvez modifier ces noms de fichiers ultérieurement dans le fichier INI de l'agent.
UC4-STATUS-STORE-AUDITED=	Enregistre les fichiers StatusStore des transferts de fichiers comme fichiers audités (protection TMF). Valeurs autorisées : "Y" (recommandé, valeur par défaut) ou "N"
UC4-TCPIP-PROCESS=	Nom du processus TCP/IP non-stop que l'agent doit utiliser. La valeur $ZTC0 est indiquée par défaut. Si vous indiquez un autre nom de processus, l'instruction ADD DEFINE TACL requise est automatiquement ajoutée au fichier Startup Obey.
UC4-SERVER-PORT=	Numéro de port du processus de communication de Automation Engine auquel l'agent doit se connecter. Assurez-vous que tous les pare-feux concernés sont configurés pour ce port.
UC4-AGENT-PORT=	Numéro de port utilisé par l'agent pour communiquer avec d'autres agents. Ce port ne peut donc pas être utilisé par d'autres programmes.
UC4-SERVER-IP-ADDRESS=	Adresse IP ou nom de l'ordinateur de Automation Engine.
UC4-AGENT-PROCESS=	Nom du processus de l'agent.
UC4-OC-PROCESS=	Nom du processus AE Output Collector.
UC4-TSIM-PROCESS=	Nom du processus AE Terminal Simulator.
UC4-SYSTEM-NAME=	Nom logique du système AE (Automation Engine)
UC4-AGENT-NAME=	Nom logique de l'instance de l'agent. Par défaut, le nom système du serveur non-stop sans "\" est utilisé pour nommer l'agent : AE-AGENT-NAME=%NODENAME% Vous pouvez aussi étendre le nom de l'agent avec un préfixe ou un suffixe. Par exemple : AE-AGENT-NAME=UC4%NODENAME%EXE
UC4-TEMP-SUBVOLUME=	Tous les fichiers temporaires, par exemple les rapports de Jobs et les fichiers de Jobs, sont enregistrés dans ce sous-volume.

Le fichier INI de l'agent est complété avec les données indiquées ici. Vous pouvez naturellement modifier à tout moment les valeurs une fois l'installation terminée.

	4.	Poursuite de l'installation

Hôte
Tapez la commande suivante dans les lignes de saisie TACL :

RUN INSTALL
Vous êtes informés de la progression de l'installation et pouvez également interrompre l'opération à tout moment. Dans ce cas, des actions manuelles de nettoyage sont parfois nécessaires.
Une fois l'installation terminée, une connexion vers le Automation Engine est établie.

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. L'agent nouvellement installé peut être attribué aux clients avec les droits requis via l'objet agent.

	5.	Démarrage et arrêt de l'agent

Hôte
Accédez au sous-volume de l'agent et saisissez la commande suivante dans la ligne de saisie TACL :

O EXSTART
La commande suivante arrête l'agent :

O EXSTOP

Rubriques connexes :

Fichier modèle EMS