Agenten für NSK installieren

Diese Seite führt Sie durch die Installation eines NSK-Agenten in einem Automation Engine-System, in dem die Authentifizierung nicht verwendet wird. Weitere Installationsschritte sind erforderlich, bevor der Agent gestartet und verwendet werden kann, wenn Sie eine der verfügbaren Authentifizierungsmethoden verwenden möchten. Weitere Informationen finden Sie unter Agenten-Authentifizierung.

Jeder unterstützten NSK-Version ist ein dreistelliger Code zugeordnet. Sie wird im Dateinamen des Agenten angezeigt (NS1 für NSK, Version D40 und höher).

Diese Seite beinhaltet Folgendes:

Voraussetzungen

Stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:

  • Netzwerkprotokoll TCP/IP
  • Benutzer-ID für die Installation ist erstellt
  • Eintrag #set #informat tacl in der TACLCSTM-Datei für jeden Benutzer, der Job in der AE ausführt
  • OSS und NetBatch sind installiert, um für die Ausführung von Jobs nutzen zu können

Stellen Sie außerdem sicher, dass der Agent mit dem Benutzer SUPER.SUPER läuft, um Probleme beim Abbrechen von Prozessen zu vermeiden.

Informationen zu CallAPI-Dateien und deren Implementierung finden Sie unter CallAPI für NSK.

Eine Verbindung zur Automation Engine herstellen

Wichtig! Die Automation Engine verwendet TLS/SSL, um nur mit den Windows-, UNIX- und Java-Agenten zu kommunizieren. Dieser Agent ist kein TLS-/SSL-Agent und stellt deshalb eine Verbindung zu einem Kommunikationsprozess (CP) her und verwendet eine andere als die TLS-/SSL-Verschlüsselung. Die Kommunikation zwischen einem TLS/SSL- und einem Nicht-TLS/SSL-Agenten kann unter Verwendung des TLS Gatewayhergestellt werden.

Mehr Informationen:

Andere als TLS/SSL-Agenten stellen bei Verwendung für die Automic Automation Kubernetes Edition eine Verbindung zu einem TCP-Load Balancer her, der für den Agenten erreichbar sein muss. Die Adresse des Load Balancers muss auf beiden Seiten definiert werden:  Automation Engine und Agent.

Wichtig! Wenn Sie Agenten für ein Automic Automation Kubernetes Edition-System manuell installieren oder aktualisieren, müssen Sie sicherstellen, dass Sie Ihre Agenten und/oder das TLS Gateway konfigurieren, um den TCP- oder HTTPS-Load Balancer zu erreichen, und nicht direkt den CP oder JCP. Stellen Sie außerdem sicher, dass ihr HTTPS-Load Balancer die erforderlichen Zertifikate besitzt. Weitere Informationen finden Sie unter Eine Verbindung zum AAKE-Cluster herstellen.

