Agent für Java EE/JMX installieren (eigenständig)

Agent für Java EE/JMX installieren (eigenständig)

Agent für Java EE/JMX installieren (Application-Server)

---

Agent für J2EE/JMX einrichten

Der JMX-Agent kann auch außerhalb eines Applikationsservers laufen. Diese Installationsanleitung beschreibt welche Schritte dazu notwendig sind.

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/Agent/jmx or C:\AUTOMIC\Agent\jmx).

Beachten Sie vor der Installation, dass sich Java-Agenten nur zu CP-Ports bis maximal 65535 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, die zum J2EE/JMX Agenten gehören, finden Sie im Verzeichnis IMAGE:AGENTS\JMX.

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 JMX-Agenten an und kopieren Sie in diesen die ausgelieferten Dateien sowie den Unterordner "Logs". Es ist auch möglich, die Installation mit dem Programm SETUP.EXE durchzuführen, welches Sie im Auslieferungsverzeichnis des Agenten finden.
• Der JMX-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. Die Konfiguration erfolgt über die INI-Datei des Agenten.

	3.	Starten des Agenten

• Starten Sie den Agenten über die Kommandozeile (UNIX und Windows) mit folgendem Befehl: 

java -jar -Xrs -Xmx256M ucxjjmx.jar

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.

	4.	Wichtige Hinweise zum Anlegen von Jobs

• Host
• Wählen Sie in der Registerkarte "JMX" des Job-Objektes die Option Lokale Java VM aus.
• Die Unterpunkte "Benutze vorhandenen MBean Server" und "Erzeuge neue Instanz..." sind zu aktivieren.