Liste der bereitgestellten MBeans
Das Liberty-Profil enthält eine Liste von MBeans und entsprechenden Verwaltungsschnittstellen, die Sie verwenden können, um den Server zu bearbeiten und zu überwachen.
- Der Name ist der javax.management.ObjectName-Wert, der die MBean bzw. MXBean eindeutig identifiziert. Wenn es mehrere Instanzen einer MBean oder MXBean, gibt, kann der ObjectName-Wert ein Platzhalterzeichen (*) enthalten, das in den Kommentaren in diesem Abschnitt beschrieben ist.
- Die Einträge der Verwaltungsschnittstelle geben den Namen der Java™-Schnittstelle an, die verwendet werden kann, um ein Proxy-Objekt für die MBean bzw. MXBean zu erstellen. Informationen hierzu finden Sie unter Beispiele für den Zugriff auf MBean-Attribute und -Operationen. Weitere Informationen zur Managementschnittstelle finden Sie im Java-API-Dokument für Liberty Profile. Ausführliche Informationen zur Java-API-Dokumentation für die einzelnen APIs von Liberty Profile finden Sie im Information Center im Abschnitt Programmierschnittstellen (APIs). Die Java-API-Dokumentation ist außerdem als eigenständige .zip-Datei in einem der Javadoc-Unterverzeichnisse des Verzeichnisses ${wlp.install.dir}/dev verfügbar.
WebSphere:feature=channelfw,type=endpoint,name=*
- Verwaltungsschnittstelle: com.ibm.websphere.endpoint.EndPointInfoMBean
- Kommentar: Für jeden Endpunkt im System ist eine Instanz verfügbar. * steht für einen eindeutigen Endpunktpunktnamen.
WebSphere:feature=restConnector,type=FileService,name=FileService
- Verwaltungsschnittstelle: com.ibm.websphere.filetransfer.FileServiceMXBean
- Kommentar: Mit dieser MXBean können Sie verschiedene dateibezogene Operationen auf dem Host ausführen, auf dem sich
Liberty befindet. Sie finden die zugehörige Klasse und API-Dokumentation an den folgenden Positionen:
liberty_home/dev/api/ibm/com.ibm.websphere.appserver.api.restConnector_Version.jar Liberty-Ausgangsverzeichnis/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.restConnector_Version-javadoc.zip
Zu den verfügbaren Operationen gehört die Möglichkeit, bestimmte Metadaten (letztes Änderungsdatum, Größe usw.) für eine bestimmte Datei oder ein bestimmtes Verzeichnis und alle untergeordneten Dateien (und die zugehörigen Metadaten) für ein bestimmtes Verzeichnis abzufragen. Die Unterstützung für die Erstellung und Erweiterung von Archiven wird ebenfalls bereitgestellt und kann hilfreich sein, um Liberty-Protokolldateien zu komprimieren oder eine Anwendung vor der Implementierung zu extrahieren.
Diese MXBean enthält zwei Attribute: die Leseliste und die Schreibliste. Diese beiden Attribute stellen die Listen mit den Positionen dar, auf die Benutzer Lese- bzw. Schreibzugriffe durchführen können, wenn die von Liberty bereitgestellte Funktion FileService oder FileTransfer verwendet wird. Mit der MXBean können diese Attribute nur gelesen werden, aber sie können mithilfe der folgenden Elemente in der Datei server.xml konfiguriert oder angepasst werden:
Wenn das Element readDir nicht angegeben ist, wird standardmäßig die Kombination von ${wlp.install.dir}, ${wlp.user.dir} und ${server.output.dir} verwendet. Wenn kein Element writeDir angegeben ist, wird standardmäßig eine leere Gruppe verwendet.<remoteFileAccess> <readDir>${server.output.dir}/logs</readDir> <readDir>${server.output.dir}/apps</readDir> <writeDir>${server.output.dir}/dropins</writeDir> </remoteFileAccess>
Das Feature restConnector-1.0 muss in die Datei server.xml eingeschlossen werden, damit diese MXBean geladen wird und die in dieser MXBean enthaltenen Konfigurationselemente berücksichtigt werden.
Die Verwendung von Variablen, die in Liberty definiert sind, ist für alle serverseitigen Parameter zulässig, die eine Zeichenfolge akzeptieren, die einen Dateipfad darstellt. Solche Variablen sind in der Datei Liberty-Ausgangsverzeichnis/README.TXT definiert.
WebSphere:feature=restConnector,type=FileTransfer,name=FileTransfer
- Verwaltungsschnittstelle: com.ibm.websphere.filetransfer.FileTransferMBean
- Kommentar: Mit dieser MBean können Sie verschiedene Dateiübertragungsoperationen auf dem Host ausführen, auf dem sich
Liberty befindet. Sie finden die zugehörige Klasse und API-Dokumentation an den folgenden Positionen:
Liberty-Ausgangsverzeichnis/dev/api/ibm/com.ibm.websphere.appserver.api.restConnector_Version.jar Liberty-Ausgangsverzeichnis/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.restConnector_Version-javadoc.zip
Diese MBean wird in PlatformMBeanServer über dieselbe JVM registriert, in der der entsprechende Liberty-Prozess ausgeführt wird, aber sie kann nur mit dem IBM® JMX-REST-Connector aufgerufen werden. Die Verbindung kann eine lokale oder eine ferne Verbindung sein, aber es muss der REST-Connector verwendet werden.
Zu den bereitgestellten Operationen gehören die Möglichkeit, eine Datei herunterzuladen, hochzuladen und zu löschen. Jede Lese- und Schreibanforderung im Server wird an die konfigurierbaren Lese- und Schreiblisten gebunden, auf die die FileServiceMXBean zugreift. Die FileTransferMBean kann auch vollständig über die integrierte Java JConsole aufgerufen und ausgeführt werden, sofern die JConsole über den IBM JMX-REST-Connector verbunden ist.
Die Verwendung von Variablen, die in Liberty definiert sind, ist für alle serverseitigen Parameter zulässig, die eine Zeichenfolge akzeptieren, die einen Dateipfad darstellt. Solche Variablen sind in der Datei Liberty-Ausgangsverzeichnis/README.TXT definiert.
![[8.5.5.5 oder höher]](../ng_v8555.gif)
WebSphere:name=com.ibm.websphere.config.mbeans.ServerXMLConfigurationMBean
- Verwaltungsschnittstelle: com.ibm.websphere.config.mbeans.ServerXMLConfigurationMBean
- Kommentar: Die ServerXMLConfigurationMBean stellt eine Schnittstelle zum Abrufen der Dateipfade aller Serverkonfigurationsdateien bereit, die dem Server bekannt sind. Die MBean ist über den Kernel verfügbar, d. h., Sie müssen kein besonderes Feature aktivieren. Sie finden die entsprechende MBean-Klasse und die API-Dokumentation an folgenden Positionen:
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.config_Version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.config_Version-javadoc.zip
![[8.5.5.4 oder höher]](../ng_v8554.gif)
WebSphere:name=com.ibm.websphere.runtime.update.RuntimeUpdateNotificationMBean
- Verwaltungsschnittstelle: com.ibm.websphere.runtime.update.RuntimeUpdateNotificationMBean
- Kommentar: Die RuntimeUpdateNotificationMBean stellt Benachrichtigungen für Serverlaufzeitaktualisierungen bereit. Das an die Benachrichtigung angehängte Benutzerdatenobjekt ist eine java.util.Map. Der Benachrichtigungstyp für Benachrichtigungen zu Laufzeitaktualisierungen, die von dieser MBean ausgegeben werden, ist com.ibm.websphere.runtime.update.notification.
![[8.5.5.5 oder höher]](../ng_v8555.gif)
WebSphere:name=com.ibm.ws.config.mbeans.FeatureListMBean
- Verwaltungsschnittstelle: com.ibm.websphere.config.mbeans.FeatureListMBean
- Kommentar: Die FeatureListMBean stellt eine einzelne Methode zur Verfügung, um einen XML-Bericht für alle zur Laufzeit installierten
Features zu generieren. Die MBean ist über den Kernel verfügbar, d. h., Sie müssen kein besonderes Feature aktivieren. Sie finden die entsprechende MBean-Klasse und die API-Dokumentation an folgenden Positionen:
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.config_Version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.config_Version-javadoc.zip
![[8.5.5.5 oder höher]](../ng_v8555.gif)
WebSphere:name=com.ibm.ws.config.serverSchemaGenerator
- Verwaltungsschnittstelle: com.ibm.websphere.config.mbeans.ServerSchemaGenerator
- Kommentar: Die MBean ServerSchemaGenerator stellt Methoden zur Verfügung zur Generierung von Schemas aus dem installierten Image (gebräuchlichste Methode) oder aus einer aktuellen Laufzeit zur Verfügung. Die MBean ist über den Kernel verfügbar, d. h., Sie müssen kein besonderes Feature aktivieren. Sie finden die entsprechende MBean-Klasse und die API-Dokumentation an folgenden Positionen:
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.config_Version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.config_Version-javadoc.zip
WebSphere:name=com.ibm.ws.jmx.mbeans.generatePluginConfig
- Verwaltungsschnittstelle: com.ibm.websphere.webcontainer.GeneratePluginConfigMBean
- Kommentar: Informationen finden Sie unter Web-Server-Plug-in für das Liberty-Profil konfigurieren.
WebSphere:service=com.ibm.ws.kernel.filemonitor.FileNotificationMBean
- Verwaltungsschnittstelle: com.ibm.websphere.filemonitor.FileNotificationMBean
WebSphere:service=com.ibm.websphere.application.ApplicationMBean,name=*
- Verwaltungsschnittstelle: com.ibm.websphere.application.ApplicationMBean
- Kommentar: Es ist eine Instanz für jede Anwendung im System verfügbar. * steht für einen eindeutigen Anwendungsnamen.
![[8.5.5.6 oder höher]](../ng_v8556.gif)
WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,jndiName=*
- Verwaltungsschnittstelle: com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean
- Kommentar: Für jeden Verbindungsmanager im System ist eine Instanz verfügbar. * steht für den JNDI-Namen des Verbindungsmanagers. Wenn der Verbindungsmanager keinen JNDI-Namen hat unterhalb eines DataSource-Elements in der Datei server.xml verschachtelt ist, kann der JNDI-Name der Datenquelle verwendet werden.
WebSphere:type=JvmStats
- Verwaltungsschnittstelle: com.ibm.websphere.monitor.jmx.JvmMXBean
- Kommentar: Verfügbar, wenn das Feature monitor-1.0 aktiviert ist. Weitere Informationen hierzu finden Sie unter JVM-Überwachung.
WebSphere:type=ServletStats,name=*
- Verwaltungsschnittstelle: com.ibm.websphere.webcontainer.ServletStatsMXBean
- Kommentar: Wenn das Feature monitor-1.0 aktiviert ist, ist eine Instanz für jedes bereitgestellte Servlet verfügbar. * hat das Format <Anwendungsname>.<Servletname>. Weitere Informationen hierzu finden Sie unter Überwachung von Webanwendungen.
WebSphere:type=ThreadPoolStats,name=Default Executor
- Verwaltungsschnittstelle: com.ibm.websphere.monitor.jmx.ThreadPoolMXBean
- Kommentar: Verfügbar, wenn das Feature monitor-1.0 aktiviert ist. Weitere Informationen hierzu finden Sie unter Thread-Pool-Überwachung.