Administratorhandbuch > Installation > Neu-Installation > Agent für NSK installieren

Agent für NSK installieren

Hier finden Sie eine Anleitung für die Neuinstallation eines NSK Agenten.

Die folgende Anleitung beschreibt die Installation des Agenten in einem Automation Engine System, das keine Authentifizierung einsetzt.

Wenn Sie eine der Authentifizierungsmethoden nutzen möchten, sind noch zusätzliche Schritte nötig, bevor Sie den Agenten starten und einsetzen können. Mehr Informationen finden Sie im Dokument Advanced Security.

Für jede unterstützte NSK-Version wurde ein dreistelliges Kürzel vergeben. Dieses kommt in den Dateinamen des Agenten vor und ist in der Terminologie beschrieben (NS1 für NSK ab Version D40).

Voraussetzungen

Netzwerkprotokoll TCP/IP ist verfügbar.
Eine Benutzerkennung wurde für die Installation angelegt.
Eintrag #set #informat tacl in der TACLCSTM-Datei für jeden Benutzer, der Jobs in der AE ausführt.
OSS und NetBatch müssen erfolgreich installiert sein, damit Sie diese für Jobdurchführungen nutzen können.
Beachten Sie, dass der Agent unter dem Benutzer SUPER.SUPER laufen muss, um Probleme beim Abbrechen von Prozessen zu vermeiden!

Ausgelieferte Dateien

Die Dateien sind in einer Archivdatei gepackt und befinden sich im Verzeichnis IMAGE:AGENTS\NSK.

Dateiname	Dateityp	Beschreibung
UC4DDL	Text	DLL-Beschreibung für die Verwendung in EMS-Filtern zur Filterung von für Automic relevanten Ereignissen.
UC4MACS	Text	Vom Automic Agenten verwendete Tacl-Makros können bei Bedarf vom Kunden erweitert werden.
UC4TMPL	Text	EMS Template-Datei, die zu verwenden ist, wenn EMS benötigt wird.
UCMSL	Binär	Vom Agenten verwendete Meldungstexte.
UCXBNI6C	Binär, ausführbar	Beispiel-Programm, das die Verwendung des Call API zeigt.
UCXBNI6O	Binär, Bibliothek	Aufruf API Link Library
UCXFTSRV	Binär, ausführbar	Serverprogramm von Automic für die Dateiübertragung. Wird vom Agenten bei Dateiübertragungen automatisch beendet und gestartet.
UCXJNI6	Binär, ausführbar	Automic Agent
UCXJNI6M	Binär, ausführbar	Automic Programm, das den Agenten herunterfährt.
UCXJNI6O	Binär, ausführbar	Vom Agenten verwendeter Output Collector.
UCXJNI6R	Binär, ausführbar	Wird nur für interne Zwecke genutzt. Gibt Befehlszeilenargumente für die Ausgabe in einem bestimmen Format aus.
UCXJNI6T	Binär, ausführbar	Virtuelles Terminal-Programm, das als Dummy Eingabe-/Ausgabegerät gestartet wird.
UCXSCAN	Binär, ausführbar	Scan-Programm, das intern vom Agenten genutzt wird, wenn Dateisystemscans nach Dateimustern angefordert werden.
UCYBWAIT	Binär, ausführbar	Wird nur für interne Zwecke genutzt und sorgt für eine bestimmte Verzögerung.

Die Dateien des CallAPI und deren Implementierung werden gesondert beschrieben.

Ablauf

	1.	Übertragen der Dateien zum Host

Admin-Rechner
Stellen Sie eine Verbindung zum Host über einen FTP-Client her und übertragen Sie die beiden ausgelieferten Dateien OINSTALL und UC4AR in ein gemeinsames Subvolume.
Beachten Sie dabei, dass die Datei OINSTALL im Textmodus (code 101) und UC4AR im Binärmodus (code 0) übertragen werden müssen!
Wir empfehlen ausdrücklich die Dateien in einem leeren Subvolume abzulegen!
Die Datei UC4AR ist ein selbst extrahierendes Archiv. Es enthält alle notwendigen Dateien des NSK-Agenten.

	2.	Starten der Installationsprozedur

Host
Starten Sie ein Terminal-Emulationsprogramm und melden Sie sich mit dem Benutzer an, der Programm-Owner sein soll.
Wechseln Sie in das Subvolume in das Sie die beiden Dateien übertragen haben.
Setzen Sie folgenden Befehl in der TACL-Eingabezeile ab:

O OINSTALL

Damit wird die Datei INSTINI im Subvolume entpackt. Sie muss für den weiteren Installationsvorgang im selben Subvolume wie die anderen Installationsdateien bleiben!

	3.	Anpassen der Konfigurationsdatei INSTINI

