Agenten für OS/400 installieren

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

Für jede unterstützte OS/400-Version ist eine dreistellige Abkürzung vorgesehen. Teil des Dateinamens des Agenten.

Diese Seite beinhaltet Folgendes:

Voraussetzungen

  • TCP/IP

Informationen zu CallAPI-Dateien und deren Implementierung finden Sie unter CallAPI für OS/400.

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 OS/400 installieren

Es gibt zwei verschiedene Methoden.

Methode 1

  1. Übertragen Sie die Datei auf den Host und passen Sie die Bibliothek und die INI-Datei an.

    Starten Sie die Installation mit der mitgelieferten Datei installer.jar:

    java -jar installer.jar /LIB UC4 /SAVF ucxjo41.bin

    Wenn Sie die Parameter für System, Benutzer und Passwort hier nicht angeben, öffnet sich ein Dialog, in dem Sie diese Zugangsdaten eingeben können.

    Das Installationsprogramm überträgt die Binärdateien automatisch und passt den Bibliothekspfad der INI-Dateien an die angegebene Bibliothek an.

    Alternativ übertragen Sie die Datei manuell auf den Host-Computer:

    1. Erstellen Sie eine Bibliothek für die Wiederherstellung des Save Files:

      CRTLIB LIB(UC4TMP) TYPE(*PROD) TEXT('UC4 Agent')

    2. Erstellen Sie ein leeres Save File.

      CRTSAVF FILE(UC4TMP/UC4)

    3. Melden Sie sich auf dem Administratorcomputer per FTP bei AS/400 an und übertragen Sie UCXJO41.bin an Save File UC4, Bibliothek UC4TMP. Beispiel für FTP über die Windows-Eingabeaufforderung:

      ftp <MY.AS400>
      <USER>
      <PASSWORD>
      cd UC4TMP
      bin
      put UCXJO41.bin UC4
      quit

  2. Erstellen Sie die Bibliothek auf dem Host.

    1. Erstellen Sie eine Bibliothek für die Wiederherstellung des Save Files:

      CRTLIB LIB(UC4) TYPE(*PROD) TEXT('Automic Agent')

    2. Stellen Sie die Objekte in der UC4-Bibliothek wieder her. Wenn diese Bibliothek Objekte enthält, werden diese ersetzt.

      RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(UC4TMP/UC4) MBROPT(*ALL) ALWOBJDIF(*ALL) RSTLIB(UC4)

    3. Entfernen Sie die temporäre Bibliothek und das Save File:

      DLTLIB LIB(UC4TMP)

  3. Richten Sie die Systemumgebung ein.

    1. Stellen Sie auf dem Servercomputer sicher, dass das AE-System auf dem Servercomputer ausgeführt wird. Weitere Informationen finden Sie unter Multi-Server-Vorgänge.

    2. Passen Sie auf dem Host die INI-Datei (UC4/INI - UCXJO41) des OS/400-Agenten an. Weitere Informationen finden Sie unter Agent OS/400.

    3. Passen Sie auf dem Administrator- oder Benutzercomputer HEADER.OS400, TRAILER.OS400 und RESTART.OS400 an, falls erforderlich. Weitere Informationen finden Sie unter Jobs ausführen.

    Es gibt zwei verschiedene Methoden, mit denen der Agent gestartet werden kann:

    • Methode 1 erfordert eine CL-Routine pro Agent, der starten soll (komplexer)

    • Methode 2 startet oder beendet den Agenten über separate Programme

  4. Erstellen Sie auf dem Host die Programme zum Starten und Beenden.

    Die CL-Beispielprogramme, die den Agenten starten und beenden, werden in der mitgelieferten Datei CLLE bereitgestellt. Sie müssen an die Installation und das Betriebssystem angepasst werden, bevor Sie sie kompilieren können.

    Den Agenten starten: UC4/CLLE(UCEX_RUN)

    Den Agenten beenden: UC4/CLLE(UCEX_END)

  5. Starten oder beenden Sie den Agenten.

    1. Auf dem Host können Sie den Agenten mit dem Programm UCEX_RUN starten.

      Ein Agentenobjekt wird automatisch im Systemmandanten 0 angelegt und im Ordner HOST gespeichert.

      Das Programm UCEX_END beendet den Agenten.

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

