Agenten für Rapid Automation installieren

Rapid Automation (RA) bezieht sich auf eine generische Technologie in Automic Automation, die verschiedene Lösungen zur Integration und Automatisierung von Drittanbieteranwendungen ermöglicht. Rapid Automation-Agenten machen die Funktionen einer Rapid Automation-Lösung zugänglich.

Sie können einen Rapid Automation-Agenten in einem Container ausführen, indem Sie ein Docker-Image erstellen und ausführen, das den Agenten hosten soll. Sie können sie entweder für ein lokales Automic Automation-System oder eine Automic Automation Kubernetes Edition-Umgebung verwenden. Die Installation des RA Core-Agenten in einem Container ist mit der Installation eines beliebigen Java-Agenten identisch.

Tipp! Die Installationsanweisungen für den Agenten auf dieser Seite beziehen sich nur auf den manuellen Installationsprozess. Anweisungen zum Installieren des RA Core-Agenten in einem Container finden Sie unter Container-Java-Agenten installieren.

Die Enterprise Software Academy enthält Beispiele zum Bereitstellen eines Automic Automation Java-, Windows- oder UNIX-Agenten in einem Container. Um auf diese zusätzlichen Informationen zuzugreifen, wählen Sie den entsprechenden Link aus:

Diese Seite beinhaltet Folgendes:

Übersicht

Alle RA-Agentenlösungen verwenden eine gemeinsame Technologie, sodass die Installationsprozedur für jede von ihnen ähnlich ist. Für jede Agentenlösung gibt es jedoch spezifische Anforderungen und Installationsschritte. Darüber hinaus gibt es oft unterschiedliche Anforderungen und Installationsschritte für verschiedene Versionen derselben Agentenlösung, die für verschiedene Automation Engine-Releases unterstützt werden.

Wichtig! Der RA Core-Agent muss die gleiche Version wie die Automation Engine haben, oder eine Version niedriger. Sie können den Core-Agent aktualisieren, indem Sie aktualisierte Dateien für eine Automation Engine-Version abrufen, indem Sie das Image für diese Version von unserem Download-Center unter https://downloads.automic.com/ herunterladen und die Agent-Dateien wie auf dieser Seite beschrieben an ihre Position kopieren.

RA Agenten bestehen aus zwei Komponenten:

  • dem RA Core Agent, das allgemeine -Agenten-Framework , das für Rapid Automationeine beliebige RA-Lösung verwendet werden kann

  • der RA-Lösung, die die Geschäftslogik für die Integration mit Anwendungen von Drittanbietern enthält.

Um eine Rapid Automation-Agenten-Lösungen erfolgreich bereitzustellen, müssen Sie die folgenden zwei Schritte durchführen:

  1. Installieren Sie den RA Core-Agenten in Automic Automation entweder:

    In beiden Fällen können Sie den Agent für ein lokales Automic Automation-System oder eine Automic Automation Kubernetes Edition-Umgebung verwenden.

  2. Laden Sie die RA-Lösung in die AE-Datenbank mithilfe des Dienstprogramms AE.DB Load oder des Endpunkts system/ra-solutions/ der AE-REST-API.

Der RA Core-Agent kann nur eine RA-Solution aus der AE-Datenbank erhalten. Das heißt, der RA Core Agent erhält nur eine Solution, selbst wenn Sie verschiedene RA-Solutions in die AE-Datenbank geladen haben. Das gleiche gilt für verschiedene Versionen der gleichen RA-Solution. Wenn Sie also beabsichtigen, mehrere RA-Solutions zu verwenden, beachten Sie, dass jede Solution und/oder jede Version der gleichen Solution einen eigenen RA Core-Agenten erforderlich macht.

Beispiel

Wenn Sie nur einen RA Core-Agenten installiert haben und er die RA REST-Solution von der AE-Datenbank erhält, wird er zum RAREST-Agenten,  und es ist kein RA Core-Agent mehr verfügbar.

Wenn Sie zwei RA Core-Agenten installiert haben und beide die RA REST-Solution von der AE-Datenbank erhalten, werden diese beide zu RA REST-Agentent.

Wenn Sie dann mit dem Laden der nächsten Version der RA REST-Solution in die AE-Datenbank fortfahren, wird die Version überschrieben. Beim nächsten Start der RA REST-Agenten ist die Version der aktualisierten RA REST-Solution verfügbar.