Host
Die Datei INSTINI, die im vorigen Schritt entpackt wurde, enthält einige Parameter. Passen Sie diese an Ihre Systemumgebung an.
Zeilen, die mit %% beginnen, sind Kommentare.
Leerzeilen haben keine Bedeutung und können ignoriert werden.
Parameter sind in folgender Form angegeben: <Parameter-Name>=<Wert>
Der Name des Parameters ist vorgegeben und nicht änderbar. Der zugehörige Wert hängt von Ihrem System ab.
Die Datei INSTINI muss sich am selben Subvolume wie die anderen Installationsdateien (OINSTALL, INSTALL) befinden!
Bei Angaben zu Subvolumes empfehlen wir ausdrücklich, leere Subvolumes zu verwenden, umKonflikte mit anderen Programmen zu vermeiden!

Parameter	Beschreibung
AE-PROGRAM-SUBVOLUME=	Subvolume für die ausführbaren Dateien des Agenten.
AE-STATUS-STORE-SUBVOLUME=	Subvolume für die StatusStore-Dateien von FileTransfers StatusStore-Dateien werden automatisch vom Agenten angelegt und speichern die Wiederanlauf-Informationen von aktiven FileTransfers. Durch diesen Mechanismus ist es möglich, abgebrochene FileTransfers ab einer gewissen Dateiposition neu zu starten (= letzter Wiederanlauf-Punkt). Wiederanlauf-Punkte werden in regelmäßigen Intervallen erstellt (einstellbar mit der Einstellung FT_RESTART_INTERVAL in der Variable UC_HOSTCHAR_DEFAULT). Auf Nonstop-Systemen handelt es sich beim StatusStore um die 4 Enscribe Files, die standardmäßig folgende Namen besitzen: UC4SST, UC4SSD, UC4SSL, UC4SSH. Sie können die Namen dieser Dateien nachträglich in der INI-Datei des Agenten ändern.
AE-STATUS-STORE-AUDITED=	StatusStore von FileTransfers als Audited Files speichern (TMF protection) Erlaubte Werte: "Y" (Empfohlen, Standardwert) oder "N"
AE-TCPIP-PROCESS=	Name des NonStop TCP/IP-Prozessnamens, den der Agent verwenden soll. Standardmäßig ist $ZTC0 eingetragen, das auch dem Systemstandard entspricht. Geben Sie einen anderen Prozessnamen an, so wird automatisch die notwendige ADD DEFINE TACL Anweisung in der Startup Obey Datei eingefügt.
AE-SERVER-PORT	Portnummer des Kommunikationsprozesses der Automation Engine, zu dem sich der Agent verbinden soll. Stellen Sie sicher, dass alle betroffenen Firewalls diesem Port entsprechend konfiguriert sind.
AE-AGENT-PORT=	Portnummer des Agenten, die zur Kommunikation mit anderen Agenten dient. Dieser Port kann daher nicht von anderen Programmen verwendet werden.
AE-SERVER-IP-ADDRESS=	IP-Adresse oder Rechnername der Automation Engine.
AE-AGENT-PROCESS=	Prozessname des Agentenprozesses.
AE-OC-PROCESS=	Prozessname des AE Output Collector-Prozesses.
AE-TSIM-PROCESS=	Prozessname des AE Terminal Simulator Prozesses.
AE-SYSTEM-NAME=	Logischer Name des Automation Engine Systems (der Automation Engine)
AE-AGENT-NAME=	Logischer Name der AE-Agenteninstanz. Standardmäßig wird der Systemname des NonStop Servers ohne "\" für die Benennung des Agenten herangezogen: AE-AGENT-NAME=%NODENAME% Der Agentenname kann natürlich durch ein Pre- oder Postfix erweitert werden. Beispiel: AE-AGENT-NAME=UC4%NODENAME%EXE
AE-TEMP-SUBVOLUME=	In diesem Subvolume werden alle temporären Dateien wie z.B. Jobreports und Jobdateien gespeichert.

Die INI-Datei des Agenten wird mit den hier eingetragenen Daten befüllt. Sie können die Werte natürlich nach der Installation jederzeit ändern.

	4.	Weiterführen der Installation

Host
Setzen Sie folgenden Befehl in der TACL-Eingabezeile ab:

RUN INSTALL
Sie werden über den Verlauf der Installation informiert und können den Vorgang auch jederzeit abbrechen. In diesem Fall sind gegebenenfalls manuelle Aufräumaktionen erforderlich.
Am Ende der Installation wird ein Verbindungsaufbau zur Automation Engine durchgeführt.

Admin-Rechner oder Server-Rechner
Prüfen Sie, ob sich der Agent angemeldet hat.
- UserInterface für Mandant 0000 starten. In der Systemübersicht die Informationen über Agenten abrufen. Da ein neu angemeldeter Agent noch keinem Mandanten zugewiesen ist, wird er nur im Mandant "0000" sichtbar. Der neu installierte Agent kann nun über das Agenten-Objekt den Mandanten mit den gewünschten Rechten zugewiesen werden.

	5.	Starten und Stoppen des Agenten

Host
Wechseln Sie in das Subvolume des Agenten und setzen Sie folgenden Befehl in der TACL-Eingabezeile ab:

O EXSTART
Der nachstehende Befehl stoppt den Agenten:

O EXSTOP

Siehe auch:

EMS template file

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support