Agent for Google Cloud Composer installieren

Dieses Thema führt Sie durch die Installation des Agent for Google Cloud Composer (GC Composer) in einem AE-System ohne Authentifizierung. Wenn Sie eine der verfügbaren Authentifizierungsmethoden verwenden möchten, müssen Sie weitere Installationsschritte durchführen. Weitere Informationen finden Sie unter Agenten-Authentifizierung.

Tipp! Diese Seite bezieht sich nur auf den manuellen Installationsprozess. Anweisungen zum Installieren eines Container-Java-Agenten finden Sie unter Container-Java-Agenten installieren.

Am besten installieren Sie den Agenten in einem separaten Verzeichnis (z. B. C:\AUTOMIC\AGENTS\GCC oder Automic/Agent/ggc).

Wichtig! Bevor Sie den GC Composer-Agent installieren, überprüfen Sie die Informationen zur Versionskompatibilität unter compatibility matrix. Weitere Informationen zur Verwendung von compatibility matrix finden Sie unter Kompatibilitätsinformationen.

Diese Seite beinhaltet Folgendes:

Voraussetzungen

Bevor Sie den Agenten installieren, stellen Sie Folgendes sicher:

  • Wenn nicht bereits verfügbar, installieren Sie die Java Runtime Environment.

  • Für diese Integration sind Google-Dienstkonten erforderlich. Sie sollten sich mit den Schritten vertraut machen, die Sie in dieser Hinsicht durchführen müssen, bevor Sie den Agent for Google Cloud Composer installieren.

    Für einige der möglichen Installationen ist ein Dienstkontoschlüssel erforderlich. Stellen Sie in diesen Fällen sicher, dass Sie über die erforderliche JSON-Datei mit den Authentifizierungsinformationen verfügen. Weitere Informationen finden Sie in der offiziellen Google-Dokumentation unter Dienstkonten.

Eine Verbindung zur Automation Engine herstellen

Die Automation Engine und die Windows-, UNIX- und Java-Agenten kommunizieren unter Verwendung von TLS/SSL. Diese Agenten richten eine Verbindung zum Java-Kommunikationsprozess (JCP) ein, der vertrauenswürdige Zertifikate verwendet, um ihre Identität gegenüber anderen Kommunikationspartnern nachzuweisen.

Wichtig! Sie sollten mit TLS/SSL und der Zertifikatimplementierung vertraut sein, bevor Sie die entsprechende Komponente installieren bzw. aktualisieren. Weitere Informationen finden Sie hier:

Wenn Sie von einer Zertifizierungsstelle signierte Zertifikate verwendet haben, werden die Zertifikate standardmäßig im entsprechenden Java- oder Betriebssystemspeicher gespeichert: dem Java Trust Store für Java-Komponenten und Java-Agenten, dem Windows-Betriebssystemspeicher für Windows-Agenten und dem TLS/SSL-Speicher für UNIX-Agenten. In diesem Fall müssen Sie nur prüfen, ob die Root-Zertifikate bereits im jeweiligen Speicher sind.

Wenn Sie nicht den Standardspeicherort für die oben aufgeführten Komponenten und Agenten verwenden möchten, stellen Sie sicher, dass Sie die Parameter trustedCertFolder=, agentSecurityFolder= und keyPassword= (falls zutreffend) in der entsprechenden Konfigurationsdatei (INI) verwenden, um den Pfad zum Ordner zu definieren, in dem die vertrauenswürdigen Zertifikate gespeichert sind.

Wichtig! TLS/SSL-Agenten (in Containern und vor Ort) sowie das TLS Gateway, wenn sie für die Automic Automation Kubernetes Edition verwendet werden, stellen eine Verbindung zu einem Ingress-/HTTPS-Load-Balancer her, der zur Authentifizierung ein Zertifikat anfordert.