Agenten für NSK installieren

  1. Übertragen Sie vom Administratorcomputer aus die Dateien auf den Host. Stellen Sie dazu über einen FTP-Client eine Verbindung zum Host her und übertragen Sie die beiden mitgelieferten Dateien OINSTALL und UC4AR in ein gemeinsames Unterverzeichnis.

    Hinweise:

    • Die Datei OINSTALL muss im Textmodus (Code 101) und UC4AR im Binärmodus (Code 0) übertragen werden.

    • Am besten speichern Sie diese Dateien in einem leeren Unterverzeichnis.

    • Die Datei UC4AR ist ein selbstentpackendes Archiv, das alle Dateien enthält, die der NSK-Agent benötigt.

  2. Starten Sie das Installationsverfahren auf dem Host.

    1. Starten Sie ein Terminal-Emulationsprogramm und melden Sie sich mit den Daten des Benutzers an, der der Programmbesitzer sein soll. 

    2. Wechseln Sie zu dem Unterverzeichnis, in das die beiden Dateien übertragen wurden.

    3. Führen Sie den Befehl O OINSTALL in der TACL-Eingabezeile aus.

      Dadurch wird die INSTINI-Datei im Unterverzeichnis entpackt. Sie muss im gleichen Unterverzeichnis wie die anderen Installationsdateien belassen werden, um sicherzustellen, dass die Installation fortgesetzt werden kann.

  3. Passen Sie auf dem Host die INSTINI-Konfigurationsdatei an. Diese Datei enthält mehrere Parameter, die an Ihre Systemumgebung angepasst werden müssen. Zeilen, die mit den Zeichen %% beginnen, sind Kommentare. Leerzeichen können ignoriert werden, sie sind irrelevant.

    Geben Sie die Parameter in folgendem Format an: <Parametername>=<Wert>. Der Parametername ist vordefiniert und kann nicht geändert werden. Der entsprechende Wert hängt von Ihrem System ab.

    Die INSTINI-Datei muss im gleichen Unterverzeichnis wie alle anderen Installationsdateien (OINSTALL, INSTALL) gespeichert werden. Es wird empfohlen, leere Unterverzeichnisse für die Spezifikation zu verwenden, um Konflikte mit anderen Programmen zu vermeiden.

    Parameter

    • AE -PROGRAM-SUBVOLUME=

      Beschreibung: Unterverzeichnis für die ausführbaren Agentendateien.

    • AE -STATUS-STORE-SUBVOLUME

      Beschreibung: Unterverzeichnis für die StatusStore-Dateien von FileTransfers.

      Der Agent hat automatisch StatusStore-Dateien erstellt. Sie speichern die Restart-Informationen der aktiven FileTransfers. Dieser Mechanismus stellt sicher, dass abgebrochene FileTransfers von einer bestimmten Dateiposition (= letzter Neustartpunkt) aus neu gestartet werden können. Neustart-Punkte werden in regelmäßigen Abständen erstellt (mit FT_RESTART_INTERVAL in der Variablen UC_HOSTCHAR_DEFAULT). Bei Nonstop-Systemen sind die StatusStore-Dateien die folgenden 4 Enscribe-Dateien mit den Standardnamen: UC4SST, UC4SSD, UC4SSL, UC4SSH. Sie können diese Dateinamen anschließend in der INI-Datei des NSK-Agenten ändern. Weitere Informationen finden Sie unter Agent NSK.

    • AE -STATUS-STORE-AUDITED=

      Beschreibung: Speichert StatusStore-Dateien von FileTransfers als geprüfte Dateien (TMF-Schutz).

      Zulässige Werte: Y (Standard) und N

    • AE -TCPIP-PROCESS=

      Beschreibung: Name des NonStop-TCP/IP-Prozessnamens, den der Agent verwenden soll. Standardmäßig ist $ZTC0 angegeben (Systemstandard).

      Hinweis: Wenn Sie einen anderen Prozessnamen angeben, wird die erforderliche ADD DEFINE TACL-Anweisung automatisch in die Startup-Obey-Datei eingefügt.

    • AE -SERVER-PORT

      Beschreibung: Portnummer des Automation Engine-Kommunikationsprozesses, mit dem sich der Agent verbinden soll. Stellen Sie sicher, dass alle betroffenen Firewalls für diesen Port konfiguriert sind.

    • AE -AGENT-PORT=

      Beschreibung: Portnummer, die der Agent verwenden sollte, um andere Agenten zu kontaktieren. Dieser Port kann nicht von anderen Programmen verwendet werden.

    • AE -SERVER-IP-ADDRESS=

      Beschreibung: IP-Adresse oder Computername der Automation Engine.

    • AE -AGENT-PROCESS=

      Beschreibung: Prozessname des Agentenprozesses.

    • AE -OC-PROCESS=

      Beschreibung: Prozessname des Automation Engine-Ausgangskollektorprozesses.

    • AE -TSIM-PROCESS=

      Beschreibung: Prozessname des Automation Engine-Terminalsimulator-Prozesses.

    • AE -SYSTEM-NAME=

      Beschreibung: Logischer Name des Automation Engine-Systems.

    • AE -AGENT-NAME=

    • Beschreibung: Logischer Name der Agenteninstanz.

      Standardmäßig wird der Systemname des NonStop-Servers ohne \ als Agentenname verwendet: AE-AGENT-NAME=%NODENAME%

      Sie können den Agentennamen auch mit Prä- oder Postfixen erweitern: AE-AGENT-NAME=UC4%NODENAME%EXE

    • AE -TEMP-SUBVOLUME

      Beschreibung: Alle temporären Dateien, wie z. B. Job-Reports und Jobdateien, werden in diesem Unterverzeichnis gespeichert.

    Die INI-Datei des Agent NSK wird mithilfe der hier angegebenen Daten fertiggestellt. Nach erfolgreicher Installation können Sie diese Werte jederzeit ändern.

  4. Setzen Sie die Installation fort.

    1. Führen Sie auf dem Host den Befehl RUN INSTALL in der TACL-Eingabezeile aus.

      Sie erhalten Benachrichtigungen über den Fortschritt der Installation und können diese jederzeit abbrechen. In diesem Fall kann ein manueller Bereinigungsprozess erforderlich sein.

      Eine Verbindung zur Automation Engine wird hergestellt, wenn die Installation abgeschlossen ist.

    2. Stellen Sie auf dem Administrator- oder Servercomputer sicher, dass der Agent bei der Automation Engine angemeldet ist.

      Neu eingeloggte Agenten werden einem Mandanten nicht automatisch zugewiesen und können nur in Mandant 0 angezeigt werden. Sobald Sie sich bei Mandant 0 eingeloggt haben, greifen Sie auf die Administration-Perspektive zu und wählen Sie Agenten und Gruppen aus.

      Sie können den neuen Agenten nun über die Agentenobjektdefinition Mandanten mit den erforderlichen Rechten zuordnen. Weitere Informationen finden Sie auf der Seite Seite "Berechtigungen".

  5. Starten oder stoppen Sie den Agenten auf dem Host. Wechseln Sie dazu in der TACL-Eingabezeile in das Unterverzeichnis des Agenten und führen Sie O EXSTART aus, um den Agenten zu starten, oder O EXSTOP, um ihn zu stoppen.

Siehe auch: