Verwaltungssystem von WebSphere Application Server mit angepassten MBeans erweitern

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 Referenz > MBean-Schnittstellen.

Vorgehensweise

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

  2. Definieren Sie optional eine explizite Sicherheitsrichtlinie für MBeans.

    Wenn Sie keine Sicherheitsrichtlinie für MBeans definieren, verwendet das Produkt die Standardsicherheitsrichtlinie.

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


Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=tjmx_extend
Dateiname:tjmx_extend.html