Der RA-Agent prüft beim Start, ob die RA-Solution lokal gespeichert ist. Ist dies nicht der Fall, so fordert er die JAR-Datei der RA-Solution bei der Automation Engine an. Der RA-Agent entpackt sie im cache-Ordner, wie im Parameter cache_directory= im Abschnitt [RA] der INI-Datei des RA-Core-Agenten angegeben (siehe INI-Datei Agent RA Core). Der Name des Unterordners, den er dabei anlegt, trägt das letzte Änderungsdatum des RA-Solution Objektes. Beim Start wird geprüft, ob dieser Zeitstempel mit jenem in der AE-Datenbank übereinstimmt. Sind sie unterschiedlich, weil Sie in der Zwischenzeit eine neuere Version in die AE-Datenbank geladen haben, fordert der RA-Agent die JAR-Datei ebenfalls an und ersetzt die lokale RA-Solution.

Es sind mehrere Rapid Automation-Lösungen verfügbar, darunter: 

Sie können auch über https://docs.automic.com/documentation auf die RA-Agentendokumentation zugreifen.

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.

Hinweis: Die TLS/SSL-Implementierung gilt nicht für den HP-UX-Agenten, da er in dieser Version nicht mehr unterstützt wird.

Sie können die Parameter trustedCertFolder=, agentSecurityFolder= und keyPassword= in der jeweiligen INI-Datei verwenden, 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?

TLS/SSL-Agenten (in Containern und lokal) und das TLS Gatewayrichten bei Verwendung für die Automic Automation Kubernetes Editioneine Verbindung zu einem Ingress-/HTTPS-Load Balancer ein, und nicht direkt zum JCP. Der Ingress-/HTTPS-Load Balancer muss erreichbar sein und benötigt ein Zertifikat zur Authentifizierung. Die Adresse des Load Balancers muss auf beiden Seiten definiert werden: Automation Engine und Agent/TLS Gateway.

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.

Den RA Core-Agenten installieren

Dieser Abschnitt führt Sie durch die Installation des Rapid Automation-Core-Agenten, der für Rapid Automation-Solutions in einem vorhandenen Automation Engine-System verwendet wird.

Wichtig! Der RA Core-Agent muss die gleiche Version wie die Automation Engine haben, oder eine Version niedriger. Sie können den Core-Agent aktualisieren, indem Sie aktualisierte Dateien für eine Automation Engine-Version abrufen, indem Sie das Image für diese Version von unserem Download-Center unter https://downloads.automic.com/ herunterladen und die Agent-Dateien wie auf dieser Seite beschrieben an ihre Position kopieren.

Mitgelieferte Dateien

Die Dateien, die für die RA-Core-Agenten-Installation unter Windows und UNIX relevant sind, werden unter \Automation.Platform\Agents\rapidautomation\Core gespeichert. Dieser Ordner enthält u. a. alle Dateien, die für die Installation des RA-Core-Agenten relevant sind:

  • ucxjcitx.jar: Core-Agent für Rapid Automation

  • ucxjcitx.ini: Rapid Automation Konfigurationsdatei

  • *.jar: Bibliotheken

  • uc.msl: Meldungsbibliothek

  • setup.exe: Ausführbare Windows-Installation für den RA-Core-Agenten.

  • ucxjcitx.sh: UNIX-Installationsdatei für den RA-Core-Agenten (in der Datei ucxjcitx.tar.gz enthalten)

Installieren und Aktualisieren des Agenten

Um den Rapid Automation-Core-Agenten zu einrichten, führen Sie die unten beschriebenen Schritte durch.

Hinweis: Die Agenten können nur eine Verbindung zu TCP-Portnummern unter 65536 herstellen. Wenn sie eine höhere Portnummer verwenden, kann der Agent nicht starten und bricht mit einer Fehlermeldung ab. Diese Einschränkung wird durch Java verursacht und betrifft die Rapid Automation-Agenten.

  1. Stellen Sie sicher, dass Sie die Java-Anforderungen erfüllen, siehe Java-Anforderungen.

  2. Legen Sie die Datei(en) für die Core-Agenten auf dem Hostcomputer ab und führen Sie die relevante Installationsdatei aus: setup.exe für Windows und ucxjcitx.sh für UNIX, siehe Den RA Core-Agenten installieren.

  3. Bearbeiten Sie die INI-Datei (ucxjcitx.ini), siehe Bearbeiten der INI-Datei (ucxjcitx.ini).

  4. Laden Sie die relevante .jar-Datei unter Verwendung des Dienstprogramms AE.DB Load oder des Endpunkts system/ra-solutions/ des AE REST API in die Datenbank, siehe Laden der RA-Solution (.jar-Datei) in die AE-Datenbank.

  5. Erstellen Sie ein Agentenobjekt. Der RA-Agent wird nur gestartet, wenn ein Agenten-Objekt mit demselben Namen in Mandant 0 vorhanden ist. Weitere Informationen finden Sie unter Agenten hinzufügen und konfigurieren.

  6. Starten Sie den Agenten, siehe Den Agenten starten.

