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

Mit Applicationsserver

Agent für Java EE/JMX (JBoss) einrichten

---

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

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

Diese Installationsanleitung gilt für WebSphere Version 6.0, wenn die Verwaltungsicherheit (Administrative security) aktiviert ist.

	1.	JMX-Agenten einrichten

• Host
• Wählen Sie auf der WebSphere-Oberfläche den Menüpunkt Anwendungen -> Neue Anwendung installieren.
• Geben Sie bei "Lokales Dateisystem" den Pfad zur ucxjjmx.war an. Der "Stammkontext" dient zur Benennung der Application.

• Im nächsten Fenster kann die Option Standardbindungen generieren aktiviert werden. Die anderen Einstellungen können Sie, sofern gewünscht, auch konfigurieren.
• Folgen Sie dem Installationsablauf, bis Sie zu den einzelnen Schritten gelangen. Im Schritt 4 muss bei administrators die Option "Jeder?" ausgewählt sein.

• Nach diesen sechs Schritten kann der Installationsvorgang mit der Schaltfläche Fertig stellen beendet werden. Das Protokoll zeigt, ob die Installation erfolgreich war.
• Klicken Sie auf den Link In Master-Konfiguration speichern und anschließend auf Speichern.
• Rufen Sie den Menüpunkt Anwendungen -> Enterprise-Anwendungen. In der Liste scheint auch der Agent auf.

	2.	Konfigurieren der INI-Datei

• Host
• Suchen Sie im WebSphere Ordner die Datei ucxjjmx.ini.
• Öffnen Sie die INI-Datei und fügen Sie am Ende eine neue Sektion namens [WEBSPHERE] mit den folgenden Parametern ein.

[WEBSPHERE]
javax.net.ssl.trustStore=C:\DummyClientTrustFile.jks
javax.net.ssl.keyStore=C:\DummyClientKeyFile.jks

• Passen Sie die Werte für die javax.* Properties entsprechend Ihrer Umgebung an.
• Speichern und schließen Sie die INI-Datei.

Dieser Installationsschritt ist ab Websphere Version 7 optional. Wird dieser Schritt ausgelassen, so ist jedoch im Job-Objekt in der Registerkarte JMX im Feld Initial Context Factory unbedingt der Wert "websphere_soap" einzutragen!

	3.	Starten des Agenten

• Host
• Starten Sie die Agentanwendung über die WebSphere Console.

	4.	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/Stammkontext

• Passen Sie die Einstellungen des JMX-Agenten an Ihre Systemumgebung an. Wichtig sind vor allem:
• Agentenname
• 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.

• Starten des Agenten
• Klicken Sie auf den Link View log files und wählen Sie die aktuellste Logdatei auf. Diese trägt die Nummerierung "00". Die Sektion [WEBSPHERE] muss in der Logdatei enthalten sein.

	5.	Wichtige Hinweise zum Anlegen von Jobs

• Host
• Der Agent verwendet nun den SOAP Connector. In der Registerkarte JMX des Job-Objektes muss daher "Remote Java VM" ausgewählt werden.
• Tragen Sie unbedingt im Feld "Initial Context Factory" die Bezeichnung "websphere" ein.

Hostname des WebSpheres:SOAP Port

•  Die Portnummer ermitteln Sie wie folgt: Klicken Sie auf Servers -> Anwendungsserver, danach auf Ihren Server. Wählen Sie "Übertragungen" -> "Ports". Verwenden Sie in der URL die Portnummer, die hier vermerkt ist. Der Standardwert des SOAP Ports ist 8880.
• Im Login-Objekt des Jobs müssen drei Passwörter mit Komma getrennt eingetragen werden.
• Das 1. Passwort ist das Passwort des Benutzers.
• Das 2. Passwort ist das Passwort des Keystores.
• Das 3. Passwort ist das Passwort des Truststores.