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

Mit Applicationsserver

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

---

Agent für J2EE/JMX (JBoss) einrichten

In folgendem Dokument finden Sie Informationen zur Installation und Konfiguration eines J2EE/JMX Agenten mit einem JBoss - ApplicationServer.

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 für den 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.