Liste des MBeans fournis

Liberty fournit une liste de beans gérés et d'interfaces de gestion correspondantes que vous pouvez utiliser pour manipuler et surveiller le serveur.

Pour chaque bean géré ou MXBean de la liste :
  • Le nom est la valeur javax.management.ObjectName qui identifie de façon unique le bean géré ou le MXBean. Lorsqu'il existe plusieurs instances d'un bean géré ou d'un MXBean, la valeur ObjectName peut contenir un caractère générique (*) qui est décrit dans les entrées Commentaires de cette rubrique.
  • Les entrées Interface de gestion spécifient le nom de l'interface Java™ qui peut être utilisée pour construire un objet proxy pour le bean géré ou le MXBean comme décrit dans Liberty : Exemples d'accès aux opérations et aux attributs de bean géré. 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 disponible dans un fichier .zip séparé des sous-répertoires javadoc du répertoire ${wlp.install.dir}/dev.

WebSphere:feature=channelfw,type=endpoint,name=*

  • Interface de gestion : com.ibm.websphere.endpoint.EndPointInfoMBean
  • Commentaires : Une instance est disponible pour chaque noeud final sur le système, où * est un nom de noeud final unique.

WebSphere:feature=jaxws,type=WebServiceStats,service=*,port=*

  • Interface de gestion : org.apache.cxf.management.counters.ResponseTimeCounterMBean
  • Commentaires : Disponible lorsque la fonction monitor-1.0 est activée. WebServiceStats peut être Performance.Counter.Server ou Performance.Counter.client, où service=* est le nom qualifié d'un noeud final de service et port=* est le nom de port du noeud final de service. Voir Liberty : Surveillance JAX-WS.
Remarque : Il s'agit d'un bean géré de modèle dynamique.

WebSphere:feature=jaxws,type=Bus.Service.Endpoint,bus.id=*,service=*,port=*,name=*

  • Interface de gestion : org.apache.cxf.endpoint.ManagedEndpoint
  • Commentaires : Disponible lorsque la fonction localConnector-1.0 ou restConnector-1.0 est activée et que l'accès à l'application JAX-WS a lieu une fois au moins. bus.id=* est le nom du bus, où * est au format <NomApp>-Server-Bus. service=* est le nom qualifié du noeud final, où * est au format {EspaceNomService}NomService. port=* est le nom de port du noeud final, où * est le nom de port courant. Le format de MBean est le suivant : <BUS>@<SERVICE>@<PORT>@<URL_PATTERN>, où :
    • <BUS> a la même valeur que la zone bus.id;
    • <SERVICE> a la même valeur que la zone service;
    • <PORT> a la même valeur que la zone port;
    • <URL_PATTERN> peut avoir les valeurs suivantes dans différents scénarios ;
      • Si l'élément url-pattern est défini dans le fichier web.xml de votre application, la valeur de l'élément url-pattern est utilisée. Par exemple, l'élément url-pattern est /SayHelloURL dans le fichier web.xml :
        <servlet-mapping>
            <servlet-name>com.ibm.ws.jaxws.test.jmx.service.WSTestEndpointService</servlet-name>
            <url-pattern>/SayHelloURL</url-pattern>
        </servlet-mapping>
        Par exemple, le MBean peut être comme suit:
        WebSphere:feature=jaxws,bus.id=EJBWSBasic-Server-Bus,type=Bus.Service.Endpoint,
        service="{http://ejbbasic.jaxws.ws.ibm.com/}SayHelloService",port="SayHelloPort",
        name="EJBWSBasic-Server-Bus@{http://ejbbasic.jaxws.ws.ibm.com/}SayHelloService@SayHelloPort@SayHelloURL"
      • Si le masque d'URL n'est pas indiqué, le nom du service est utilisé comme valeur par défaut. Par exemple, le MBean peut être comme suit:
        WebSphere:feature=jaxws,bus.id=EJBWSBasic-Server-Bus,type=Bus.Service.Endpoint,
        service="{http://ejbbasic.jaxws.ws.ibm.com/}SayHelloService",port="SayHelloPort",
        name="EJBWSBasic-Server-Bus@{http://ejbbasic.jaxws.ws.ibm.com/}SayHelloService@SayHelloPort@SayHelloService
      • Si le masque d'URL ne peut pas être extrait par le moteur de services Web lorsque le noeud géré de noeud final est enregistré, un nombre aléatoire unique est utilisé pour garantir que le noeud géré est unique. Par exemple, le MBean peut être comme suit:
        WebSphere:feature=jaxws,bus.id=EJBWSBasic-Server-Bus,type=Bus.Service.Endpoint,
        service="{http://ejbbasic.jaxws.ws.ibm.com/}SayHelloService",port="SayHelloPort",
        name="EJBWSBasic-Server-Bus@{http://ejbbasic.jaxws.ws.ibm.com/}SayHelloService@SayHelloPort@261689241"
