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

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

Agent für Java EE/JMX (Oracle-Container für Java EE) einrichten

---

Agent für J2EE/JMX (JBoss) 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.

Ausgelieferte Dateien

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

Ablauf

	1.	JMX-Agenten einrichten

• Host
• Kopieren Sie die Datei ucxjjmx.war in einen Ordner und entpacken Sie diese mit einem entsprechenden Programm.
• Passen Sie anschließend in der Konfigurationsdatei web.xml zwei Parameter an:

<load-on-startup> - Stellen Sie sicher, dass der Wert immer auf 1 steht. Ansonsten wird der Agent nicht geladen und kann daher nicht gestartet werden.

<run-as><role-name> - Möchten Sie Rollen verwenden, so können Sie diesen Parameter konfigurieren. Im Abschnitt zur Sicherheit ist dann die Rolle ebenfalls einzutragen bzw. zu löschen (<security-role>).

• Danach muss der Ordner in dem sich die Dateien des Agenten befinden so umbenannt werden, dass er mit ".war" endet.

Beispiel für den Ordnernamen: ucxjjmx.war

• Verschieben Sie den Ordner in das Deploy-Verzeichnis von JBoss. Der Agent wird automatisch deployed und die folgende Meldung als Bestätigung ausgegeben:

445 INFO  [TomcatDeployer] deploy, ctxPath=/ucxjjmx, warUrl=file:/C:/jboss-3.2.7/server/default/deploy/ucxjjmx.war/

	2.	Verwenden der Konfigurations-Weboberfläche

• Host
• Der JMX-Agent besitzt eine Konfigurations-Weboberfläche die Sie in einem Webbrowser über die folgende Adresse aufrufen können:

http://Servername:Port/ucxjjmx/uc4jmx

In der Adresse wurde ucxjjmx verwendet, da auch der Ordnerteil vor ".war" ucxjjmx genannt worden ist. Haben Sie eine andere Bezeichnung gewählt, muss die Adresse entsprechend anders aufgerufen werden.

• Passen Sie die Einstellungen des JMX-Agenten an Ihre Systemumgebung an. Wichtig sind vor allem:
• Name des Agenten
• Name des Rechners auf dem sich ein Kommunikationsprozess befindet
• Portnummer eines Kommunikationsprozesses

• Beachten Sie, dass die Konfigurationsdatei beim erneuten Deployment der WAR-Datei überschrieben wird, wodurch die Konfiguration erneut durchgeführt werden muss. Sie haben auch die Möglichkeit, die Konfigurationsdatei (INI-Datei) vor dem Deployment wegzusichern und anschließend wieder in den Ordner der Webanwendung zu kopieren.

	3.	Wichtige Hinweise zum Anlegen von Jobs

• Host
• Wählen Sie in der Registerkarte "JMX" des Job-Objektes die Option Lokale Java VM aus.
• Der Unterpunkt "Benutze vorhandenen MBean Server" ist zu aktivieren.
• Die Option "Erzeuge neue Instanz..." muss nicht ausgewählt werden.