A configuração padrão do sistema de mensagens para transporte assíncrono de eventos utiliza o recurso padrão do sistema de mensagens do WebSphere ESB como o provedor JMS (Java Messaging Service).
Por Que e Quando Desempenhar Esta Tarefa
O script
default-event-message.jacl fornece uma maneira
de fazer rapidamente uma configuração do sistema de mensagens padrão
utilizando o recurso de sistema de mensagens padrão do WebSphere como o provedor JMS. Esse script configura todos os objetos de configuração
requeridos para transmissão de eventos assíncrona:
- Cria uma fila JMS e uma connection factory de fila utilizando o
recurso de sistema de mensagens padrão.
- Ele cria um barramento de integração do serviço e inclui membros no barramento, associando o barramento a filas, tópicos e
connection factories.
- Cria um perfil de transmissão JMS utilizando a fila e a connection
factory criadas.
- Configura o perfil do depósito de informações do provedor do emissor padrão para utilizar o perfil de transmissão JMS criado para transmissão de eventos assíncrona.
- Implementa o bean orientado a mensagens utilizado pela Common Event Infrastructure para receber eventos enviados de forma assíncrona para o servidor de eventos.
Para configurar o sistema de mensagens padrão:
Etapas para Esta Tarefa
- Vá para o diretório profile_path/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 default-event-message.jacl utilizando o comando wsadmin:
Sistemas Windows
profile_path\bin\wsadmin [conntype -none] -profile event-profile.jacl
-f default-event-message.jacl -action action -earfile event-message.ear
-node node_name -server server_name
[-cluster cluster_name] [-appname app_name] [-trace]
Sistemas Linux e UNIX
profile_path/bin/wsadmin.sh [conntype -none] -profile event-profile.jacl
-f default-event-message.jacl -action install -earfile event-message.ear
-node node_name -server server_name
[-cluster cluster_name] [-appname app_name] [-trace]
Os parâmetros 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: A configuração do sistema de mensagens padrão utiliza um banco de dados de eventos Cloudscape. O banco de dados Cloudscape não suporta o armazenamento em cluster em um ambiente de produção.
É possível utilizar o WebSphere Process
Server para especificar um mecanismo do sistema de mensagens diferente,
especificando uma origem de dados que se conecte a um banco de dados
de eventos que suporta várias conexões.
- app_name
- O nome a ser utilizado para o aplicativo corporativo do sistema de mensagens. Este parâmetro
é opcional; o valor padrão é EventServerMdb.
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.