Stellen Sie sicher, dass die Adresse des Load Balancers auf beiden Seiten definiert ist: in der Automation Engine und auf dem Agenten/TLS Gateway, und dass Ihr HTTPS-Load-Balancer die erforderlichen Zertifikate zur Nutzung besitzt. Weitere Informationen finden Sie unter Eine Verbindung zum AWI, die JCP- und REST-Prozesse über einen Ingress herstellen.

Herstellen einer Verbindung zur Google Cloud Composer-Umgebung

Sobald der Agent installiert ist und bevor Sie ihn starten, müssen Sie das Google-Projekt identifizieren, mit dem Sie eine Verbindung herstellen möchten. Dann müssen Sie den Agent authentifizieren.

  1. Geben Sie das Google-Projekt für den Agent for Google Cloud Composer an, mit dem sich der Agent verbinden wird. Folgende Optionen stehen zur Verfügung:

    • Geben Sie die Google-Projekt-ID im Automic Web Interfaceauf der Seite GC Composerein (Administration-Perspektive > Agenten und gruppen > Agenten > GC Composer Agent > GC Composer). Sie definieren das Agentenobjekt auf dieser Seite. Weitere Informationen finden Sie unter Agent for Google Cloud Composer Agentenobjekt.

    • Wenn Sie den Dienstkontoschlüssel verwenden, enthält die .JSON-Datei bereits die Projekt-ID, und Sie müssen sie zusätzlich festlegen.

    • Wenn die AAKE und der Agent auf einer Google Cloud Platform in einem Kubernetes-Cluster ausgeführt wird und der Agent in einem Container ausgeführt wird, geben Sie die Projekt-ID in der Umgebungsvariablen GCP_PROJECT_ID an.

      Wenn Sie die Projekt-ID sowohl in AWI als auch über die Umgebungsvariable GCP_PROJECT_ID konfigurieren, wird die Variable verwendet und der in der Benutzeroberfläche eingegebene Wert überschrieben.

  2. Authentifizieren Sie den Agent bei dem Google-Projekt.

    Abhängig von Ihrer Einrichtung stehen Ihnen die folgenden Optionen zur Verfügung:

    • AAKE und der Agent wird auf der Google Cloud Platform in einem Kubernetes-Cluster ausgeführt und der Agent wird in einem Container ausgeführt.

      In diesen Konstellationen authentifizieren Sie den Agenten über Workload Identity.

      Das Einrichten der Umgebungsvariablen GCP_PROJECT_ID und das Authentifizieren des Agenten über die Workload Identity ist ein Teil Ihrer Arbeit beim Konfigurieren von Google Cloud Platform. Aus diesem Grund schließen wir die entsprechende Dokumentation hier nicht ein.

    • Andere Konstellationen, zum Beispiel lokale Systeme, Agenten, die nicht auf der Google Cloud Platform ausgeführt werden usw.

      Konfigurieren Sie die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS so, dass sie auf den Pfad verweist, in dem Sie die .JSON-Datei gespeichert haben.

      In diesen Konstellationen authentifiziert sich der Agent for Google Cloud Composer in der GC Composer-Umgebung über den in der .JOSN-Datei gespeicherten Dienstkontoschlüssel.

      1. Erstellen Sie die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS.

      2. Konfigurieren Sie die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS so, dass sie auf den Pfad verweist, in dem Sie die JSON-Datei gespeichert haben.

      Weitere Informationen zur Authentifizierung bei der Google Cloud Platform finden Sie in der offiziellen Dokumentation unter https://cloud.google.com/docs/authentication.

Java Runtime Environment (JRE)

Installieren Sie auf dem Administrator- und/oder Benutzercomputer, auf dem der Agent installiert ist, die Java Runtime Environment (JRE).

Wenn Sie die JRE installiert haben, können Sie diesen Schritt ignorieren. Eine Liste der kompatiblen Java-Versionen finden Sie unter compatibility matrix.

Verwenden Sie den folgenden Befehl, um die Version der aktuellen Java Virtual Machine (VM) zu prüfen:

java -version

