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 .
Procedimiento
- 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.
- 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.
- 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.