Remarque :
  • Il s'agit d'un bean géré de modèle dynamique.
  • L'opération destroy sur ce MBean n'est pas prise en charge.

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 :
    liberty_home/dev/api/ibm/com.ibm.websphere.appserver.api.kernel.service_version-javadoc.zip
    liberty_home/dev/api/ibm/com.ibm.websphere.appserver.api.kernel.service_version.jar

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.

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 :
    <remoteFileAccess>
      	<readDir>${server.output.dir}/logs</readDir>
      	<readDir>${server.output.dir}/apps</readDir>
      	<writeDir>${server.output.dir}/dropins</writeDir>
    </remoteFileAccess>
    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.

    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=wasJmsServer,type=MessagingEngine,name=*

  • Interface de gestion : com.ibm.websphere.messaging.mbean.MessagingEngineMBean
  • Commentaires : Disponible lorsque la fonction wasJmsServer-1.0 est activée. Une instance de moteur de messagerie est disponible pour chaque serveur Liberty. name=* est le nom du bean géré, où * est le nom unique du bean géré de moteur de messagerie. Voir Liberty : Messagerie JMS.

WebSphere:feature=wasJmsServer,type=Queue,name=*

  • Interface de gestion : com.ibm.websphere.messaging.mbean.QueueMBean
  • Commentaires : Le bean géré est disponible lorsque la fonction wasJmsServer-1.0 est activée et que le bean géré du moteur de messagerie est disponible. name=* est le nom du bean géré, où * est le nom du bean géré de file d'attente. Voir Liberty : Messagerie JMS.

WebSphere:feature=wasJmsServer,type=Subscriber,name=*

  • Interface de gestion : com.ibm.websphere.messaging.mbean.SubscriberMBean
  • Commentaires : Le bean géré est disponible lorsque la fonction wasJmsServer-1.0 est activée et que le bean géré du moteur de messagerie est disponible. name=* est le nom du bean géré, où * est le nom du bean géré d'abonné courant.
    Remarque : SubscriberMBean est un abonné au bean géré de rubrique TopicMBean existant. Voir Liberty : Messagerie JMS.

WebSphere:feature=wasJmsServer,type=Topic,name=*

  • Interface de gestion : com.ibm.websphere.messaging.mbean.TopicMBean
  • Commentaires : Le bean géré est disponible lorsque la fonction wasJmsServer-1.0 est activée et que le bean géré du moteur de messagerie est disponible. name=* est le nom du bean géré, où * est le nom du bean géré de rubrique. Voir Liberty : Messagerie JMS.

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

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=* le nom d'un module Web dans cette application.

WebSphere:service=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
    L'instance mbean n'est pas disponible tant que la fabrique de connexions ou la source de données correspondante n'est pas utilisée pour la première fois.
    Pour limiter l'instance du gestionnaire de connexions, vous pouvez spécifier des attributs supplémentaires, comme illustré dans les exemples suivants :
    WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,jndiName=jdbc/db2,*
    WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,name=jmsConnectionFactory[cf1]/connectionManager[default-0],*
    WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,name=databaseStore[dbstore1]/dataSource[default-0]/connectionManager,*
    WebSphere:service=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

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 Liberty : Surveillance des applications Web.

WebSphere:type=ThreadPoolStats,name=Default Executor


Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwlp_mbeans_list
Nom du fichier : rwlp_mbeans_list.html