List of provided MBeans
Liberty provides a list of MBeans and corresponding management interfaces that you can use to manipulate and monitor the server. When using an MBean Proxy, find the classes that you need to compile inside the .jar files in ${wlp.install.dir}/dev/api/ibm.
- The name is the javax.management.ObjectName value that uniquely identifies the MBean or MXBean. When there are multiple instances of an MBean or MXBean, the ObjectName value can contain a wildcard (*), which is described in the Comments entries in this topic.
- The Management interface entries specify the name of the Java™ interface that can be used to construct a proxy object for the MBean or MXBean as described in Exemple d'accès aux attributs et opérations de MBean. Pour plus d'informations sur l'interface de gestion, voir le document de l'API Java pour Liberty. La documentation d'API Java de chaque API Liberty est détaillée dans la section Interfaces de programmation (Javadoc) du site en ligne IBM® Knowledge Center et est également disponible sous forme de fichier .zip séparé dans l'un des sous-répertoires javadoc du répertoire ${wlp.install.dir}/dev.
WebSphere:feature=channelfw,type=endpoint,name=*
- Management interface: com.ibm.websphere.endpoint.EndPointInfoMBean
- Comments: One instance is available for each endpoint in the system, where * is a unique endpoint name.
WebSphere:feature=dynamicRouting,type=DynamicRouting,name=DynamicRouting
- Management interface: com.ibm.websphere.dynamic.routing.DynamicRoutingMBean
- Comments: This MBean is available when the Dynamic Routing feature
is enabled. It provides an operation to generate a web server plug-in configuration for dynamic
routing.
See .
WebSphere:feature=kernel,name=ServerInfo
- Interface de gestion : com.ibm.websphere.kernel.server.ServerInfoMBean
- Commentaires : L'interface ServerInfoMbean est utilisée pour extraire des informations sur le serveur en cours. Recherchez les répertoires suivants pour la classe et la
documentation d'API :
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.kernel.service_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.kernel.service_version-javadoc.zip
Les opérations exposées incluent une méthode permettant d'extraire l'installation du produit et les emplacements du répertoire utilisateur, le nom d'hôte par défaut, le nom de serveur, la version de produit, la version de la spécification Java et la version Java Runtime.
![[18.0.0.1 and later]](../ng_v18001plus.gif)
WebSphere:feature=kernel,name=ServerEndpointControl
- Interface de gestion : com.ibm.websphere.kernel.server.ServerEndpointControlMBean
- Commentaires : L'interface ServerEndpointControlMBean est utilisée pour mettre en pause les noeuds finaux de serveur, les réactiver et obtenir leur statut. Le bean géré étant accessible depuis le noyau, vous n'avez pas besoin
d'activer une fonction spéciale. Vous trouverez la classe du bean géré et la documentation de l'API aux emplacements suivants :
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.kernel.service_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.kernel.service_version-javadoc.zip
Pour obtenir une liste des types de noeuds finaux que vous pouvez mettre en pause, voir Mettre en pause et reprendre un serveur Liberty à partir de la ligne de commande.
WebSphere:feature=restConnector,type=FileService,name=FileService
- Interface de gestion : com.ibm.websphere.filetransfer.FileServiceMXBean
- Commentaires : Ce MXBean permet d'effectuer diverses opérations liées aux fichiers sur l'hôte sur lequel se trouve Liberty. Vous trouverez sa classe et la documentation de l'API aux emplacements suivants :
liberty_home/dev/api/ibm/com.ibm.websphere.appserver.api.restConnector_version.jar liberty_home/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.restConnector_version-javadoc.zip
Les opérations exposées incluent la capacité à interroger certaines métadonnées (la date de dernière modification, la taille, etc.) d'un fichier ou répertoire donné, ainsi que d'interroger tous les fichiers enfant (et les métadonnées correspondantes) d'un répertoire donné. La prise en charge de la création et de la décompression d'archive est également fournie, ce qui peut être utile pour compresser des fichiers journaux Liberty ou pour extraire une application avant de la déployer.
Ce MXBean contient deux attributs : la liste de lecture et la liste d'écriture. Il s'agit de la liste des emplacements où les utilisateurs disposent d'un accès en lecture et écriture lors de l'utilisation des fonctionnalités FileService ou FileTransfer fournies par Liberty. Via le MXBean, ces attributs ne sont accessibles qu'en lecture, mais vous pouvez les configurer et les personnaliser par le biais des éléments suivants dans le fichier server.xml :
Si l'élément readDir n'est pas spécifié, la valeur par défaut est la combinaison de ${wlp.install.dir}, ${wlp.user.dir} et ${server.output.dir}. Si aucun élément writeDir n'est spécifié, la valeur par défaut est l'ensemble vide.<remoteFileAccess> <readDir>${server.output.dir}/logs</readDir> <readDir>${server.output.dir}/apps</readDir> <writeDir>${server.output.dir}/dropins</writeDir> </remoteFileAccess>
La fonction restConnector-1.0 doit être incluse dans le fichier server.xml pour que ce MXBean soit chargé et que ses éléments de configuration soient appliqués.
L'utilisation de variables définies par Liberty est autorisée avec tous les paramètres côté serveur qui admettent une chaîne représentant un chemin de fichier. Ces variables sont définies dans le fichier rép_base_liberty/README.TXT.
WebSphere:feature=restConnector,type=FileTransfer,name=FileTransfer
- Interface de gestion : com.ibm.websphere.filetransfer.FileTransferMBean
- Commentaires : Ce bean géré permet d'exécuter diverses opérations de transfert de fichier sur l'hôte sur lequel se trouve Liberty. Vous trouverez sa classe et la documentation de l'API aux emplacements suivants :
liberty_home/dev/api/ibm/com.ibm.websphere.appserver.api.restConnector_version.jar liberty_home/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.restConnector_version-javadoc.zip
Ce bean géré est enregistré sur PlatformMBeanServer à partir de la même machine virtuelle Java que son processus Liberty correspondant, mais il n'est accessible que via le connecteur IBM JMX REST. La connexion peut être locale ou distante, mais dans tous les cas, le connecteur REST doit être utilisé.
Les opérations exposées incluent la capacité de télécharger, télécharger en amont et supprimer un fichier. Chaque demande de lecture et d'écriture sur le serveur est liée aux listes de lecture et d'écriture configurables accessibles via FileServiceMXBean. FileTransferMBean est également accessible et peut être utilisé depuis la console Java intégrée JConsole, à condition que celle-ci soit connectée via le connecteur IBM JMX REST.
L'utilisation de variables définies par Liberty est autorisée avec tous les paramètres côté serveur qui admettent une chaîne représentant un chemin de fichier. Ces variables sont définies dans le fichier rép_base_liberty/README.TXT.
WebSphere:feature=scalingController,type=StackManager,name=StackManager
- Interface de gestion : com.ibm.websphere.scaling.controller.StackManager
- Commentaires : Le bean géré StackManager contrôle l'analyse du système de fichiers. Il analyse l'emplacement WLP_STACK_GROUPS_DIR (par défaut,
$WLP_USER_DIR/shared/stackGroups) pour
identifier des ajouts, des modifications et des suppressions de contrôleurs. Vous trouverez la classe du bean géré et la documentation de l'API aux emplacements suivants :
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.scalingController_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.scalingController_version-javadoc.zip
WebSphere:name=com.ibm.websphere.config.mbeans.ServerXMLConfigurationMBean
- Interface de gestion : com.ibm.websphere.config.mbeans.ServerXMLConfigurationMBean
- Commentaires : L'élément ServerXMLConfigurationMBean fournit une interface
pour l'extraction des chemins de fichier de tous les fichiers de configuration du serveur connus
du serveur. Le bean géré étant accessible depuis le noyau, vous n'avez pas besoin
d'activer une fonction spéciale. Vous trouverez la classe du bean géré et la documentation de l'API aux emplacements suivants :
- ${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.websphere.runtime.update.RuntimeUpdateNotificationMBean
- Interface de gestion : com.ibm.websphere.runtime.update.RuntimeUpdateNotificationMBean
- Commentaires : L'élément RuntimeUpdateNotificationMBean fournit des notifications pour les mises à jour d'exécution de serveur. L'objet de données utilisateur associé à la notification est un élément java.util.Map. Le type de notification pour les notifications de mise à jour d'exécution émises par ce bean géré est le suivant : com.ibm.websphere.runtime.update.notification.
WebSphere:name=com.ibm.ws.config.mbeans.FeatureListMBean
- Interface de gestion : com.ibm.websphere.config.mbeans.FeatureListMBean
- Commentaires : L'élément FeatureListMBean expose une seule méthode
pour générer un rapport XML sur toutes les fonctions installées lors
de l'exécution. Le bean géré étant accessible depuis le noyau, vous n'avez pas besoin
d'activer une fonction spéciale. Vous trouverez la classe du bean géré et la documentation de l'API aux emplacements suivants :
- ${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.config.serverSchemaGenerator
- Interface de gestion : com.ibm.websphere.config.mbeans.ServerSchemaGenerator
- Commentaires : Le bean géré ServerSchemaGenerator MBean expose des méthodes
pour générer un schéma à partir de l'image installée, la plupart du temps, ou à partir d'une exécution en cours. Le bean géré étant accessible depuis le noyau, vous n'avez pas besoin
d'activer une fonction spéciale. Vous trouverez la classe du bean géré et la documentation de l'API aux emplacements suivants :
- ${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
- Interface de gestion : com.ibm.websphere.webcontainer.GeneratePluginConfigMBean
- Commentaires : Voir Ajout d'une configuration de plug-in à un serveur Web.
WebSphere:service=com.ibm.websphere.application.ApplicationMBean,name=*
- Interface de gestion : com.ibm.websphere.application.ApplicationMBean
- Commentaires : Une instance est disponible pour chaque application sur le système, où * est un nom d'application unique.
WebSphere:service=com.ibm.websphere.webcontainer.WebModuleMBean,application=*,name=*
- Interface de gestion : com.ibm.websphere.webcontainer.WebModuleMBean
- Commentaires : Une instance est disponible pour chaque module Web dans le système, où application=* est le nom d'une application dans le système et name=* est le nom d'un module Web dans cette application.
WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,*
- Interface de gestion :com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean
- Commentaires : Une instance est disponible pour chaque gestionnaire de connexion dans le système, y compris ceux ayant été créés dans les contextes suivants :
- Lorsque configurés explicitement dans la configuration du serveur
- Lorsque créés implicitement en raison des annotations @DataSourceDefinition ou @ConnectionFactoryDefinition
- Lorsque créés comme résultat d'une fabrique de connexions ou de source de données dans la configuration du serveur
Pour limiter l'instance du gestionnaire de connexions, vous pouvez spécifier des attributs supplémentaires, comme illustré dans les exemples suivants :WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,jndiName=jdbc/db2,* WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,name=jmsConnectionFactory[cf1]/connectionManager[default-0],* WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,name=databaseStore[dbstore1]/dataSource[default-0]/connectionManager,* WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,jndiName=java.module/env/jdbc/ds3,application=MyApp,module=myweb,*
WebSphere:service=com.ibm.ws.kernel.filemonitor.FileNotificationMBean
- Interface de gestion : com.ibm.websphere.filemonitor.FileNotificationMBean
WebSphere:type=JvmStats
- Interface de gestion : com.ibm.websphere.monitor.jmx.JvmMXBean
- Commentaires : Disponible lorsque la fonction monitor-1.0 est activée. Voir surveillance de la machine virtuelle Java.
WebSphere:type=ServletStats,name=*
- Interface de gestion : com.ibm.websphere.webcontainer.ServletStatsMXBean
- Commentaires : Lorsque la fonction monitor-1.0 est activée, une instance est disponible pour chaque servlet traité, où * suit le format <nom_application>.<nom_servlet>. Voir surveillance des applications Web.
WebSphere:type=ThreadPoolStats,name=Default Executor
- Interface de gestion : com.ibm.websphere.monitor.jmx.ThreadPoolMXBean
- Commentaires : Disponible lorsque la fonction monitor-1.0 est activée. Voir Surveillance ThreadPool.