Sie können das Verwaltungssystem von WebSphere Application Server
erweitern, indem Sie
in einem der WebSphere-Prozesse neue JMX-MBeans (Java™ Management Extensions) bereitstellen und registrieren.
(Ausführliche Informationen können Sie der Spezifikation JMX 1.x entnehmen.)
Informationen zu diesem Vorgang
JMX-MBeans repräsentieren die Administrationsschnittstelle für
eine bestimmtes Logiksegment.
Alle verwalteten Ressourcen in der Standardinfrastruktur des Produkts werden von
JMX-MBeans repräsentiert. Es gibt eine Vielzahl von
Möglichkeiten, eigene MBeans zu erstellen und bei dem in einem WebSphere-Prozess
ausgeführten JMX MBeanServer zu registrieren. Weitere Informationen finden Sie in Dokumentation
zu MBean-APIs (Java Application Programming). Klicken Sie in diesem Information
Center auf .
Vorgehensweise
- Erstellen Sie eigene JMX-MBeans.
Für das Erstellen von MBeans zur Erweiterung des
Produktverwaltungssystems gibt es verschiedene Möglichkeiten. Sie können eine vorhandene JMX-MBean
von einer anderen Anwendung verwenden. Sie können jede
MBean, die Sie in einem JMX-MBean-Server außerhalb der Umgebung von WebSphere Application Server getestet haben, in einem Produktprozess
registrieren. Dazu gehören Standard-MBeans, dynamische MBeans, offene MBeans und Modell-MBeans.
Neben den vorhandenen
und den außerhalb der Produktumgebung geschriebenen und getesteten MBeans können Sie die von WebSphere bereitgestellten
speziellen verteilten Erweiterungen nutzen und einen
WebSphere-ExtensionMBean-Provider erstellen. Diese Alternative ermöglicht eine bessere Integration
in alle verteilten Funktionen des Produktverwaltungssystems. Ein ExtensionMBean-Provider setzt voraus, dass
Sie eine XML-Datei mit einem auf der im Lieferumfang des Produkts enthaltenen DTD basierenden MBean-Deskriptor bereitstellen. Dieser Deskriptor
teilt dem WebSphere-System
mit, welche Attribute, Operationen und Benachrichtigungen von Ihrer MBean unterstützt werden. Ausgehend von diesen Informationen kann das WebSphere-System
ferne Anforderungen an Ihre
MBean weiterleiten und ferne Listener für den Empfang Ihrer MBean-Ereignisbenachrichtigungen registrieren.
Alle internen WebSphere-MBeans folgen dem Model-MBean-Muster.
Reine Java-Klassen stellen die reale Logik für Verwaltungsfunktionen bereit.
Die WebSphere-Klasse "MBeanFactory" liest die Beschreibung dieser Funktionen aus dem XML-MBean-Deskriptor und erstellt
eine dem Deskriptor entsprechende ModelMBean-Instanz. Diese ModelMBean-Instanz wird an Ihre Java-Klassen gebunden und
von dem
MBeanServer registriert, der in demselben Prozess wie Ihre Klassen ausgeführt wird. Jetzt kann Ihr Java-Code
von jedem Verwaltungsclient von WebSphere Application Server
über die
ModelMBean aufgerufen werden, die für ihn erstellt und registriert wurde.
- Definieren Sie optional
eine explizite Sicherheitsrichtlinie für MBeans.
Wenn Sie keine Sicherheitsrichtlinie
für MBeans
definieren, verwendet das Produkt die Standardsicherheitsrichtlinie.
- Registrieren Sie die neuen MBeans. Eine MBean kann auf verschiedene Arten registriert werden.
Sie können Ihre MBean mit dem Verwaltungsservice von WebSphere Application Server registrieren.
Sie können Ihre MBean mit dem MBeanServer bei einem Prozess von
WebSphere Application Server
registrieren. Die folgende
Liste beschreibt die verfügbaren Optionen in der Reihenfolge ihrer Priorität:
- Verwenden Sie die Klasse MBeanFactory. Wenn Sie eine größtmögliche Integration in das
System von WebSphere Application Server anstreben, verwenden Sie die Methoden activateMBean und deactivateMBean
der Klasse MBeanFactory, um den Lebenszyklus
Ihrer MBean zu verwalten. Geben Sie bei Verwendung dieser Methoden eine Unterklasse der abstrakten Superklasse
RuntimeCollaborator und eine XML-MBean-Deskriptordatei an. Mit diesem Ansatz stellen Sie eine reine Java-Klasse bereit, die
die im MBean-Deskriptor definierte Administrationsschnittstelle implementiert. Die Klasse MBeanFactory erstellt die eigentliche
ModelMBean und registriert sie für Sie beim Verwaltungssystem des Produkts.
Diese Option wird
für die Registrierung von Modell-MBeans empfohlen.
- Verwenden Sie die Schnittstelle "JMXManageable" und eine CustomService-Schnittstelle. Sie können die Integration in die
WebSphere-Administration noch einfacher gestalten, indem Sie eine
CustomService-Schnittstelle implementieren, die wiederum die Schnittstelle "JMXManageable" implementiert.
Bei diesem Ansatz müssen Sie nicht die Klasse RuntimeCollaborator bereitstellen. Wenn Ihre
CustomService-Schnittstelle initialisiert wird, liest die WebSphere-Klasse "MBeanFactory" Ihre
XML-MBean-Deskriptordatei und erstellt automatisch eine MBean, die dann ebenfalls automatisch an Ihre
CustomService-Schnittstelle gebunden und für diese registriert wird. Nach dem Aufrufen der Methode shutdown Ihrer
CustomService-Schnittstelle wird Ihre MBean automatisch vom Produktsystem inaktiviert.
- Verwenden Sie die Schnittstelle AdminService. Sie können für die Schnittstelle AdminService die Methode registerMBean()
aufrufen. Nach den erforderlichen Sicherheitsprüfungen wird dieser Aufruf dann an den dem Prozess zugrunde liegenden
MBeanServer delegiert.
Eine Referenz auf AdminService können Sie mit der Methode getAdminService()
der Klasse AdminServiceFactory abrufen.
Diese Option wird
für die Registrierung von Standard-MBeans, dynamischen MBeans und offenen MBeans empfohlen.
Implementieren Sie die Klasse "UserCollaborator", um MBeans zu verwenden und eine konsistente Unterstützung der MBeans
auf verteilten und z/OS-Plattformen zu erreichen.
- Rufen Sie direkt MBeanServer-Instanzen ab. Sie können eine direkte Referenz auf die
in einem Produktprozess aktive JMX-MBeanServer-Instanz anfordern. Rufen Sie dazu die
Methode getMBeanServer() der Klasse MBeanFactory auf. Eine Referenz auf die
Klasse MBeanFactory erhalten Sie, wenn Sie die Methode getMBeanFactory() der Schnittstelle
AdminService aufrufen.
Wenn eine angepasste MBean direkt beim MBean-Server registriert ist,
wird der Objektname der MBean standardmäßig mit dem Zellen-, Knoten- und Prozessnamen ergänzt.
Mit dieser Registrierung ist die MBean in der Lage, die verteilten Funktionen des
Verwaltungssystems zu nutzen.
Sie können das Standardverhalten mit der angepassten Eigenschaft
"com.ibm.websphere.mbeans.disableRouting" inaktivieren.
Weitere Informationen darüber, wie Sie die angepasste Eigenschaft
"com.ibm.websphere.mbeans.disableRouting" definieren und verwenden, finden Sie unter
Angepasste Eigenschaften für Verwaltungsservices
Ergebnisse
Regardless of the approach used to create and register
your MBean, you must set up proper Java 2 security permissions for
your new MBean code. Die WebSphere-Schnittstelle "AdminService" und der MBeanServer werden durch Java-2-Sicherheitsberechtigungen streng geschützt. Sollten Sie
Ihrem Code nicht explizit Basisberechtigungen einräumen, werden Sicherheitsausnahmen ausgelöst, wenn Sie versuchen, die Methoden dieser Klassen aufzurufen. Wenn Sie Ihre
MBean im Rahmen Ihrer Anwendung zur Verfügung stellen, können Sie die Berechtigungen in der Datei
was.policy festlegen, die Sie mit den Metadaten Ihrer Anwendung
bereitstellen. Falls Sie eine CustomService-Schnittstelle oder einen anderen, nicht als Anwendung zur Verfügung gestellten Code verwenden,
können Sie die Datei library.policy in der Knotenkonfiguration editieren oder auch die
Datei server.policy im Verzeichnis properties für eine bestimmte Installation.