É possível estender o sistema de administração do WebSphere Application Server
fornecendo e registrando novos MBeans Java™ Management Extensions (JMX)
(consulte a Especificação JMX 1.x para obter detalhes) em um dos processos do WebSphere.
Sobre Esta Tarefa
Os MBeans JMX
representam a interface de gerenciamento de uma determinada parte da lógica. Todos os recursos gerenciados na infraestrutura padrão do produto são
representados como MBeans JMX. Existem várias maneiras de
criar seus próprios MBeans e registrá-los no JMX MBeanServer em execução
em qualquer processo do WebSphere.
Para obter informações adicionais, consulte a documentação da application programming interface (API) Java
de MBean. Neste centro de informações, clique em .
Procedimento
- Crie MBeans JMX personalizados.
Você tem algumas alternativas
para seleção, ao criar MBeans para estender o sistema administrativo do produto. É possível utilizar qualquer MBean JMX existente de outro aplicativo.
É possível registrar qualquer
MBean testado em um servidor MBean JMX fora do ambiente do WebSphere Application Server em um processo do produto,
incluindo MBeans padrão, MBeans dinâmicos, MBeans abertos
e MBeans de modelo.
Além de MBeans JMX existentes e dos que foram gravados
e testados fora do ambiente do produto, você pode usar as extensões distribuídas
especiais fornecidas pelo WebSphere e criar um provedor de ExtensionMBean do WebSphere. Esta alternativa fornece melhor integração com todas as funções distribuídas
do sistema administrativo do produto. Um provedor de ExtensionMBean implica que você
fornece um arquivo XML que contém o Descritor de MBean baseado na DTD
fornecida com o produto. Esse
descritor indica ao sistema WebSphere todos os atributos, operações
e notificações suportados pelo MBean.
Com estas informações, o sistema WebSphere pode
rotear pedidos remotos para seu MBean e registrar Listeners remotos para receber
suas notificações de eventos de MBean.
Todos os MBeans internos do WebSphere seguem
o padrão MBean de Modelo. As classes Java puras fornecem a lógica real para funções
de gerenciamento e a classe MBeanFactory do WebSphere lê a descrição
dessas funções do Descritor de MBean XML e cria uma instância de
um ModelMBean que corresponde ao descritor. Essa instância de ModelMBean é ligada
a suas classes Java e registrada no MBeanServer em execução
no mesmo processo que suas classes. Seu código Java agora pode ser chamado a partir de qualquer cliente administrativo do WebSphere Application Server por meio do ModelMBean criado e registrado para representá-lo.
- Opcionalmente, defina
uma política de segurança de MBean explícita.
Se você não definir
uma política de segurança de MBean, o produto usará a política de segurança padrão.
- Registre os novos MBeans. Há várias maneiras de registrar
seu MBean.
Você pode registrar seu MBean com o serviço administrativo do WebSphere Application Server.
Você pode registrar seu MBean com o MBeanServer em um processo do
WebSphere Application Server.
A lista a seguir descreve as
opções disponíveis em ordem de preferência:
- Passe pela classe MBeanFactory. Se desejar a maior integração possível
com o sistema WebSphere Application Server, use
a classe MBeanFactory para gerenciar o ciclo de vida de seu MBean por meio dos métodos
activateMBean e deactivateMBean da classe MBeanFactory. Utilize esses métodos fornecendo uma subclasse da superclasse abstrata
RuntimeCollaborator e um arquivo descritor de MBean XML. Utilizando essa abordagem,
você fornece uma classe Java pura que implementa a interface de gerenciamento
definida no descritor de MBean. A classe MBeanFactory cria o
ModelMBean real e registra-o com o sistema administrativo do produto
para você.
Esta opção é recomendada para registrar MBeans de modelo.
- Utilize o JMXManageable e a interface CustomService. Você pode tornar o processo
de integração com a administração do WebSphere ainda mais fácil implementando
uma interface CustomService que também implementa a interface JMXManageable. Utilizando essa abordagem, você pode evitar o fornecimento do RuntimeCollaborator. Quando
a interface CustomService é inicializada, a classe MBeanFactory do WebSphere lê
seu arquivo de descritor de MBean XML e cria, liga e registra um MBean
para a interface CustomService automaticamente. Após a chamada do método de encerramento do
CustomService, o sistema do produto desativa automaticamente
seu MBean.
- Passe pela interface AdminService. Você pode chamar o método registerMBean()
na interface AdminService e a chamada será delegada ao MBeanServer subjacente ao processo depois de verificações apropriadas da segurança. É possível obter uma referência ao AdminService utilizando o método getAdminService()
da classe AdminServiceFactory.
Esta opção é recomendada para registrar
MBeans padrão, dinâmico e aberto. Implemente a classe UserCollaborator
para utilizar os MBeans e para fornecer um nível consistente de suporte para eles
nas plataformas distribuída e z/OS.
- Obtenha instâncias do MBeanServer diretamente. Você pode obter uma referência direta à instância
de MBeanServer JMX em execução em qualquer processo do produto, chamando o método
getMBeanServer() da classe MBeanFactory. Você obtém uma referência à classe
MBeanFactory chamando o método getMBeanFactory() da interface
AdminService.
Quando um MBean customizado é registrado diretamente no servidor MBean, o nome do objeto MBean é, por padrão, aprimorado com as chaves de nome de célula, nó e processo. Este registro permite que o MBean participe dos recursos
distribuídos do sistema administrativo. É possível desativar o comportamento padrão
configurando a propriedade customizada com.ibm.websphere.mbeans.disableRouting.
Consulte Propriedades customizadas dos serviços de administração para obter mais informações sobre como configurar e usar a propriedade customizada com.ibm.websphere.mbeans.disableRouting.
Resultados
Independentemente da abordagem utilizada para criar e registrar
seu MBean, é necessário configurar 2 permissões de segurança Java apropriadas para
seu novo código de MBean. O AdminService e o MBeanServer do WebSphere são
totalmente protegidos utilizando as permissões de segurança Java 2 e se você
não conceder explicitamente suas permissões de código base, exceções de segurança serão emitidas
ao tentar chamar métodos dessas classes. Se você estiver fornecendo o MBean como parte do aplicativo, é possível definir as permissões no arquivo
was.policy fornecido como parte dos metadados do aplicativo. Se estiver utilizando uma interface CustomService ou outro código que não seja fornecido como um aplicativo, é possível editar o arquivo library.policy na configuração do nó ou até mesmo o arquivo
server.policy no diretório properties de uma instalação específica.