Wichtig! Einige RA-Solutions haben möglicherweise zusätzliche Java-Anforderungen, erfordern möglicherweise zusätzliche Installationsschritte (wie zum Beispiel das Einstellen von Umgebungsvariablen) oder bieten möglicherweise andere Optionen für das Starten des Agenten. Weitere Informationen zu einer bestimmten RA-Solution finden Sie in der Dokumentation zu en entsprechenden RA-Solutions unter https://docs.automic.com/documentation.

Java-Anforderungen

Informationen zu unterstützten Java-Versionen finden Sie in der (missing or bad snippet)

  1. Installieren Sie auf dem Host und jedem Rechner, auf dem eine Automation Engine-Benutzeroberfläche installiert ist, die Java Runtime Environment (JRE).

    Sie können die erforderliche JRE von https://www.oracle.com/java/technologies/ herunterladen. Damit wird automatisch das Java-Plugin für Webbrowser installiert. Sie können es in der Systemsteuerung deaktivieren, da es von der AE nicht benötigt wird. Wenn die JRE bereits installiert ist, können Sie diesen Schritt ignorieren.

    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.

  2. Der Agent benötigt eine unterstützte Java-Version auf dem Agenten-Rechner und allen Rechnern, auf denen die Benutzeroberfläche installiert ist. Wenn eine unterstützte Version von Java nicht der Standard oder die Benutzeroberfläche ist, kann sie in der Datei ucdj.ini wie folgt angegeben werden:

    cmd="C:\Program Files (x86)\Java\jre<version>\bin\javaw" -Xmx1024m -Dsun.locale.formatasdefault=true - com.uc4.ucdf.UCDialogFactory - U%User%

  3. Auf dem Agenten-Computer ist der explizite Pfad zu einer unterstützten Version der Java JDE oder des JDK im Befehl erforderlich, um den Agenten zu starten. Zum Beispiel:

    /etc/alternatives/jdk<version>/bin/java -Xmx2048m -jar ucxjcitx.jar disable_cache

Hinweis: Einige RA-Solutions können zusätzliche Java-Anforderungen haben. Weitere Informationen finden Sie in der Dokumentation zu den entsprechenden RA-Solutions unter https://docs.automic.com/documentation.

Verschieben von Kerndateien und Installieren des Agent

Sie müssen die Core-Dateien für den Agenten auf dem Hostcomputer speichern und jeden RA-Agenten in seinem eigenen Unterverzeichnis installieren.

Wichtig! Der RA Core-Agent muss die gleiche Version wie die Automation Engine haben, oder eine Version niedriger. Sie können den Core-Agent aktualisieren, indem Sie aktualisierte Dateien für eine Automation Engine-Version abrufen, indem Sie das Image für diese Version von unserem Download-Center unter https://downloads.automic.com/ herunterladen und die Agent-Dateien wie auf dieser Seite beschrieben an ihre Position kopieren.

Den Agenten installieren - Windows

  1. Erstellen Sie auf dem Hostcomputer ein Verzeichnis für den Agenten. Wir empfehlen dringend, jeden RA-Agententyp auf dem gleichen Host im eigenen Unterverzeichnis zu installieren.

    Beispiel:

  2. C:\automic\agents\ra_ftp

    C:\automic\agents\ra_bo

    C:\automic\agents\ra_ws

  3. Kopieren Sie die Dateien im Unterverzeichnis \Automation.Platform\Agents\rapidautomation\Core\windows\x86 von unserem Download-Center unter https://downloads.automic.com/ in das Unterverzeichnis, das Sie für diesen Agenten erstellt haben.

  4. Führen Sie die Datei setup.exe aus.

  5. Löschen Sie für RA Web Service SOAP Agent, RA Web Service REST Agent, RA Hyperion FM Agent, RA Hyperion FDMEE Agent, RA Hyperion EPMA Agent und RA Hyperion ESSBASE Agent den Inhalt des lib-Ordners. Der Ordner sollte leer bleiben.

