Agenten für BS2000 installieren

Diese Seite führt Sie durch die Installation eines BS2000-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.

Verschiedene BS2000-Versionen erfordern einen eigenen Agenten. Jeder unterstützten Version ist ein dreistelliger Code zugeordnet. Dieser Code ist Teil des Dateinamens des Agenten. Auf dieser Seite wird der spezifische Code durch das Zeichen "?" ersetzt.

Diese Seite beinhaltet Folgendes:

Voraussetzungen

  • Richten Sie die Benutzer-ID $UC4 in BS2000 mit ungefähr 10.000 PAM-Seiten ein.

  • Installieren Sie das BS2 TAR-Programm in BS2000. Entpacken Sie die TAR-Datei von der mitgelieferten Installations-CD. Weitere Informationen finden Sie unterProgramm BS2-TAR und BS2000 Text-Archiv (TAR-Datei).

    Dies ist möglicherweise nicht erforderlich, wenn Sie BS2 TOOLS ab Version 2.00W verwenden. BS2 TOOLS wird verwendet, um Dateien in einem Textarchiv zu empfangen und Textarchive zu entpacken.

Mitgelieferte Installationsdateien

Die Dateien sind in TAR-Dateien gepackt. Die jeweilige TAR-Datei wird je nach BS2000-Variante in einem Unterverzeichnis von IMAGE:AGENTS\BS2000 gespeichert. Der Dateiname gibt die aktuelle Automation Engine-Version an. In der untenstehenden Liste wird die Version durch die Zeichen xx dargestellt.

TAR-Dateien, die im Namen NK4 enthalten, werden für NK4-Pubsets benötigt und können auch mit dem Programm BS2-TAR entpackt werden.

  • Dateiname: xx.UCX2?.LIB

    Beschreibung: Programmbibliothek

    Bibliothek-Elemente:

    • UCXBB2?C: Dienstprogramm CallAPI

    • UCXEB2?U: Dienstprogramm für das Konsolenereignis (UCON-Verbindung)

    • UCXJB2?: Agent

    • UCXJB2?M: Nachrichtenprogramm für den BS2000-Agenten

    • UCYBRFC?: Serviceprogramm für RFC-Aufgabe

      Weitere Informationen finden Sie unter Dienstprogramm für Remote Function Call (RFC) Tasks.

  • Dateiname: xx.UCXJB2?.INI

    Beschreibung: INI-Datei für einen BS2000-Agenten

  • Dateiname: xx.UCXEB2?U.INI

    Beschreibung: INI-Datei für das Dienstprogramm

  • Dateiname: xx.UCYEBXXZ

    Beschreibung: Dienstprogramm zum Abrufen von Befehlen über eine Konsole (nur für Konsolenereignisse)

  • Dateiname: xx.E.UCXJB2?

    Beschreibung: Beispiel - Datei für den BS2000-Agenten eingeben

  • Dateiname: xx.E.UCXEB2?U

    Beschreibung: Beispiel - Datei für das Dienstprogramm eingeben

  • Dateiname: xx.UCX.MSL

    Beschreibung: Meldungsbibliothek

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

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 BS2000 installieren

  1. Übertragen Sie vom Administratorcomputer aus die TAR-Dateien auf den Host.

    Übertragen Sie dazu die TAR-Datei UCXJB2?.TAR oder UCXJB2?NK4.TAR per FTP im Textmodus. Alternativ können Sie die TAR-Datei mit FTBS2000 oder EDT File Transfer (auch im Textmodus) auf BS2000 übertragen.

  2. Entpacken Sie die TAR-Dateien im Host, und richten Sie die Systemumgebung ein:

    1. Sie können die TAR-Datei mit BS2 TAR oder BS2-TOOLS entpacken:

      • Auspacken mit BS2 TAR:

        /FILE UCXJB2?.TAR,LINK=TAR or /FILE UCXJB2?NK4.TAR,LINK=TAR
        /EXEC BS2-TAR

      • Auspacken mit BS2 TOOLS:

        $UC4 anzeigen. Geben Sie den Befehl TAR in das Kommandofeld neben der TAR-Datei ein.

      Die tatsächlichen Installationsdateien werden erstellt, und die TAR-Datei kann gelöscht werden.

    2. Entfernen Sie das Präfix aus den Installationsdateien.

    3. Passen Sie die INI-Datei des BS2000-Agenten an und geben Sie einen Job ein, siehe Agent BS2000.

    4. Passen Sie gegebenenfalls HEADER.BS2000, TRAILER.BS2000 und RESTART.BS2000 ein, siehe Jobs ausführen.

      Die Datei UCXJB2?M muss teilbar sein und die Benutzer-ID und der Dateiname müssen dem Eintrag UC_EX_JOB_MD der INI-Datei entsprechen.

      Die Datei UCYBRFC? muss gemeinsam genutzt werden können, wenn der RFC-Mechanismus aktiviert ist, siehe Dienstprogramm für Remote Function Call (RFC) Tasks.

      Die Programmbibliothek UCX2?.LIB muss für die Dateien UCXJB2? M und UCYBRFC? gemeinsam werden können.

  3. Starten Sie den Agenten.

    1. Das AE-System muss ausgeführt werden (Server-Computer), siehe Multi-Server-Vorgänge.

    2. Starten Sie den Agenten unter $TSOS (Host) und legen Sie Priorität und Kategorie fest.

      Ein Agentenobjekt wird automatisch im Systemmandanten 0000 angelegt und im Ordner HOST aufbewahrt

    3. 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".

  4. Fahren Sie auf dem Host den Agenten herunter. Verlassen Sie dazu den Agenten mit dem Befehl /INTR Tsn, END oder über den Task-Manager von BS2 TOOLS.

Siehe auch: