Extension du système d'administration WebSphere Application Server avec des MBeans personnalisés

Vous pouvez étendre le système d'administration WebSphere Application Server en fournissant et en enregistrant de nouveaux Mbeans JMX (Java™ Management Extensions) (pour plus de détails, voir la spécification JMX 1.x) dans l'un des processus WebSphere.

Pourquoi et quand exécuter cette tâche

Les MBeans JMX représentent l'interface de gestion pour une partie spécifique de la logique. Toutes les ressources gérées figurant dans l'infrastructure du produit standard, sont représentées sous la forme de MBeans JMX. Il existe différentes façons de créer vos propres MBeans et de les enregistrer auprès du MBeanServer JMX s'exécutant dans n'importe quel processus WebSphere. Pour plus d'informations, voir la documentation sur l'API (Application Programming Interface) Java MBean. Dans le centre de documentation, cliquez sur Référence > Interfaces Mbean.

Procédure

  1. Créez des MBeans JMX personnalisés.

    Vous avez le choix entre plusieurs approches pour créer des MBeans en vue d'étendre le système d'administration du produit. Vous pouvez utiliser n'importe quel MBean JMX existant d'une autre application. Vous pouvez enregistrer tout MBean testé dans un serveur JMX hors de l'environnement WebSphere Application Server au sein d'un processus du produit, incluant des MBeans standard, dynamiques, ouverts et modèle.

    En plus de tout MBean JMX existant et de ceux écrits et testés à l'extérieur de l'environnement du produit, vous pouvez utiliser des extensions réparties spéciales fournies par WebSphere et créer un fournisseur d'ExtensionMBean WebSphere. Cette alternative permet une meilleure intégration avec l'ensemble des fonctions réparties du système d'administration du produit. Un fournisseur d'ExtensionMBean implique que vous fournissiez un fichier XML qui contient un descripteur de MBean basé sur le DTD fourni avec le produit. Ce descripteur indique au système WebSphere l'ensemble des attributs, des opérations et des notifications que votre MBean prend en charge. Grâce à ces informations, le système WebSphere peut acheminer des demandes éloignées vers le MBean et enregistrer les modules d'écoute éloignés pour qu'ils reçoivent les notifications d'événements du MBean.

    Tous les MBeans internes de WebSphere suivent la structure du MBean modèle. Les classes Java pures fournissent la véritable logique des fonctions de gestion et la classe MBeanFactory de WebSphere lit la description de ces fonctions à partir du descripteur de MBean XML et crée une instance d'un ModelMBean qui correspond au descripteur. Cette instance de ModelMBean est liée à vos classes Java et elle est enregistrée auprès du MBeanServer qui s'exécute dans le même processus que vos classes. Votre code Java est désormais appelable à partir de n'importe quel client d'administration WebSphere Application Server par le biais du ModelMBean créé et enregistré pour le représenter.

  2. Définissez éventuellement une règle de sécurité du MBean explicite.

    Si vous ne définissez pas de règle de sécurité du MBean, le produit utilise la règle de sécurité par défaut.

  3. Enregistrez les nouveaux MBeans. L'enregistrement du MBean peut se faire de diverses manières.

    Vous pouvez l'enregistrer avec le service d'administration de WebSphere Application Server.

    Vous pouvez également l'enregistrer avec le serveur MBean dans un processus WebSphere Application Server. La liste qui suit décrit les options disponibles dans l'ordre de préférence :
    • Utilisez la classe MBeanFactory. Si vous souhaitez une intégration maximale avec le système WebSphere Application Server, utilisez la classe MBeanFactory pour gérer le cycle de vie de votre MBean par le biais des méthodes activateMBean et deactivateMBean de la classe MBeanFactory. Utilisez ces méthodes en fournissant une sous-classe de la superclasse abstraite RuntimeCollaborator et un fichier de descripteur du MBean XML. En utilisant cette approche, vous fournissez une classe Java pure qui implémente l'interface de gestion définie dans le descripteur du MBean. La classe MBeanFactory crée le ModelMBean réel et l'enregistre auprès du système d'administration du produit pour votre compte.

      Cette option est conseillée pour l'enregistrement de MBeans modèle.

    • Utilisez l'interface JMXManageable et CustomService. Vous pouvez simplifier davantage le processus d'intégration avec l'administration WebSphere en implémentant une interface CustomService qui elle-même implémente l'interface JMXManageable. Cette approche vous évite de fournir le RuntimeCollaborator. Une fois que votre interface CustomService est initialisée, la classe MBeanFactory de WebSphere lit votre fichier de descripteur du MBean XML, puis crée, lie et enregistre automatiquement un MBean auprès de votre interface CustomService. Une fois que la méthode shutdown de votre CustomService est appelée, le système du produit désactive automatiquement votre MBean.
    • Utilisez l'interface AdminService. Vous pouvez appeler la méthode registerMBean() sur l'interface AdminService et l'appel est délégué au MBeanServer sous-jacent du processus, suite aux vérifications de sécurité appropriées. Vous pouvez obtenir une référence à l'AdminService à l'aide de la méthode getAdminService() de la classe AdminServiceFactory.

      Cette option est conseillée pour l'enregistrement de MBeans standard, dynamiques et ouverts. Implémentez la classe UserCollaborator pour utiliser les MBeans et leur offrir un niveau cohérent de support à travers les plateformes réparties et z/OS.

    • Obtenez des instances de MBeanServer directement. Vous pouvez obtenir une référence directe à l'instance de MBeanServer JMX qui s'exécute dans n'importe quel processus du produit en appelant la méthode getMBeanServer() de la classe MBeanFactory. Vous obtenez une référence à la classe MBeanFactory en appelant la méthode getMBeanFactory() de l'interface AdminService.

      Lorsqu'un MBean personnalisé est directement enregistré avec le serveur de MBean, le nom d'objet de MBean est étendu avec les clés de cellule, de noeud et de nom de processus par défaut. L'enregistrement permet au MBean de participer aux fonctions réparties du système d'administration. Vous pouvez désactiver le comportement par défaut en définissant la propriété personnalisée com.ibm.websphere.mbeans.disableRouting.

      Voir Propriétés personnalisées des services d'administration pour plus d'informations sur la définition et l'utilisation de la propriété personnalisée com.ibm.websphere.mbeans.disableRouting.

Résultats

Quelle que soit l'approche utilisée pour créer et enregistrer votre MBean, vous devez configurer les droits d'accès de sécurité Java 2 pour le code de votre nouveau MBean. AdminService et MBeanServer de WebSphere sont étroitement protégés à l'aide des droits d'accès de sécurité Java 2 et, si vous n'octroyez pas explicitement les droits d'accès à votre code, des exceptions de sécurité sont générées lorsque vous essayez d'appeler les méthodes de ces classes. Si vous fournissez votre MBean dans le cadre de votre application, vous pouvez définir les droits d'accès dans le fichier was.policy que vous fournissez avec les métadonnées de votre application. Si vous utilisez une interface CustomService ou un autre code qui n'est pas fourni en tant qu'application, vous pouvez éditer le fichier library.policy dans la configuration du noeud, ou encore le fichier server.policy situé dans le répertoire properties pour une installation spécifique.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=tjmx_extend
Nom du fichier : tjmx_extend.html