Den Agenten installieren - UNIX

  1. Erstellen Sie auf dem Hostcomputer ein Verzeichnis für den Agenten. Wir empfehlen dringend, jeden RA-Agententyp auf dem gleichen Host im eigenen Unterverzeichnis zu installieren.

    Beispiel:

    automic/agents/ra_ftp

    automic/agents/ra_bo

    automic/agents/ra_ws

  2. Kopieren Sie die Datei ucxjcitx.tar.gz im Unterverzeichnis \Automation.Platform\Agents\rapidautomation\Core\unix von unserem Download-Center unter https://downloads.automic.com/ in das Unterverzeichnis, das Sie für diesen Agenten erstellt haben.

  3. Entpacken Sie die Datei ucxjcitx.tar.gz mit den folgenden Befehlen:

    zip ucxjcitx.tar.gz

    tar -xvf ucxjcitx.tar

  4. Löschen Sie für RA Web Service SOAP Agent, RA Web Service REST Agent, RA Hyperion FM Agent, RA Hyperion FDMEE Agent, RA Hyperion EPMA Agent und RA Hyperion ESSBASE Agent den Inhalt des lib-Ordners. Der Ordner sollte leer bleiben.

Bearbeiten der INI-Datei (ucxjcitx.ini)

Bearbeiten Sie die erforderlichen Parameter in der INI-Datei des RA Core-Agenten. Weitere Informationen finden Sie unter Agent RA Core - INI-Datei.

[GLOBAL]

  • name= Name des Agenten-Objekts. Agentennamen sind auf 32 der folgenden Zeichen beschränkt: "A-Z", "0-9", "_", ".", "$", "@", "-" and "#".

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

    Obwohl Agent-Namen auf 32 Zeichen beschränkt sind, sollten Sie sie unter 25 Zeichen halten. Die letzten sieben Zeichen werden für das Hinzufügen des Suffixes '.NEW.nn' verwendet, wenn ein neuer Agent aus seiner Vorlage erstellt wird.

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

[TRACE]

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

[TCP/IP]

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

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

[AUTHORIZATION]

  • trustedCertFolder= Pfad zum Ordner, in dem die vertrauenswürdigen Zertifikate gespeichert sind

    Wenn dieser Parameter nicht festgelegt ist, müssen die Zertifikate im jeweiligen Store installiert werden; dies ist der Java-Trust-Store.

  • agentSecurityFolder= Pfad zum Ordner, in dem der Agent sicherheitsbezogene Dateien wie private Schlüssel, signierte Zertifikate, Stammzertifikate usw. speichert

  • keyPassword= Passwort für den Schlüssel

    Standardwert: changeit

    Wenn der Wert nicht definiert ist oder leer bleibt, verwendet das System den Standardwert.

    Hinweis: Das keyPassword kann mit dem Dienstprogramm UCYBCRYP verschlüsselt werden. Weitere Informationen finden Sie unter Passwörter codieren.

[RA]

  • cache_directory= Verzeichnis, in dem der Agent die RA-Solutions speichern soll. Dies wird standardmäßig auf den Cache festgelegt und muss nicht geändert werden, es sei denn, Sie möchten es ändern.

  • lib_directory= Verzeichnis, das externe Bibliotheken enthält, die nicht Teil der Solution sind (z. B. ojdbc6.jar).

    Standard: lib

Beispiel ucxjcitx.ini

Die erforderlichen Parameter sind in Fettschrift angezeigt:

[GLOBAL]

name=RA01

system=AE

logcount=10

logging=../temp/RA_LOG_##.TXT

;LogMaxSize: 0...default, qualifiers k...Kilo, M...Mega, G...Giga

LogMaxSize = 0

language=E

helplib=uc.msl

 

[TRACE]

file=..\temp\RA_TRACE_##.TXT

;TraceMaxSize: 0...default, qualifiers k...Kilo, M...Mega, G...Giga

TraceMaxSize=0

tcp/ip=0

ra=99

trccount=10

 

[TCP/IP]

connection=jcphost:8443

connect=20

 

[AUTHORIZATION]