Methode 2

  1. Übertragen Sie die Datei auf den Host und passen Sie die Bibliothek und die INI-Datei an.

    Starten Sie die Installation mit der mitgelieferten Datei installer.jar:

    java -jar installer.jar /LIB UC4 /SAVF ucxjo41.bin

    Wenn Sie die Parameter für System, Benutzer und Passwort hier nicht angeben, öffnet sich ein Dialog, in dem Sie diese Zugangsdaten eingeben können.

    Das Installationsprogramm überträgt die Binärdateien automatisch und passt den Bibliothekspfad der INI-Dateien an die angegebene Bibliothek an.

    Alternativ übertragen Sie die Datei manuell auf den Host-Computer:

    1. Erstellen Sie eine Bibliothek für die Wiederherstellung des Save Files:

      CRTLIB LIB(UC4TMP) TYPE(*PROD) TEXT('UC4 Agent')

    2. Erstellen Sie ein leeres Save File.

      CRTSAVF FILE(UC4TMP/UC4)

    3. Melden Sie sich auf dem Administratorcomputer per FTP bei AS/400 an und übertragen Sie UCXJO41.bin an Save File UC4, Bibliothek UC4TMP. Beispiel für FTP über die Windows-Eingabeaufforderung:

      ftp <MY.AS400>
      <USER>
      <PASSWORD>
      cd UC4TMP
      bin
      put UCXJO41.bin UC4
      quit

  2. Erstellen Sie die Bibliothek auf dem Host.

    1. Erstellen Sie eine Bibliothek für die Wiederherstellung des Save Files:

      CRTLIB LIB(UC4) TYPE(*PROD) TEXT('Automic Agent')

    2. Stellen Sie die Objekte in der UC4-Bibliothek wieder her. Wenn diese Bibliothek Objekte enthält, werden diese ersetzt.

      RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(UC4TMP/UC4) MBROPT(*ALL) ALWOBJDIF(*ALL) RSTLIB(UC4)

    3. Entfernen Sie die temporäre Bibliothek und das Save File:

      DLTLIB LIB(UC4TMP)

  3. Richten Sie die Systemumgebung ein.

    1. Stellen Sie auf dem Servercomputer sicher, dass das AE-System auf dem Servercomputer ausgeführt wird. Weitere Informationen finden Sie unter Multi-Server-Vorgänge.

    2. Passen Sie auf dem Host die INI-Datei (UC4/INI - UCXJO41) des OS/400-Agenten an. Weitere Informationen finden Sie unter Agent OS/400.

    3. Passen Sie auf dem Administrator- oder Benutzercomputer HEADER.OS400, TRAILER.OS400 und RESTART.OS400 an, falls erforderlich. Weitere Informationen finden Sie unter Jobs ausführen.

  4. Nehmen Sie die Bibliothek auf dem Host in die Bibliotheksliste auf.

    Die Bibliothek (UC4), die die Programme beinhaltet (z. B. Agent oder CallAPI), muss in die Bibliotheksliste aufgenommen werden. Zu diesem Zweck können Sie die folgenden Befehle verwenden:

    • Fügen Sie die Bibliothek zur Bibliotheksliste hinzu: ADDLIBLE UC4

    • Ändern Sie die aktuelle Bibliothek für den jeweiligen Job in UC4: CHGCURLIB UC4

  5. Starten oder beenden Sie den Agenten auf dem Host.

    • Starten Sie den Agenten mit dem Befehl STRUCAGENT.

      Beispiele

      Die folgenden Beispiele erläutern das Startverfahren des Agenten:

      STRUCAGENT LIB(UC4) FILE(UC4/INI) MBR(UCXJO41)

      Startet den Agenten aus der Bibliothek unter Verwendung der INI-Datei UC4/INI(UCXJO41).

      STRUCAGENT LIB(UC4) PATH('/user/uc4/ucxjo41.ini')

      Startet den Agenten aus der Bibliothek unter Verwendung einer INI-Datei, die im IFS-Dateisystem gespeichert ist.

    • Der Befehl ENDUCAGENT beendet den Agenten.

      Beispiele

      ENDUCAGENT LIB(UC4) OPTION(*CNTRLD)

      Beendet den Agenten, der aus der Bibliothek gestartet wurde, auf kontrollierte Weise. Dies ist das gleiche wie das Kommando ENDJOB, das im Agentenprozess ausgegeben wird.

      ENDUCAGENT LIB(UC4) OPTION(*IMMED)

      Bricht den Agenten ab, der aus der Bibliothek mit ENDJOB OPTION(*IMMED) gestartet wurde.

    Weitere Informationen finden Sie unter OS/400 Agent - Befehle.

Siehe auch: