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.

Diese Seite beinhaltet Folgendes:

Übersicht

Die RA Agent-Lösungen, die in diesem Abschnitt erwähnt werden, verwenden allgemeine Technologie, sodass das Installationsverfahren 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:

Installieren Sie den RA-Core-Agenten in Automic Automation.
Laden Sie die RA-Solution unter Verwendung des Dienstprogramms AE.DB Load.

Weitere Informationen finden Sie unter Installieren und Aktualisieren des Agenten.

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.

Installieren des RA-Core-Agenten

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.

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.

Stellen Sie sicher, dass Sie die Java-Anforderungen erfüllen, siehe Java-Anforderungen.
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 Agenten für Rapid Automation installieren.
Bearbeiten Sie die INI-Datei (ucxjcitx.ini), siehe Bearbeiten der INI-Datei (ucxjcitx.ini).
Laden Sie die entsprechende .jar-Datei mithilfe des Dienstprogramms AE.DB Load in die Datenbank, siehe Laden der RA-Solution (.jar-Datei) in die AE-Datenbank.
Erstellen Sie ein Agentenobjekt. Der RA-Agent wird nur gestartet, wenn ein Agentenobjekt mit demselben Namen in Mandant 0 vorhanden ist. Weitere Informationen finden Sie unter Mit Agenten arbeiten.
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)

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

Den Agenten installieren - Windows

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:

C:\automic\agents\ra_ftp

C:\automic\agents\ra_bo

C:\automic\agents\ra_ws

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.
Führen Sie die Datei setup.exe aus.
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

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
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.
Entpacken Sie die Datei ucxjcitx.tar.gz mit den folgenden Befehlen:

zip ucxjcitx.tar.gz

tar -xvf ucxjcitx.tar
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 Datei ucxjcitx.ini für den unten RA beschriebenen Agenten.

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.
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
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.
cp= 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>

Informationen zu den zusätzlichen Parametern in der Datei ucxjcitx.ini finden Sie in der INI-Datei Agent RA Core.

Nachfolgend ist ein Beispiel für die Datei ucxjcitx.ini gezeigt. 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

[RA]

cache_directory=cache

ext_directory=external

shared_directory=shared

lib_directory=lib

[TCP/IP]

connect=20

cp=localhost:2217

[AUTHORIZATION]

KeyStore=

InitialPackage=

[VARIABLES]

uc_host_jcl_var=RA

uc_ex_path_bin=.

uc_ex_path_temp=..\temp\

uc_ex_path_jobreport=..\temp\

[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

[CP_LIST]

2218=PC01

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

Sie müssen die RA-Solution (.jar-Datei ) unter Verwendung des Dienstprogramms AE.DB Load in die AE-Datenbank laden. Starten Sie dazu auf dem Hostcomputer das Dienstprogramm AE. DB Load und wählen Sie 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

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.

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