Wenn mehrere JRE- oder Java SDK-Versionen auf dem Computer installiert sind, stellen Sie sicher, dass die Reihenfolge der Verzeichnisse in den Einstellungen %PATH% oder $PATH korrekt ist, weil die erste JRE verwendet wird, die in der Verzeichnisliste gefunden wird.

Sie können die erforderliche JRE von https://www.oracle.com/java/technologies/ herunterladen.

Mitgelieferte Dateien

Der GC Composer-Kernt enthält die folgenden Dateien:

  • ecc- ae-sheet-ra-gccomposer.jar

    Enthält die AWI-Bereiche.

  • uc.msl

    Nachrichtenbibliothek

  • ucxjcitx.ini

    Agent-Konfigurationsdatei

  • ucxjgcc.jar

    Agentenkern für den Agenten

  • setup.exe

Installieren des Agenten

  1. Falls noch nicht geschehen, führen Sie folgende Schritte durch:

    1. Installation der Java-Laufzeitumgebung (Java Runtime Environment, JRE).

    2. Richten Sie Ihre Google-Zugangsdaten und die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS ein.

  2. Laden Sie das Installations-Package unter https://docs.automic.com/documentation herunter.

  3. Installieren Sie auf dem Host den Agenten:

    UNIX

    1. Melden Sie sich mit dem AE-Benutzer an.

    2. Übertragen Sie die Datei ucxjgcc.tar in ein Verzeichnis, z. B. gcc.

    3. Wechseln Sie in das Verzeichnis gcc: cd gcc.

    4. Entpacken Sie die .tar-Datei:

      gzip -d ucxjgcc.tar

      tar xvfo ucxjgcc.tar

      Stellen Sie sicher, dass alle Dateien korrekt entpackt wurden und notieren Sie sich alle.tar-Meldungen, die von verschiedenen Eigentümern stammen können. Danach können Sie die.tar-Datei löschen, wenn Sie möchten.

    5. Stellen Sie sicher, dass alle Dateien die richtigen Besitzer- und Gruppeneinträge haben.

    6. Benennen Sie die mitgelieferte INI-Datei ucxjcitx.ori.ori.ini in ucxjcitx.ini um..

    7. Passen Sie die INI-Datei an Ihre Systemumgebung an.

      • Wenn Sie von einer Zertifizierungsstelle signierte Zertifikate verwendet haben, werden die Zertifikate standardmäßig im entsprechenden Java- oder Betriebssystemspeicher gespeichert. In diesem Fall müssen Sie nur prüfen, ob die Root-Zertifikate bereits im jeweiligen Speicher sind.

        Wenn Sie nicht den Standardspeicherort für diese Komponente verwenden möchten, stellen Sie sicher, dass Sie die Parameter trustedCertFolder=, agentSecurityFolder= und keyPassword= (falls zutreffend) in der entsprechenden Konfigurationsdatei (INI) verwenden, um den Pfad zum Ordner zu definieren, in dem die vertrauenswürdigen Zertifikate gespeichert sind.

        Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL).

      • name

        Name des Agenten-Objekts.

        Maximale Länge: 32 Zeichen

        Erlaubte Zeichen: "A-Z", "0-9", "_", ".", "$", "@", "-" und "#".

        Bindestriche ("-") sind nur in Agent-Namen zulässig. Sie dürfen in den Namen anderer Objekte nicht verwendet werden.

      • system

        Automation Engine Systemname. Dieser Eintrag muss mit dem Eintrag in der .ini-Datei des Automation Engine-Servers identisch sein.

      • ra

        Wird für zusätzliches Tracing verwendet. Bevor Sie einen neu installierten oder aktualisierten Agenten starten, sollten Sie das Rapid Automation-Tracing durch Hinzufügen von ra=99 aktivieren. Dadurch erhalten Sie weitere Informationen zur Fehlerbehebung, wenn während der Installation ein Fehler auftritt. Nach erfolgreichem Agent-Start können Sie ra=0 festlegen und den Agent neu starten, um das Rapid Automation-Tracing zu deaktivieren.

      • connection

        Adresse des Kommunikationsprozesses im Automation Engine-System, mit dem sich der Agent selbst verbinden sollte. Das Format hierbei lautet:

        <DNS-Name oder TCP/IP-Adresse>:<Portnummer>

      Weitere Informationen finden Sie unter Agent RA Core.

    WINDOWS

    1. Führen Sie setup.exe aus, um das Programm zu starten.

    2. Passen Sie die INI-Datei an Ihre Systemumgebung an.

      • Wenn Sie von einer Zertifizierungsstelle signierte Zertifikate verwendet haben, werden die Zertifikate standardmäßig im entsprechenden Java- oder Betriebssystemspeicher gespeichert. In diesem Fall müssen Sie nur prüfen, ob die Root-Zertifikate bereits im jeweiligen Speicher sind.

        Wenn Sie nicht den Standardspeicherort für diese Komponente verwenden möchten, stellen Sie sicher, dass Sie die Parameter trustedCertFolder=, agentSecurityFolder= und keyPassword= (falls zutreffend) in der entsprechenden Konfigurationsdatei (INI) verwenden, um den Pfad zum Ordner zu definieren, in dem die vertrauenswürdigen Zertifikate gespeichert sind.

        Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL).

      • name

        Name des Agenten-Objekts.

        Maximale Länge: 32 Zeichen

        Erlaubte Zeichen: "A-Z", "0-9", "_", ".", "$", "@", "-" und "#".

        Bindestriche ("-") sind nur in Agent-Namen zulässig. Sie dürfen in den Namen anderer Objekte nicht verwendet werden.

      • system

        Automation Engine Systemname. Dieser Eintrag muss mit dem Eintrag in der .ini-Datei des Automation Engine-Servers identisch sein.

      • ra

        Wird für zusätzliches Tracing verwendet. Bevor Sie einen neu installierten oder aktualisierten Agenten starten, sollten Sie das Rapid Automation-Tracing durch Hinzufügen von ra=99 aktivieren. Dadurch erhalten Sie weitere Informationen zur Fehlerbehebung, wenn während der Installation ein Fehler auftritt. Nach erfolgreichem Agent-Start können Sie ra=0 festlegen und den Agent neu starten, um das Rapid Automation-Tracing zu deaktivieren.

      • connection

        Adresse des Kommunikationsprozesses im Automation Engine-System, mit dem sich der Agent selbst verbinden sollte. Das Format hierbei lautet:

        <DNS-Name oder TCP/IP-Adresse>:<Portnummer>

      Weitere Informationen finden Sie unter Agent RA Core.

      Der GC ComposerAgent ist ein AE-Hintergrundprogramm und wird in der Regel als Service im ServiceManager gestartet. Weitere Informationen finden Sie unter ServiceManager.

  4. Starten Sie 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. Starten Sie den Agenten auf dem Host mit den folgenden Befehlen:

      • Windows:

        <path to java> -Xrs -jar ucxjgcc.jar

        Wenn Java in einem Ordner installiert ist, der Leerzeichen enthält, muss das Kommando in Anführungszeichen gesetzt werden.

        Beispiel

        "C:\Program Files (x86)\Java\jre8\bin\java" -jar -Xrs -Xmx1G ucxjgcc.jar

      • UNIX:

        <Pfad zu Java> -jar ucxjgcc.jar

        Beispiel

        /usr/bin/java -jar ucxjgcc.jar

    3. Vergewissern Sie sich in AWI, Mandant 0, 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".

Verwenden Sie den ServiceManager, um den Agenten als Service zu starten oder zu beenden. Weitere Informationen finden Sie unter ServiceManager.

Arbeiten mit Agent for Google Cloud Composer

Sobald Sie die Installation beendet haben, ist der GC Composer in der Administration-Perspektive von Mandant 0 verfügbar.

Informationen zur Arbeit mit dem Agenten finden Sie unter:

Siehe auch: