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 .
Procédure
- 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.
- 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.
- 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.