Java-Klassen erstellen

Agenten installieren

Agent für SAP installieren

---

Agent für Rapid Automation einrichten

Die folgende Anleitung beschreibt die Installation des Agenten in einem Automation Engine System, das keine Authentifizierung einsetzt. Wenn Sie eine der Authentifizierungsmethoden nutzen möchten, sind noch zusätzliche Schritte nötig, bevor Sie den Agenten starten und einsetzen können. Lesen Sie Näheres im Dokument zur Advanced Security.

Installieren Sie den Agenten unbedingt in ein eigenes Verzeichnis (z.B: UC4/agents/rapidautomation bzw. C:\AUTOMIC\agents\rapidautomation).

Beachten Sie vor der Installation, dass sich Java-Agenten nur zu CP-Ports bis maximal 65536 verbinden können. Bei höheren Portnummern bricht der Agent beim Start mit einer entsprechenden Fehlermeldung ab. Diese Einschränkung ist durch Java bedingt und betrifft die Agenten für JMX, Datenbanken, SAP und RA.

Ausgelieferte Dateien

Die Dateien des RA-Agenten finden Sie im Verzeichnis IMAGE:AGENTS\RAPIDAUTOMATION.

Ablauf

	1.	Java Standard Edition installieren

Ist die Java Standard Edition bereits in der erforderlichen Version vorhanden, kann dieser Installationsschritt entfallen.

• Admin-Rechner und/oder Benutzer-Rechner
• Die Version der aktuellen Java Virtual Machine (VM) des Systems kann mit dem folgenden Kommando geprüft werden.

java -version

Sind mehrere Versionen von JRE oder Java SDK auf dem Rechner installiert, so ist bei der Einstellung von %PATH% bzw. $PATH darauf zu achten, dass die Reihenfolge der angegebenen Verzeichnisse relevant ist. Es wird die Java Runtime Umgebung verwendet, die in der Auflistung der Verzeichnisse zuerst gefunden wird.

• Laden Sie das erforderliche Java Runtime Environment von der Seite http://java.sun.com herunter und installieren Sie es.

	2.	Einrichten des Agenten

• Host
• Legen Sie einen eigenen Ordner für den RA-Agenten an und kopieren Sie in diesen die ausgelieferten Dateien. Unter Windows ist es auch möglich, die Installation mit dem Programm SETUP.EXE durchzuführen, welches Sie im Verzeichnis IMAGE:AGENTS\RAPIDAUTOMATION\WINDOWS finden.
• Die RA-Solution, die der Agent verwenden soll, wird in einem Ordner namens "cache" gespeichert. Legen Sie diesen Ordner im Installationsverzeichnis an.
• Der RA-Agent besitzt mehrere Einstellungen, die Sie an Ihre Systemumgebung anpassen können. Besonders wichtig sind hierbei der Name für den Agenten und der Rechnername sowie der Port des Kommunikationsprozesses, zu dem sich der Agent verbinden soll. Passen Sie die INI-Datei an.

	3.	Laden der RA-Solution

• Host
 
• Starten Sie das Dienstprogramm AE DB Load und wählen Sie die JAR-Datei der RA-Solution aus. Das Dienstprogramm lädt sie in die Datenbank. Die JAR-Datei kann über die grafische Oberfläche oder den Java-Batchmodus (ucybdbld.jar) des AE DB Load geladen werden. Unter Windows ist ein Laden mit dem Batchmodus (ucybdbld.exe) des AE DB Load nicht möglich!
• Nach dem Laden der RA-Solution müssen Sie das UserInterface neu starten.
•  Der RA-Agent kann sich nur zu einer RA-Solution verbinden. Möchten Sie mehrere RA-Solutions einsetzen, so benötigen Sie für jede einzelne einen eigenen RA-Agenten.
• Beachten Sie, dass dieselbe JAR-Datei einer RA-Solution nicht gleichzeitig in mehrere Systeme geladen werden kann! Ansonsten kann es zum Abbruch des AE DB Load kommen.

	4.	Verbindungs-Objekte einrichten

• Host
• Melden Sie sich am Systemmandanten 0000 an.
• Abhängig von der RA-Solution wurden beim Laden entweder eine oder mehrere Vorlagen für die benötigten Verbindungs-Objekte erzeugt und im Ordner "TEMPLATE" abgelegt. Legen Sie das oder die notwendigen Verbindungs-Objekte an und füllen Sie die Felder in deren Registerkarten aus. Sie werden in weiterer Folge für den RA-Agenten benötigt.

	5.	Starten des Agenten

• Host
• Der RA-Agent startet nur dann, wenn im Systemmandanten 0000 ein Agent-Objekt existiert, das genauso heißt wie er.
• Beim Laden der RA-Solution wurde eine Vorlage für zu verwendende Agenten-Objekte erzeugt und im Ordner "TEMPLATE" abgelegt. Erstellen Sie im Ordner "HOST" ein Agenten-Objekt und füllen Sie die Felder in dessen Registerkarten aus. Hier sind unter anderem die Verbindungs-Objekte einzutragen.
• Starten Sie den Agenten über die Kommandozeile (UNIX und Windows) mit folgendem Befehl:
  
  java -jar -Xrs -Xmx256M ucxjcitx.jar disable_cache
  
  

Wenn Sie die RA-Solution laden und kurz darauf den Agenten starten, kann es sein, dass Sie statt dem soeben geladenen einen zwischengespeicherten Agenten starten. Sie können dies vermeiden, indem Sie disable_cache an das Ende des Startbefehls hinzufügen. Auf diese Weise wird immer die geladene Version gestartet.

Der Agent kann auch mit dem ServiceManager gestartet werden.


Beachten Sie, dass beim Start der Java-Agenten (Datenbanken, RA, JMX, SAP) das Speicherlimit auf mindestens 256 MB (oder 512 MB) gesetzt werden sollte. Sie können den Wert für die Speicherbegrenzung von Java-Anwendungen mit dem Startparameter -XmX festlegen. Wird dieser Wert zu klein gewählt, kann es zum Absturz des Agenten kommen. Der Standardwert hängt von der verwendeten Java-Version ab.

Durch den Java-Parameter -Xrs wird sichergestellt, dass der Agent bei einer normalen Beendigung auch ordnungsgemäß endet. Wir empfehlen daher, diesen Parameter zu verwenden. Mehr Informationen dazu finden Sie in der Dokumentation von Java.

	6.	Wichtige Hinweise zum Anlegen von Jobs

• Host
• Das Laden der RA-Solution hat auch bewirkt, dass eine oder mehrere Vorlagen für Job-Objekte im Ordner "TEMPLATE" gespeichert wurden. Verwenden Sie diese für das Erstellen von Jobs für die RA-Solution.
• RA-Jobs enthalten kein Login-Objekt. Die Anmeldedaten werden bei der Installation in einem oder mehreren Verbindungs-Objekten hinterlegt. Diese sind im Agenten-Objekt auszuwählen.