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

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

Agent für Java EE/JMX (IBM WebSphere) mit RMI Connector einrichten

---

Agent für J2EE/JMX einrichten (Oracle Weblogic)

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

Ausgelieferte Dateien

Die Dateien, die zum J2EE/JMX Agenten gehören, finden Sie im Verzeichnis IMAGE:AGENTS\JMX.

Ablauf

	1.	Java Runtime Environment (JRE) installieren

Ist JRE 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.

Die Installation von Java kann entfallen, wenn der Agent auf dem selben Rechner läuft wie der Weblogic-Server (empfohlen).

	2.	JMX-Agenten einrichten

• Host
• Legen Sie einen eigenen Ordner für den JMX-Agenten an (bin) und kopieren Sie in diesen die ausgelieferten Dateien.
• 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.
• Kopieren Sie die Dateien wclient.jar und wljmxclient.jar aus dem Verzeichnis des Weblogic-Servers in den Installationsordner des Agenten. Diese müssen sich im selben Ordner wie die Datei ucxjjmx.jar befinden.
• Starten Sie den Agenten mit der Datei ucxjjmx.exe (Windows) oder über die Kommandozeile (UNIX und Windows) mit folgendem Befehl:

java -jar ucxjjmx.jar

Der Agent kann auch mit dem ServiceManager gestartet werden.

	3.	Wichtige Hinweise zum Anlegen von Jobs

• Host
• In der Registerkarte "JMX" des Job-Objektes muss "Remote Java VM" ausgewählt werden.
• Tragen Sie unbedingt im Feld Initial Context Factory die Bezeichnung "weblogic" ein.
• Für die Server URL ist der Weblogic-Server in folgendem Format anzugeben:

Name des Weblogic-Servers:Port des Weblogic-Servers

Der Agent läuft natürlich auch ohne Verbindung zum Oracle Weblogic-Server. Wählen Sie in diesem Fall in den Job-Objekten die Option Lokale Java VM und Benutze vorhandenen MBean Server aus.

Standard-Port des Weblogic-Servers ist 7001.