Configurando o Provedor JMS do EIF WebSphere Utilizando Script

O Provedor JMS do EIF WebSphere pode ser reconfigurado utilizando o script de configuração fornecido. O script está localizado em <was_profile_path>/eventext/bin/eifjms.jacl. Utilize a ferramenta wsadmin para executar o script eifjms.jacl. O script pode executar o seguinte:

  1. Criar um novo conjunto de configuração para o Provedor JMS do EIF WebSphere.
  2. Remover a configuração do Provedor JMS do EIF WebSphere.
  3. Configurar o Provedor JMS do EIF WebSphere para redirecionar eventos para um servidor adicional do Console Corporativo.
  4. Remover a configuração do redirecionamento de eventos para o servidor adicional do Console Corporativo.

O WebSphere Application Server deve ser reiniciado para que as alterações na configuração tenham efeito.

Uso

Chame wsadmin e forneça o nome deste script no parâmetro -f. Este script aceita os seguintes parâmetros:
-action
Especifique um destes [install/uninstall/addconnection/removeconnection]
A especificação de install criará um novo conjunto de configuração para o Provedor JMS do EIF WebSphere. O Provedor JMS é instalado e um grupo de eventos é criado.
A especificação de uninstall removerá a configuração do Provedor JMS do EIF WebSphere. O provedor JMS é desinstalado e o grupo de eventos é removido.
A especificação de addconnection configurará o Provedor JMS do EIF WebSphere para redirecionar eventos para um servidor adicional do Console Corporativo. Um Connection Factory JMS é criado para o Provedor JMS instalado e um grupo de eventos correspondente é criado.
A especificação de removeconnection removerá a configuração de redirecionamento de eventos para o servidor adicional do Console Corporativo. O conectionfactory JMS e o grupo de eventos correspondente são removidos
Este parâmetro é obrigatório.
-scope
Especifique o escopo (cell, node, server ou cluster) no qual o provedor JMS será instalado/desinstalado ou a partir do qual uma conexão será incluída/removida.
Este parâmetro é obrigatório.
-node
Especifique o nome do nó no qual o Provedor JMS será instalado/desinstalado ou a partir do qual uma conexão será incluída/removida
Este parâmetro será obrigatório se o parâmetro de escopo estiver definido como node/server.
-server
Especifique o nome do servidor no qual o Provedor JMS será instalado/desinstalado ou a partir do qual uma conexão será incluída/removida.
Este parâmetro será obrigatório se o parâmetro de escopo estiver definido como server.
-cluster
Especifique o nome do cluster no qual o Provedor JMS será instalado/desinstalado ou a partir do qual uma conexão será incluída/removida.
Este parâmetro será obrigatório se o parâmetro do escopo estiver definido como cluster.
-qname
Especifique o nome da Fila a ser criada para o Provedor JMS.
Este parâmetro será obrigatório se o parâmetro action estiver instalado.
-qcfname
Especifique o nome do Connection Factory de Fila a ser criado para o Provedor JMS. Este parâmetro será obrigatório se o parâmetro action estiver definido como install/addconnection/removeconnection.
-qjndi
Especifique o nome JNDI de Fila que é criado para o Provedor JMS.
Este parâmetro é opcional. O valor padrão é jms/eif/<qname>.
-qcfjndi
Especifique o nome JNDI do Connection Factory de Fila que é criado para o Provedor JMS.
Este parâmetro é opcional. O valor padrão é jms/eif/<qcfname>.
-eventselector
Especifique a cadeia do seletor de eventos a ser redirecionada para o servidor Tivoli Enterprise Console. Esta deve ser uma expressão XPath válida.
Este parâmetro é opcional. O valor padrão é todos os eventos.
-trace

Especifique esta opção para exibir informações detalhadas sobre o processamento.

Este parâmetro é opcional. Informações detalhadas não são exibidas por padrão.

O script aceita também uma lista de propriedades no formato de key=value, que são definidos como as Propriedades Personalizadas do Connection Factory de Fila criado durante a instalação ou quando uma conexão é incluída.

As chaves permitidas das propriedades são:

BarocLocation
Especifique o local dos arquivos baroc
Esta propriedade é opcional. O valor padrão é definido como ${USER_INSTALL_ROOT}/eventext/tec_classes
ServerLocation
Especifique o nome do host do servidor do Console Corporativo para redirecionar os eventos
Esta propriedade é opcional. O valor padrão é definido no host local.
ServerPort
Especifique a porta de recepção do servidor Tivoli Enterprise Console
Esta propriedade é opcional. O valor padrão é definido como 5529
BufferEvents
Especifique se os eventos redirecionados para o servidor do Console Corporativo devem ser armazenados em buffer. Os valores válidos são [YES/NO]
Esta propriedade é opcional. O valor padrão é NO
BufEvtPath
Especifique o local e o nome do arquivo em que os eventos armazenados em buffer devem ser armazenados
Esta propriedade será obrigatória se BufferEvents estiver definido como YES. O valor padrão é /tmp/<qcfname>.cache.
LogLevel
Especifique o nível de log a ser concluído.
Esta propriedade é opcional. O padrão é nenhum.
TraceLevel
Especifique o nível de rastreio a ser concluído.
Esta propriedade é opcional. O padrão é nenhum.
LogFileName
Especifique o local e o nome do arquivo de log
Esta propriedade deverá ser especificada se LogLevel estiver especificado
O valor padrão é /tmp/<qcfname>.log
TraceFileName
Especifique o local e o nome do arquivo de rastreio
Essa propriedade deverá ser especificada se TraceLevel estiver especificado
O valor padrão é /tmp/<qcfname>.trace

Exemplos

Exemplo da ação install
Um exemplo para criar um novo conjunto de configurações. Esse comando é executado a partir do diretório <was_profile_path>/eventext/bin
wsadmin
-f eifjms.jacl
-action install
-scope node
-node mynode
-qname TECQueue
-qcfname TECQCF
-trace
ServerLocation=myhost
BufferEvents=yes
BufEvtPath=/tmp/tecevt.buf
Exemplo da ação uninstall
Um exemplo para remover a configuração. Esse comando é executado a partir do diretório <was_profile_path>/eventext/bin
wsadmin
-f eifjms.jacl
-action uninstall
-scope node
-node mynode
-trace
Exemplo da ação addconnection
Um exemplo para incluir uma conexão. Esse comando é executado a partir do diretório <was_profile_path>/eventext/bin.
wsadmin
-f eifjms.jacl
-action addconnection
-scope node
-node mynode
-qcfname TECQCF
-eventselector "CommonBaseEvent[@extensionName = 'CLASS' e @severity > 40]"
-trace
ServerLocation=myanotherhost
Exemplo da ação removeconnection
Um exemplo para remover uma conexão. Esse comando é executado a partir do diretório <profile_home>/eventext/bin
wsadmin
-f eifjms.jacl
-action removeconnection
-scope node
-node mynode
-qcfname TECQCF
-trace

Referências
Configurando o Provedor JMS
Configurando o Grupo de Eventos

Tópicos Relacionados
Alterando o Redirecionamento do Servidor Tivoli Enterprise Console
Selecionando os Eventos a Serem Redirecionados
Ativando Armazenamento em Buffer de Eventos
Redirecionando Eventos para Vários Servidores
Modificando o Escopo de Configuração
Modificando Definições de Classe do Evento do Console Corporativo

Tópico Pai
Administrando o Provedor JMS do EIF WebSphere