Caso não queira utilizar o recurso padrão do sistema de mensagens do WebSphere ESB para a transmissão de eventos, você pode configurar o transporte assíncrono de mensagens para utilizar um provedor JMS (Java Messaging Service) diferente.
Antes de iniciar
Antes de poder configurar o sistema de mensagens de eventos utilizando um provedor JMS externo, você deve primeiro criar uma fila JMS e uma connection factory utilizando as interfaces apropriadas para seu provedor JMS.
Por Que e Quando Desempenhar Esta Tarefa
O script
event-message.jacl configura os objetos de configuração requeridos para transmissão de eventos assíncronos utilizando um provedor JMS externo, como o WebSphere MQ:
- Se um escopo for especificado, ele criará um perfil de transmissão JMS utilizando a fila JMS e a connection factory que você especificar.
- Cria um perfil do depósito de informações do provedor do emissor, utilizando o perfil
de transmissão de JMS criado para transmissão de eventos assíncronos.
- Implementa o bean orientado a mensagens utilizado pela Common Event Infrastructure
para receber eventos enviados de forma assíncrona ao servidor de eventos, utilizando uma porta listener ou uma especificação de ativação JMS.
Se quiser configurar mais de uma fila JMS no servidor de eventos, poderá executar esse script várias vezes, especificando nomes de aplicativos corporativos e filas JMS diferentes.
Cada vez que o script é executado, ele implementa um bean orientado a mensagens
adicional e configura novos recursos para utilizar a fila JMS especificada.
Para configurar o sistema de mensagens de eventos para utilizar um provedor JMS externo:
Etapas para Esta Tarefa
- Vá para o diretório $WAS_HOME/event/application do perfil que define o ambiente de tempo de execução do WebSphere ESB em que você deseja configurar o sistema de mensagens padrão. (Substitua o profile_path pelo caminho do diretório que contém o perfil do WebSphere ESB).
- Execute o script event-message.jacl utilizando o comando wsadmin:
- Sistemas Windows
%WAS_HOME%\bin\wsadmin -profile event-profile.jacl -f event-message.jacl
-action install -earfile event-message.ear -node node_name
[-server server_name] [cluster cluster_name]
-appname app_name -qjndi queue -qcfjndi connection_factory
[-listenerport listener_port] [-activationspecjndi spec_name]
[-eventprofilescope scope] [-trace]
- Sistemas Linux e UNIX
$WAS_HOME/bin/wsadmin -profile event-profile.jacl -f event-message.jacl
-action install -earfile event-message.ear -node node_name
[-server server_name] [cluster cluster_name]
-appname app_name -qjndi queue -qcfjndi connection_factory
[-listenerport listener_port] [-activationspecjndi spec_name]
[-eventprofilescope scope] [-trace]
$WAS_HOME/bin/wsadmin -profile event-profile.jacl -f event-message.jacl
-action install -earfile event-message.ear -node node_name
[-server server_name] [cluster cluster_name]
-appname app_name -qjndi queue -qcfjndi connection_factory
[-listenerport listener_port] [-activationspecjndi spec_name]
[-eventprofilescope scope] [-trace]
Os parâmetros do script
event-message.jacl são os seguintes:
- node_name
- O nó do WebSphere ESB no qual o aplicativo do sistema de mensagens será implementado. Para determinar o nome do nó:
- Execute o script profile_path/bin/setupCmdLine.
- Execute o comando echo $WAS_NODE (sistemas Linux/UNIX) ou echo
%WAS_NODE% (sistemas Windows).
Esse valor faz distinção entre maiúsculas e minúsculas.
Se você estiver implementando o aplicativo em um cluster, omita esse parâmetro.
- server_name
- O servidor WebSphere no qual o aplicativo de sistema de mensagens será implementado.
Esse valor faz distinção entre maiúsculas e minúsculas.
Se você estiver implementando o aplicativo em um cluster, omita esse parâmetro.
- cluster_name
- O cluster do WebSphere no qual você deseja implementar o aplicativo do sistema de mensagens.
Especifique esse parâmetro somente se você estiver configurando o sistema de mensagens em um cluster e não estiver especificando um nó e servidor.
Nota: Se estiver utilizando o banco de dados de eventos Cloudscape, o armazenamento em cluster é suportado somente para finalidades de testes (não em um ambiente de produção).
- app_name
- O nome a ser utilizado para o aplicativo corporativo do sistema de mensagens. Esse parâmetro é requerido.
- queue
- O nome de JNDI da fila JMS a ser utilizada pelo aplicativo corporativo do sistema
de mensagens. Essa fila é utilizada para o transporte de mensagens assíncrono para o servidor de eventos. Se você implementar o aplicativo do sistema de mensagens várias vezes,
deverá especificar uma fila de JMS diferente a cada vez.
- connection_factory
- O nome de JNDI da connection factory JMS a ser utilizada pelo aplicativo corporativo
do sistema de mensagens.
- listener_port
- O nome da porta listener utilizada pelo aplicativo corporativo de sistema de mensagens.
A porta listener é especificada no descritor de implementação. Especifique esse parâmetro somente se seu aplicativo de sistema de mensagens utilizar uma porta listener.
- spec_name
- O nome de JNDI da especificação da ativação utilizado pelo aplicativo corporativo do sistema de mensagens.
A especificação da ativação é especificada no descritor de implementação.
Especifique esse parâmetro somente se seu aplicativo de sistema de mensagens utilizar uma especificação de aplicativo.
- eventprofilescope
- O escopo dos objetos do perfil de configuração a serem criados para o sistema de mensagens
de eventos. Esse parâmetro é opcional. Se você especificar um escopo, um perfil de transmissão de JMS
e um perfil do depósito de informações do provedor do emissor serão criados no escopo especificado. Os valores válidos são cell, node e server.
O parâmetro opcional -trace faz
com que informações adicionais de depuração sejam exibidas na saída padrão.
Nota: - Se você especificar um caminho completo para o local do arquivo event-message.ear, assegure-se de que sejam utilizadas barras
(/) no caminho, mesmo nos sistemas Windows.
- Se você estiver implementando o aplicativo do sistema de mensagens em um nó independente, especifique o parâmetro -conntype none opcional para executar wsadmin no modo local.
Após iniciar o script, será solicitado que você digite seu ID do usuário e senha do JMS.