Agenten für VMS installieren

Dieses Thema führt Sie durch den Installationsprozess eines VMS-Agenten.

Hinweise:

  • Jede unterstützte VMS-Version zeigt einen zweistelligen Code, der in allen Agentendateinamen verwendet wird. In diesem Thema werden die Zeichen "???" verwendet, um diesen Code darzustellen.
  • In VMS wird bei Text-Strings, die Elemente wie Kommandos und Dateien aufrufen und identifizieren, die Groß-/Kleinschreibung nicht berücksichtigt. Jede Kombination von Groß- und Kleinbuchstaben ist zulässig. In diesem Thema werden Großbuchstaben verwendet.
  • 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.
  • Informationen zu CallAPI-Dateien und deren Implementierung finden Sie unter CallAPI für VMS.

Diese Seite beinhaltet Folgendes:

Voraussetzungen

  • Der Benutzer AE wurde mit den Berechtigungen CMKRNL, BYPASS, SYSNAM, SYSPRV und WORLD angelegt.
  • Die Batch-Queue SYS$BATCH wurde initialisiert und gestartet. Alternativ können Sie auch eine Batch-Queue verwenden, die speziell für AE-Jobs erstellt und priorisiert wurde. Wenn zu diesem Zweck eine Batch-Datei erstellt wird, muss diese in der INI-Datei des Agent VMS als Parameter des VMS-Befehls zum Starten von Jobs im Batch-Modus definiert werden. Wenn Sie eine andere Batch-Queue verwenden, beachten Sie, dass diese ebenfalls initialisiert und gestartet werden muss.

    Die Jobgrenze muss mit einer Zahl größer als Null angegeben werden, damit AE-Jobs im Batch-Modus ausgeführt werden können.

    • Tipp: Der VMS-Agent kann beim Start des Betriebssystems automatisch gestartet werden. Zu diesem Zweck müssen die erforderlichen Kommandodateien UC4$STARTUP.COM und UC4$STARTUP_BAT.COM in das Verzeichnis SYS$STARTUP übertragen werden. Sie können diese Kommandodateien beliebig benennen. Die Länge ist auf maximal 32 Zeichen begrenzt. Geänderte Namen müssen auch in den Kommandodateien geändert werden. Weitere Informationen finden Sie unter Automatischer Start des Agenten beim Booten des Betriebssystems.

Mitgelieferte Installationsdateien

Die Dateien des VMS-Agenten befinden sich im Unterverzeichnis von IMAGE:AGENTS\VMS, das der jeweiligen VMS-Version entspricht.

Sonderfunktion: Logischer Name für Agenten

VMS verwendet oft globale Variablen, die logische Namen genannt werden, um Informationen zu übertragen. Der AE-VMS-Agent verwendet auch eine solche globale Variable.

Der Name ist standardmäßig wie folgt aufgebaut: UC4_AE Systemname_Agentenname_AGENT. Die Namen, die in der INI-Datei definiert wurden, werden für den AE-Systemnamen und -Agentennamen verwendet. Alternativ können Sie auch einen beliebigen logischen Namen definieren. Verwenden Sie dazu den Parameter uc4_logical= in der INI-Datei.

