Você pode instalar um arquivo do aplicativo corporativo em
um servidor de aplicativos ou cluster
arrastando ou copiando um enterprise archive (EAR), web application
archive (WAR), Java™ archive
(JAR), ou Session Initiation Protocol (SIP) archive (SAR) para um
diretório monitorado. Um arquivo de aplicativo corporativo deve estar em conformidade com a especificação
Java Platform, Enterprise Edition (Java EE).
Antes de Iniciar
Desenvolver e montar o arquivo EAR, JAR, WAR ou SAR. É
possível usar uma ferramenta de montagem suportada, como um produto IBM® Rational
Application Developer para WebSphere Software
para especificar ligações e montar o arquivo.
Instalar
um arquivo EAR, JAR, WAR ou SAR incluindo-o em um diretório monitorado
não altera ligações existentes da Java Naming and Directory (JNDI) e
de outros aplicativos. Se você precisar definir valores de ligação
durante a implementação, instale o arquivo utilizando o assistente
de instalação do aplicativo do console administrativo, um wsadmin ou
um arquivo de propriedade que define as ligações.
Consulte Instalando
arquivos de aplicativos corporativos incluindo os arquivos de
propriedades em um diretório monitorado.
Por padrão, a implementação de diretório monitorado não fica ativada. Antes de usar a implementação de diretório monitorado,
você deve ativá-la. Consulte Configurando Valores de Implementação do Diretório Monitorado.
Restrição: A instalação de um arquivo EAR, JAR, WAR ou SAR incluindo-o em um diretório monitorado está disponível apenas em sistemas operacionais distribuídos e z/OS. Não é suportado em sistemas operacionais IBM i.
Evitar Problemas: Não use implementação do diretório monitorado em um
ambiente de produção no qual o aplicativo deve permanecer continuamente
disponível. Em vez disso, em ambientes de produção, use um processo automatizado
que coordena atualizações de aplicativos para cada servidor de aplicativos drenando
primeiro solicitações de cada servidor, atualizando o aplicativo e, em seguida,
reiniciando o servidor. Para obter informações sobre este processo automatizado,
consulte
IBM WebSphere Developer Technical Journal: Manter disponibilidade
contínua durante atualização dos aplicativos corporativos do WebSphere
Application Server.
gotcha
Sobre Esta Tarefa
É possível
implementar um arquivo EAR, JAR, WAR ou SAR em um servidor de
aplicativos ou cluster arrastando ou
copiando o arquivo para um diretório monitorado.
Para servidores de aplicativos de base (independentes),
o diretório monitorado é o diretório monitoredDeployableApps/servers/server_name
do perfil do servidor de aplicativos.
Para gerenciadores de implementação,
os diretórios monitorados são os diretórios monitoredDeployableApps/servers/server_name, monitoredDeployableApps/nodes/node_name/servers/server_name
e monitoredDeployableApps/clusters/cluster_name
do perfil de gerenciador de implementação.
O produto varre um
diretório monitorado em busca de novos aplicativos numa frequência
não maior do que a cada cinco segundos, por padrão. Após localizar um novo arquivo EAR, JAR, WAR, ou SAR em um diretório
monitorado, o produto instala o arquivo no servidor de
aplicativos ou cluster e inicia o
aplicativo ou módulo.
Após incluir um arquivo EAR em um diretório monitorado,
o produto cria uma cópia temporária do arquivo EAR em outro
diretório e instala o arquivo no servidor. Depois de incluir um arquivo JAR, WAR ou SAR em um diretório
monitorado, o produto cria uma cópia temporária do archive em
outro diretório, quebra o archive em um arquivo EAR denominado archive_extension.ear,
e instala o novo arquivo EAR. Por exemplo, simpleApp.war é
instalado como simpleApp_war.ear. O archive
original incluído no diretório monitorado não é alterado.
É
possível atualizar arquivos de aplicativo da mesma maneira. Se você
posteriormente incluir um arquivo atualizado EAR, JAR, WAR ou SAR no
mesmo diretório monitorado, o produto para o aplicativo implementado
anteriormente, instala o arquivo atualizado no servidor de
aplicativos ou cluster, e inicia o
arquivo ou modulo atualizado. Por exemplo, suponha que você implementou anteriormente
my_app.ear arrastando-o para um diretório
monitorado. Se, posteriormente, você arrastar um arquivo denominado my_app.ear
até o diretório monitorado, o produto substituirá o arquivo EAR implementado anteriormente
pelo arquivo EAR atualizado que tem o mesmo nome. O servidor
ou cluster deve estar executando para o
produto perceber as mudanças nos arquivos em seu diretório
monitorado.
É possível usar um navegador de arquivo gráfico para
arrastar e copiar o arquivo EAR, JAR, WAR ou SAR. Alternativamente,
é possível usar os comandos do sistema operacional para copiar um
arquivo em um subdiretório
monitoredDeployableApps monitorado.
Procedimento
- Certifique-se de que o servidor de
aplicativos ou membro de cluster no qual
deseja instalar o aplicativo corporativo esteja executando.
- Certifique-se de que a implementação do diretório monitorado
esteja ativada.
Consulte Configurando valores de implementação do diretório
monitorado.
- Navegue na estrutura do arquivo do computador e localize ou crie o diretório monitorado.
Para servidores de aplicativos base (independentes), o diretório
monitorado está sob o perfil do servidor de aplicativos. O caminho do diretório é:
app_server_root/profiles/application_server_profile_name/monitoredDeployableApps/servers/server_name
app_server_root/AppServer/profiles/default/monitoredDeployableApps/servers/server_name
Para
servidores independentes, o produto cria um diretório
server_name monitorado automaticamente.
Para servidores de aplicativos em um nó
gerenciado (federado) de um gerenciador de implementação, crie um
diretório monitorado sob o perfil de gerenciador de implementação. O caminho do diretório é:
app_server_root/profiles/deployment_manager_profile_name/monitoredDeployableApps/servers/server_name
app_server_root/AppServer/profiles/default/monitoredDeployableApps/servers/server_name
Para
servidores de aplicativos em um nó federado, você deve criar o
diretório
server_name monitorado. O nome do
diretório deve corresponder ao nome de um servidor existente.
Se vários servidores do mesmo nome estiverem em
nós federados diferentes, e você deseja que somente um dos servidores
seja um diretório monitorado, pode especificar o nó e o servidor
para o diretório monitorado. Crie os diretórios
/nodes/node_name/servers/server_name
sob o perfil de gerenciador de implementação. O caminho do diretório é:
app_server_root/profiles/deployment_manager_profile_name/monitoredDeployableApps/nodes/node_name/servers/server_name
app_server_root/DeploymentManager/profiles/default/monitoredDeployableApps/nodes/node_name/servers/server_name
Você
deve criar diretórios para o nó e o servidor. O nome de diretório
node_name deve
corresponder ao nome de um nó existente. O nome de diretório
server_name deve corresponder
ao nome de um servidor existente no nó.
Para clusters, crie o diretório monitorado sob
o perfil de gerenciador de implementação. O caminho do diretório é:
app_server_root/profiles/deployment_manager_profile_name/monitoredDeployableApps/clusters/cluster_name
app_server_root/DeploymentManager/profiles/default/monitoredDeployableApps/clusters/cluster_name
Você
deve criar o diretório
cluster_name
monitorado.
O nome de diretório deve corresponder ao nome de um cluster
existente.
- Copie o arquivo EAR, JAR, WAR ou SAR que deseja implementar para
o diretório monitorado.
Escolha um arquivo que ainda não esteja implementado para o
diretório monitorado de destino, a menos que deseje atualizar um
arquivo implementado atualmente.
Se um arquivo já estiver implementado em um
diretório monitorado de um gerenciador de implementação e você deseja
implementar o arquivo em um diretório monitorado diferente do
gerenciador de implementação, remova o arquivo do diretório
monitorado de destino atual antes de incluir o arquivo no novo
diretório monitorado de destino. Para esse release, um arquivo de aplicativo deve existir em somente
um diretório monitorado de um gerenciador de implementação.
Resultados
O produto inclui um diretório que tem o mesmo nome que o
arquivo no diretório installedApps/cell_name
do perfil.
Além disso,
o produto grava mensagens sobre a implementação do aplicativo no arquivo SystemOut.log
no diretório app_server_root/logs/server_name.
As mensagens são iniciadas com a chave de mensagem CWLDD.
As mensagens indicam que o produto implementou o arquivo de
aplicativo e que o aplicativo está executando.
Nota: Esse tópico faz referência a um ou mais arquivos de log do servidor de aplicativos. Como uma recomendação alternativa, é possível configurar o servidor para usar a infraestrutura de log e rastreio do High Performance Extensible Logging (HPEL)
em vez de usar os arquivos SystemOut.log , SystemErr.log, trace.log e activity.log em sistemas distribuídos e IBM i. Também é possível usar HPEL em conjunção com os recursos de criação de log z/OS nativos. Se você estiver usando HPEL, será possível acessar todas as informações de log e rastreio usando a ferramenta de linha de comandos LogViewer a partir do diretório bin do perfil do servidor. Consulte as informações sobre a utilização do HPEL para resolução de problemas dos aplicativos
para obter mais informações sobre o uso do HPEL.
Para instalações em um diretório monitorado de
gerenciador de implementação, o produto não inicia um aplicativo ou
módulo automaticamente se o agente do nó ou servidor não estiver
executando. Se um agente do nó estiver parado, o produto instala o aplicativo ou
módulo no nível do gerenciador de implementação, mas não sincroniza
as mudanças com o nó e não inicia o aplicativo ou módulo. As mudanças ocorrerão no nó na próxima vez que o agente estiver
executando e ocorrer uma sincronização de nós
Se o servidor estiver parado, mas o agente do nó estiver em execução, o produto instalará o aplicativo ou módulo e sincronizará as mudanças com o nó, mas não iniciará o servidor.
Exemplo
Suponha que você deseje instalar o arquivo
DynaCacheEsi.ear de amostra copiando o arquivo
EAR para um diretório monitorado. É possível localizar o arquivo EAR
de amostra no diretório app_server_root/installableApps.
Implementando
um arquivo EAR em um servidor de aplicativos independente- Certifique-se de que o servidor de aplicativos no qual deseja
instalar o arquivo DynaCacheEsi.ear esteja
executando.
Para ver se o servidor está executando, é possível usar o comando serverStatus -all.
Para iniciar
o servidor, é possível usar o comando startServer server_name.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Por
exemplo, suponha que o servidor de aplicativos independente tenha
um nome do perfil de AppSrv02. Execute o comando
serverStatus
a partir de um prompt de comandos no diretório
app_server_root/profiles/AppSrv02/bin:
serverStatus -all
Se o
servidor não estiver em execução, inicie o servidor.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Por exemplo, para iniciar um
servidor de aplicativos denominado server1 em AppSrv02, execute o comando
startServer
a partir de um prompt de comandos no diretório
app_server_root/profiles/AppSrv02/bin:
startServer server1
A mensagem
Servidor
server1 aberto para e-business indica que o servidor
está em execução.
- Localize o diretório monitorado.
Para o perfil
AppSrv02 independente, o diretório monitorado é app_server_root/profiles/AppSrv02/monitoredDeployableApps/servers/server1.
- Copie o arquivo DynaCacheEsi.ear no diretório app_server_root/installableApps
para o diretório monitorado.
- Verifique se o diretório para aplicativos instalados existe.
app_server_root/profiles/AppSrv02/installedApps/cell_name/DynaCacheEsi.ear
app_server_root/profiles/default/installedApps/cell_name/DynaCacheEsi.ear
- Verifique se DynaCacheEsi.ear está na lista
de aplicativos corporativos instalados e em execução.
Implementando um arquivo
EAR em um nó federado de um gerenciador de implementação- Certifique-se de que o servidor de aplicativos do nó
federado no qual deseja instalar o arquivo
DynaCacheEsi.ear esteja executando.
Para ver se o servidor está executando, é possível usar o comando serverStatus -all. Para iniciar
o servidor, é possível usar o comando startServer server_name.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Por
exemplo, suponha que o servidor de aplicativos server1 esteja em um
nó que possui um nome do perfil de AppSrv01. Execute o comando
serverStatus a partir de um prompt de comandos no
diretório
app_server_root/profiles/AppSrv01/bin:
serverStatus -all
Se o
servidor não estiver em execução, inicie o servidor.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Por
exemplo, execute o comando
startServer a
partir de um prompt de comandos em um diretório
app_server_root/profiles/AppSrv01/bin:
startServer server1
- Certifique-se de que o arquivo
DynaCacheEsi.ear não exista em um diretório
monitorado do gerenciador de implementação.
Inclua um arquivo de aplicativo em apenas um diretório monitorado de um gerenciador de implementação. Se um arquivo de aplicativo já existir em um diretório monitorado
do gerenciador de implementação e você incluir um arquivo de
aplicativo que tenha o mesmo nome do arquivo em um diretório
monitorado de gerenciador de implementação diferente, o produto
desinstala o arquivo de aplicativo do destino anterior e o instala no
novo destino. Entretanto, o novo destino não é sincronizado com a
implementação porque o arquivo ainda existe no diretório
monitorado de destino anterior. Para evitar problemas com a sincronização, você deve remover
DynaCacheEsi.ear de todos os diretórios
monitorados antes de incluir DynaCacheEsi.ear no
novo diretório de destino.
- Crie o diretório monitorado.
Para nós federados, você deve
criar um diretório monitorado sob o perfil de gerenciador de
implementação, a menos que o diretório do servidor de destino já
exista.
Por exemplo, suponha que o perfil de
gerenciador de implementação seja Dmgr01 e o servidor de aplicativos
seja server1.
- Vá para o diretório /monitoredDeployableApps/servers:
app_server_root/profiles/Dmgr01/monitoredDeployableApps/servers
app_server_root/AppServer/profiles/default/monitoredDeployableApps/servers
- Se um diretório denominado server1
existe no diretório servidores,
então vá para a próxima etapa.
Se o diretório server1
não existe, crie um diretório denominado server1 no
diretório /monitoredDeployableApps/servers.
O
diretório monitorado é:
app_server_root/profiles/Dmgr01/monitoredDeployableApps/servers/server1
app_server_root/AppServer/profiles/default/monitoredDeployableApps/servers/server1
- Copie o arquivo DynaCacheEsi.ear no diretório
app_server_root/installableApps
para o diretório monitorado server1
- Verifique se o diretório para aplicativos instalados existe.
app_server_root/profiles/AppSrv01/installedApps/cell_name/DynaCacheEsi.ear
app_server_root/AppServer/profiles/default/installedApps/cell_name/DynaCacheEsi.ear
- Verifique se DynaCacheEsi.ear está na
lista de aplicativos corporativos instalados no servidor e se está
executando.
Dica: Se vários servidores do mesmo nome
estiverem em nós federados diferentes, e você deseja que somente um
dos servidores seja um diretório monitorado, pode especificar o nó e
o servidor para o diretório monitorado. Crie os diretórios
/nodes/node_name/servers/server_name
sob o perfil de gerenciador de implementação. Por exemplo, se desejar que o diretório monitorado seja o servidor de aplicativos server1 no nó myNode01, o caminho do diretório será:
app_server_root/profiles/Dmgr01/monitoredDeployableApps/nodes/myNode01/servers/server1
app_server_root/DeploymentManager/profiles/default/monitoredDeployableApps/nodes/myNode01/servers/server1
Somente
especifique o nó para um diretório monitorado se mais de um servidor
tiver o mesmo nome.
Implementando um arquivo EAR
em um cluster de um gerenciador de implementação- Certifique-se de que os membros de cluster do cluster no qual
você deseja instalar o arquivo DynaCacheEsi.ear
esteja executando.
Para este exemplo, o cluster myCluster01 tem um membro,
myClusterMember01.
- Para ver se o cluster está executando, é possível usar o comando serverStatus
-all. Para iniciar o membro de cluster, é possível usar o comando startServer
myClusterMember01.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Por exemplo, suponha
que myClusterMember01 esteja no perfil AppSrv01. Execute o comando
serverStatus a partir de um prompt de comandos no
diretório
app_server_root/profiles/AppSrv01/bin:
serverStatus -all
Se
o membro de cluster não estiver executando, execute o comando
startServer a partir de um prompt de comandos
no diretório
app_server_root/profiles/AppSrv01/bin:
startServer myClusterMember01
- Certifique-se de que o arquivo
DynaCacheEsi.ear não exista em um diretório
monitorado do gerenciador de implementação.
- Crie o diretório monitorado.
Para clusters, você deve criar um
diretório monitorado sob o perfil de gerenciador de implementação, a
menos que o diretório para um membro de cluster de destino já
exista.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Por exemplo, suponha que o perfil de
gerenciador de implementação seja Dmgr01:
- Vá para app_server_root/profiles/Dmgr01/monitoredDeployableApps/clusters.
- Se um diretório denominado myCluster01
existe no diretório /clusters, então vá para a
próxima etapa.
Se o diretório myCluster01 não
existir, crie um diretório denominado myCluster01 no
diretório /clusters.
O
diretório monitorado é:
app_server_root/profiles/Dmgr01/monitoredDeployableApps/clusters/myCluster01
app_server_root/DeploymentManager/profiles/default/monitoredDeployableApps/clusters/myCluster01
- Copie o arquivo DynaCacheEsi.ear no diretório app_server_root/installableApps
para o diretório monitorado myCluster01.
- Verifique se o diretório para aplicativos instalados existe.
app_server_root/profiles/AppSrv01/installedApps/cell_name/DynaCacheEsi.ear
app_server_root/AppServer/profiles/default/installedApps/cell_name/DynaCacheEsi.ear
- Verifique se DynaCacheEsi.ear está na lista
de aplicativos corporativos instalados no membro de cluster e se está
executando.
O que Fazer Depois
Teste o aplicativo ou o módulo implementado. Por
exemplo, aponte para um navegador da Web na URL de um aplicativo
implementado e examine o desempenho do aplicativo.
Se a implementação não for
bem-sucedida, leia as mensagens do arquivo SystemOut.log,
corrija a condição de erro e inclua o aplicativo ou o módulo no
diretório monitorado novamente.