Estendendo o Sistema Administrativo do WebSphere Application Server com MBeans Customizados

É 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 Referência > Interfaces de Mbean.

Procedimento

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

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

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


Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=tjmx_extend
Nome do arquivo: tjmx_extend.html