initialPackage=

trustedCertFolder=

agentSecuriyFolder=

keyPassoword=

 

[RA]

cache_directory=cache

ext_directory=external

shared_directory=shared

lib_directory=lib

 

[VARIABLES]

uc_host_jcl_var=RA

uc_ex_path_bin=.

uc_ex_path_temp=..\temp\

uc_ex_path_jobreport=..\temp\

 

[JCP_LIST]

JCP1=8843

Laden der RA-Solution (.jar-Datei) in die AE-Datenbank

Sie müssen die RA-Solution (.jar-Datei) in die AE-Datenbank laden. Dazu können Sie das Dienstprogramm AE.DB Load oder den Endpunkt system/ra-solutions/ des AE-REST-API verwenden, siehe REST-API-Referenz.

Um das Dienstprogramm AE.DB Load zu verwenden, starten Sie auf dem Host-Computer das Dienstprogramm AE.DB Load und wählen die .jar-Datei des Agenten aus. Das Dienstprogramm lädt es in die Automation Engine-Datenbank.

Hinweis: Sie müssen den .jar-Loader (ucybdbld.jar) verwenden. Das Laden mit dem Dienstprogramm unter Verwendung der binären ausführbaren Dateien (ucybdbld.exe für Windows oder ucybdbld für Unix) im Batch-Modus ist nicht möglich.

Beispiel

java -jar ucybdbld.jar -B -C0000 -X<Pfad><RA_Solution>.jar

Der RA Core-Agent kann nur eine RA-Solution aus der AE-Datenbank erhalten. Das heißt, der RA Core Agent erhält nur eine Solution, selbst wenn Sie verschiedene RA-Solutions in die AE-Datenbank geladen haben. Das gleiche gilt für verschiedene Versionen der gleichen RA-Solution. Wenn Sie also beabsichtigen, mehrere RA-Solutions zu verwenden, beachten Sie, dass jede Solution und/oder jede Version der gleichen Solution einen eigenen RA Core-Agenten erforderlich macht.

Beispiel

Wenn Sie nur einen RA Core-Agenten installiert haben und er die RA REST-Solution von der AE-Datenbank erhält, wird er zum RAREST-Agenten,  und es ist kein RA Core-Agent mehr verfügbar.

Wenn Sie zwei RA Core-Agenten installiert haben und beide die RA REST-Solution von der AE-Datenbank erhalten, werden diese beide zu RA REST-Agentent.

Wenn Sie dann mit dem Laden der nächsten Version der RA REST-Solution in die AE-Datenbank fortfahren, wird die Version überschrieben. Beim nächsten Start der RA REST-Agenten ist die Version der aktualisierten RA REST-Solution verfügbar.

Den Agenten starten

Der Agent wird nur gestartet, wenn in Mandant 0 ein Agentenobjekt mit demselben Namen vorhanden ist. Eine Vorlage für die Agentenobjekte ist im Ordner TEMPLATE gespeichert.

Sie können den folgenden Befehl verwenden, um den Agent zu starten:

java -jar -Xrs -Xmx2048m ucxjcitx.jar disable_cache

Für den RA Web Service REST Agent und den RA Web Service SOAP Agent verwenden Sie den folgenden Befehl:

/etc/alternatives/jdk1.7.0_45/bin/java  -Xmx2048m  -jar ucxjcitx.jar disable_cache

Sie können den Agent auch unter Verwendung des ServiceManagers starten. Weitere Informationen finden Sie unter ServiceManager.

Wichtig! Webservice-Agenten müssen über das Service Manager-Programm gestartet werden. Wenn Sie sie von der Kommandozeile aus starten, erhalten Sie Fehler bei der Adapterkompilierung.

Wenn Sie die relevante Rapid Automation-Solution laden und den Agent kurz danach starten, erhalten Sie möglicherweise einen im Cache zwischengespeicherten Agenten statt dem gerade geladenen. Sie können dies vermeiden, indem Sie disable_cache am Ende des Startbefehls hinzufügen. Auf diese Weise wird immer die geladene Version gestartet.

Hinweis: Einige RA-Lösungen haben möglicherweise zusätzliche Optionen oder Anforderungen für das Starten des Agenten. Weitere Informationen finden Sie in der Dokumentation zu den entsprechenden RA-Solutions unter https://docs.automic.com/documentation.

Siehe auch:

Agenten installieren