O aplicativo corporativo do servidor de eventos precisa ser implementado em cada ambiente de tempo de execução do WebSphere em que o perfil tenha sido estendido para utilizar a Common Event Infrastructure.
Por Que e Quando Desempenhar Esta Tarefa
O aplicativo corporativo do servidor de eventos é empacotado no arquivo EAR
event-application.ear. O script event-application.jacl instala esse aplicativo no WebSphere ESB.
Etapas para Esta Tarefa
- Vá para o diretório profile_path/event/application
para o perfil que define o ambiente de tempo de execução do WebSphere Application Server
no qual você deseja implementar o aplicativo. (Substitua profile_path pelo
caminho para o diretório que contém o perfil do WebSphere Application Server).
- Execute o script event-application.jacl utilizando o comando wsadmin:
- Sistemas Windows
profile_path\bin\wsadmin [-conntype none] -profile event-profile.jacl
-f event-application.jacl -action action -earfile event-application.ear
-backendid backend_id -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 event-application.jacl -action action -earfile event-application.ear
-backendid backend_id -node node_name -server server_name
[-cluster cluster_name] [-appname app_name] [-trace]
Os parâmetros são os seguintes:
- action
- A ação a ser desempenhada. Para instalar o aplicativo corporativo, especifique install.
Para atualizar um aplicativo do servidor de eventos existente já instalado,
especifique update. Durante uma atualização, o script faz uma cópia de backup
do arquivo EAR do aplicativo existente no diretório atual; se necessário,
posteriormente, será possível utilizar esta cópia de backup para restaurar a versão
anterior do aplicativo.
- backend_id
- O tipo de backend do banco de dados a ser utilizado pelo aplicativo corporativo.
Este deve ser um dos seguintes valores:
- CLOUDSCAPE_V51_1
- DB2UDBNT_V82_1
- DB2UDBNT_V8_1
- ORACLE_V10_1
- ORACLE_V9_1
- DB2UDBOS390_V8_1
- DB2UDBOS390_V7_1
- node_name
- O nó do WebSphere ESB no qual o servidor de eventos será implementado. Para descobrir o nome do nó, siga estas
etapas:
- 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 um aplicativo corporativo em um cluster, omita este parâmetro.
- server_name
- O servidor WebSphere no qual o aplicativo corporativo do servidor de eventos
será implementado. Esse valor faz distinção entre maiúsculas e minúsculas.
Se você estiver implementando um aplicativo corporativo em um cluster, omita este parâmetro.
- cluster_name
- O cluster do WebSphere no qual o aplicativo corporativo do servidor de eventos
será implementado. Especifique este parâmetro apenas se estiver implementando o
aplicativo em um cluster e não estiver especificando um nó e um servidor.
- app_name
- O nome a ser utilizado pelo aplicativo corporativo Common Event Infrastructure. Este parâmetro é opcional; o valor padrão é CommonEventInfrastructureServer.
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-application.ear, certifique-se de que sejam utilizadas barras
(/) no caminho, mesmo nos sistemas Windows.
- Se estiver implementando o aplicativo em um nó independente, especifique
o parâmetro -conntype none opcional para executar wsadmin
em modo local.
Para obter informações adicionais sobre o utilitário wsadmin, consulte
a documentação do WebSphere Application Server.
Resultado
Após a conclusão do script
event-application.jacl, o aplicativo corporativo do Common
Event Infrastructure será implementado no servidor
ou cluster especificado. Em um ambiente do
WebSphere ESB Network Deployment, se o aplicativo já estiver instalado, o script incluirá apenas as informações de implementação do nó e do servidor especificados.