Ampliación del sistema administrativo de WebSphere Application Server con MBeans personalizados

Para ampliar el sistema de administración de WebSphere Application Server, debe proporcionar y registrar MBeans JMX (Java™ Management Extensions) nuevos (consulte la especificación JMX 1.x para obtener más detalles) en uno de los procesos de WebSphere.

Acerca de esta tarea

Los MBeans JMX representan la interfaz de gestión para una parte de lógica determinada. Todos los recursos gestionados en la infraestructura del producto estándar están representados como MBeans JMX. Existen varios procedimientos para crear sus propios MBeans y registrarlos con el JMX MBeanServer que se ejecute en un proceso de WebSphere cualquiera. Si desea obtener más información, consulte la documentación de la interfaz de programación de aplicaciones (API) Java de MBean. En este Information Center, pulse Reference (Referencia) > Mbean interfaces (Interfaces de Mbean).

Procedimiento

  1. Cree MBeans JMX personalizados.

    Dispone de varias alternativas que puede seleccionar para crear MBeans con el fin de ampliar el sistema administrativo del producto. Puede utilizar cualquier MBean JMX existente de otra aplicación. Puede registrar cualquier MBean que haya probado en un servidor de MBeans de JMX fuera del entorno de WebSphere Application Server en un proceso del producto, incluidos MBeans estándar, MBeans dinámicos, MBeans abiertos y MBeans de modelo.

    Además de los MBeans JMX existentes y de los que se hayan escrito y probado fuera del producto, puede utilizar las extensiones distribuidas especiales que se proporcionan con WebSphere y crear un proveedor ExtensionMBean de WebSphere. Esta alternativa proporciona una mayor integración con todas las funciones distribuidas del sistema administrativo del producto. Un proveedor ExtensionMBean implica que el usuario debe proporcionar un archivo XML que contenga un descriptor de MBean basado en la DTD facilitada con el producto. Este descriptor informa al sistema WebSphere de todos los atributos, operaciones y notificaciones a las que da soporte el MBean. Con esta información, el sistema WebSphere puede direccionar solicitudes remotas al MBean y registrar los escuchas remotos para recibir las notificaciones de suceso del MBean.

    todos los MBeans de WebSphere internos se ajustan al patrón del MBean modelo. Las clases Java puras proporcionan la lógica real para las funciones de gestión, mientras que la clase MBeanFactory de WebSphere lee la descripción de dichas funciones en el descriptor de XML MBean y crea una instancia de un ModelMBean que coincide con el descriptor. Esta instancia de ModelMBean está enlazada a las clases Java y registrada con el MBeanServer que se esté ejecutando en el mismo proceso que las clases. El código Java ahora se puede invocar desde cualquier cliente administrativo de WebSphere Application Server a través del ModelMBean creado y registrado para representarlo.

  2. Opcionalmente, defina una política de seguridad de MBean explícita.

    Si no define ninguna política de seguridad de MBean, el producto utiliza la política de seguridad predeterminada.

  3. Registre los MBeans nuevos. Hay varias formas de registrar el MBean.

    Puede registrar el MBean con el servicio administrativo de WebSphere Application Server.

    Puede registrar el MBean con MBeanServer en un proceso de WebSphere Application Server. En la lista siguiente se describen las opciones disponibles:
    • Examine la clase MBeanFactory. Si desea la mayor integración posible con el sistema de WebSphere Application Server, utilice la clase MBeanFactory para gestionar el ciclo de vida del MBean a través de los métodos activateMBean y deactivateMBean de la clase MBeanFactory. Para utilizar estos métodos, debe proporcionar una subclase de la superclase abstracta RuntimeCollaborator y un archivo del descriptor de XML MBean. Siguiendo este procedimiento, debe proporcionar una clase Java pura que implemente la interfaz de gestión definida en el descriptor de MBean. La clase MBeanFactory crea el ModelMBean real y lo registra con el sistema administrativo del producto en su nombre.

      Esta opción se recomienda para registrar MBean de modelo.

    • Utilice las interfaces JMXManageable y CustomService. Para que el proceso de integración con al administración de WebSphere sea más fácil, implemente una interfaz CustomService que a su vez implemente la interfaz JMXManageable. Siguiendo este procedimiento, no es necesario que proporcione el RuntimeCollaborator. Cuando se inicializa la interfaz CustomService, la clase MBeanFactory de WebSphere lee el archivo del descriptor de XML MBean y crea, enlaza y registra un MBean en la interfaz CustomService automáticamente. Después de llamar al método de conclusión de CustomService, el sistema del producto desactivará automáticamente el MBean.
    • Examine la interfaz AdminService. Puede llamar al método registerMBean() en la interfaz AdminService y dicha invocación se delega al MBeanServer subyacente del proceso después de las comprobaciones de seguridad correspondientes. Puede obtener una referencia a AdminService mediante el método getAdminService() de la clase AdminServiceFactory.

      Esta opción se recomienda para registrar MBean estándar, dinámicos y abiertos. Implemente la clase UserCollaborator para utilizar los MBeans y para proporcionar a éstos un nivel coherente de soporte en plataformas distribuidas y z/OS.

    • Obtenga instancias de MBeanServer directamente. Para obtener un referencia directa a la instancia de JMX MBeanServer que se esté ejecutando en cualquiera de los procesos del producto, llame al método getMBeanServer() de la clase MBeanFactory. Para obtener una referencia a la clase MBeanFactory, llame al método getMBeanFactory() de la interfaz AdminService.

      Cuando un MBean personalizado se registra directamente con el servidor, por omisión el nombre de objeto MBean se amplía con las claves de célula, nodo y nombre de proceso. Este registro permite que MBean participe en las características distribuidas del sistema administrativo. Puede desactivar el comportamiento predeterminado si establece la propiedad personalizada com.ibm.websphere.mbeans.disableRouting.

      Consulte Propiedades personalizadas de los servicios de administración para obtener más información sobre cómo establecer y utilizar la propiedad personalizada com.ibm.websphere.mbeans.disableRouting.

Resultados

Independientemente del procedimiento que utilice para crear y registrar el MBean, debe configurar correctamente los Permisos de seguridad Java 2 para el nuevo código de MBean. AdminService y MBeanServer de WebSphere están altamente protegidos mediante los permisos de seguridad de Java 2 y, si no otorga los permisos de la base de código explícitamente, se generan excepciones de seguridad cuando intente invocar métodos de estas clases. Si proporciona el MBean como parte de la aplicación, puede establecer los permisos en el archivo was.policy que facilite como parte de los metadatos de la aplicación. Si utiliza una interfaz CustomService u otro código que no se facilite como aplicación, puede editar el archivo library.policy en la configuración del nodo o incluso el archivo server.policy del directorio properties para una instalación específica.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=tjmx_extend
File name: tjmx_extend.html