Die globale Variable wird automatisch erstellt, wenn der Agent startet, und gelöscht, wenn er beendet wird. Der Wert der Variablen ist standardmäßig "OK". Sie können den Agenten beenden, indem Sie den Variableninhalt auf "TERM" ändern. Verwenden Sie die Kommandodatei UC$STOP.COM, und der Agent wird innerhalb von 20 Sekunden reagieren und normal beendet werden.

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

  1. Übertragen Sie vom Administratorcomputer aus die Kommando-Datei UC$CRDIR.COM auf den Host.

    Wenn Sie FTP verwenden, um die Dateien auf den Zielhost zu übertragen, werden alle Textdateien in einem Format wie unter Unix geliefert.

  2. Legen Sie auf dem Host-Computer Verzeichnisse und Berechtigungen fest.

    • Die Befehlsdatei aufrufen: $ @UC$CRDIR

    • Die Befehlsdatei löschen: $ DELETE UC$CRDIR.COM;*

      Die Befehlsdatei UC UC$CRDIR.COM erstellt alle erforderlichen Verzeichnisse und Berechtigungen:

      • BIN

        SYSTEM: RE, OWNER: RWED, GROUP: E, WORLD: E

      • CMD

        SYSTEM: RWE, OWNER: RWED, GROUP: R, WORLD: -

      • TEMP

        SYSTEM: RE, OWNER: RWED, GROUP: WE, WORLD: WE

      • OUT

        SYSTEM: RW, OWNER: RWD, GROUP: RW, WORLD: RWE

  3. Übertragen Sie vom Administratorcomputer aus weitere Dateien auf den Host.

    Die Dateien des VMS-Agenten (UCXJV??.EXE), des Dateiereignisses (UCXE???F.EXE) und des Messenger-Programms (UCXJV??M.EXE) müssen im Binärmodus übertragen werden. Alle anderen sind Textdateien.

  4. Richten Sie auf dem Host-Computer die Systemumgebung ein.

    1. Wechseln Sie vom Anmeldeverzeichnis zum BIN-Verzeichnis: $ SET DEF [.BIN].

    2. Passen Sie die INI-Datei des VMS-Agenten im Editor an. Weitere Informationen finden Sie unter Agent VMS.

      Verwenden Sie die Parameter trustedCertFolder=, agentSecurityFolder= und keyPassword= in der jeweiligen INI-Datei, um auf die relevanten Zertifikate zu verweisen. Wenn der Parameter trustedCertFolder= nicht festgelegt ist, sollten die Zertifikate im jeweiligen Speicher installiert werden; das ist der Java-Truststore für Java-Agenten, der Windows-Betriebssystemspeicher für Windows-Agenten oder der TLS/SSL-Speicher für UNIX-Agenten. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL).

      Weitere Informationen zu den verschiedenen Zertifikattypen und ausführliche Anweisungen zur Erstellung und Verwendung finden Sie unter Welche Art von Zertifikaten sollte ich für Automic Automation v21 verwenden?

    3. Passen Sie HEADER.VMS, TRAILER.VMS und RESTART.VMS bei Bedarf an. Weitere Informationen finden Sie unter Jobs ausführen.

    4. Wechseln Sie zum CMD-Verzeichnis: $ SET DEF [.CMD].

    5. Verwenden Sie einen Editor, um die Kommandodatei anzupassen, die den Agenten UC$STOP.COM schließt.

      Passen Sie den Namen des AE-Systems und den Namen des Agenten so an, dass der logische Name des Agenten gefunden werden kann. Alternativ können Sie beide Dateien auf dem Admin-Computer ändern, bevor Sie die Datei übertragen.

      Standardmäßig wird für den Start des Agenten das HOME-Verzeichnis verwendet. Wenn der Agent nicht im HOME-Verzeichnis installiert ist, müssen Sie die Kommandodatei UC$START.COM anpassen. Sie enthält eine Variable, in der Sie das Installationsverzeichnis angeben können.

      $   rel_dir     = ""

      Die Benutzer-IDs, unter denen AE-Jobs ausgeführt werden sollen, sollten TMPMBX- und in einigen Fällen NETMBX-Rechte erhalten.

    6. Passen Sie auf dem Administrator- oder Benutzercomputer gegebenenfalls HEADER.VMS, TRAILER.VMS und RESTART.VMS an. Weitere Informationen finden Sie unter Jobs ausführen.

  5. Starten Sie auf dem Servercomputer den Agenten.

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

    2. Rufen Sie auf dem Host-Computer die Kommandodatei im CMD-Verzeichnis auf: $ @UC$START

      Sie können die Aufgabe des Agenten anhand der Prozess-ID oder des Prozessnamens identifizieren:

      • Prozessname, der beim Start des Agenten erstellt wird: UC4_User ID. Standardmäßig ist der Prozessname UC4_UC4.

        $ SHOW PROC UC4_UC4

      • Die Prozess-ID, die beim Start des Agenten angezeigt wird.

        $ SHOW PROC/ID=Process ID

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

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

  6. Schließen Sie den Agenten auf dem Host-Computer.

    • Reguläres Herunterfahren: Rufen Sie die Kommandodatei im CMD-Verzeichnis auf.

      $ @UC$STOP

    • Herunterfahren im Notfall: Die Netzwerkverbindungen werden in diesem Fall nicht ordnungsgemäß geschlossen.

      Stoppen Sie ihn, indem Sie den Prozessnamen verwenden:

      $  STOP UC4_UC4

      Stoppen Sie ihn, indem Sie die Prozess-ID verwenden:

      $  STOP PROC/ID=Process-ID

Automatischer Start des Agenten beim Booten des Betriebssystems

Die Kommandodatei SYS$MANAGER:SYSTARTUP_VMS.COM wird beim Start des Betriebssystems ausgeführt. Um den VMS-Agenten automatisch mit VMS zu starten, wird das Startup-Script des Agenten an das Ende dieser Kommandodatei angehängt. Die Kommandodatei (1) UC4$STARTUP.COM wird im Startup-Script aufgerufen, wenn sie verfügbar ist.

Startup-Script-Beispiel

$!
$ FILE = F$SEARCH("SYS$STARTUP:UC4$STARTUP.COM")
$ IF FILE .NES. ""
$ THEN
$    @SYS$STARTUP:UC4$STARTUP.COM
$ ENDIF
$!

Die folgenden Parameter müssen in der mitgelieferten Kommandodatei (1) UC4$STARTUP.COM an die Systemumgebung angepasst werden:

  • UC4_BAT
    Die Befehlsdatei (2) UC4$STARTUP_BAT.COM
  • UC4_LOG
    Verzeichnis, in dem die Logdateien des Agenten abgelegt werden
  • UC4_USER
    Benutzer-ID des Agenten

Die Kommandodatei (1) UC4$STARTUP.COM ruft die Kommandodatei (2) UC4$STARTUP_BAT.COM auf. Der VMS-Agent startet mit Hilfe der Kommandodatei UC$START.COM. Passen Sie den Parameter UC4_COM an, wenn Sie den Namen oder das Verzeichnis dieser mitgelieferten Kommandodatei geändert haben.

Kommentare

  • Die Kommandodatei (2) UC4$STARTUP_BAT.COM muss mit der Benutzer-ID des Agenten gestartet werden.
  • Die Batch-Queue muss initialisiert und gestartet werden.
  • Die Netzwerkumgebung und die Administration-UCX müssen gestartet werden.
  • Die Kommandodatei (2) UC4$STARTUP_BAT.COM muss über WORLD READ-Berechtigungen verfügen, damit die Benutzer-ID des Agenten gelesen werden kann: $ SET FILE /PRIV=(W:R) SYS$STARTUP:UC4$STARTUP_BAT.COM.

Siehe auch: