Em um ambiente de gerenciamento flexível, é possível enviar a tarefa
Instalar aplicativo para implementar um aplicativo corporativo nos
destinos do servidor de aplicativos gerenciados do gerenciador de tarefa. Um aplicativo corporativo é um arquivo
EAR (Enterprise Archive) que está em conformidade com especificações
Java™
Platform, Enterprise Edition (Java EE).
Antes de Iniciar
Antes de instalar um aplicativo corporativo em um servidor de aplicativos, faça o seguinte:
- Desenvolva e monte o arquivo EAR. A tarefa Instalar Aplicativo
não altera ligações de Java Naming and Directory (JNDI) e de outros aplicativos. Se você tiver que configurar os valores de ligação durante a implementação, não use o gerenciador
de tarefa para implementar o aplicativo. Em vez disso, utilize uma ferramenta de implementação como o assistente de instalação do aplicativo do console administrativo ou um script wsadmin e especifique destinos gerenciados do gerenciador de tarefa como destinos de implementação.
- Inicie o gerenciador de tarefa e os destinos. Cada servidor no qual você está instalando um aplicativo deve estar em execução. Se um destino for um servidor de aplicativos independente, inicie também o agente
administrativo.
- Assegure-se de que os destinos sejam compatíveis com o aplicativo. Destinos da Versão 7.0 ou posteriores suportam arquivos EAR que possuam módulos Java 2 Platform,
Enterprise Edition (J2EE) 1.3, J2EE 1.4 ou Java EE 5.
- Copie o arquivo EAR para o diretório /config/temp/JobManager do perfil do gerenciador de tarefa.
Se o diretório JobManager não existir, crie o diretório
JobManager no diretório /config/temp do perfil do
gerenciador de tarefa.
Para criar e acessar o diretório, você deve ter autoridade apropriada.
Se o arquivo EAR existir em um destino gerenciado, você poderá executar a tarefa Coletar arquivo para copiar o arquivo EAR do destino gerenciado para o diretório job_manager_profile/config/temp/JobManager/jobToken/targetName.
Consulte o tópico na tarefa de arquivo de coleta.
- Execute a tarefa Distribuir arquivo para copiar o arquivo EAR para destinos gerenciados. Lembre-se de qualquer valor de destino
que for especificado ao distribuir o arquivo.
Evitar Problemas: Você deve distribuir um arquivo EAR para os destinos antes de poder executar a tarefa
Instalar aplicativo. A tarefa Distribuir arquivo copia o arquivo EAR no diretório
/config/temp/JobManager do perfil do gerenciador de tarefa para os destinos. O nome do arquivo EAR nos destinos se transforma em qualquer valor que você possa especificar para o destino ao distribuir o arquivo. Consulte o tópico na tarefa de arquivo distribuído.
gotcha
Sobre Esta Tarefa
É possível usar o console
administrativo do gerenciador de tarefas ou gerenciador de implementação para enviar uma tarefa que implemente um arquivo de aplicativo corporativo nos destinos selecionados. No console, escolha a tarefa Instalar Aplicativo, especifique o arquivo a ser instalado, especifique as opções da tarefa, planeje a tarefa, revise o resumo e envie a tarefa.
Em vez de usar um console, é possível executar o script da tarefa installApplication no grupo de comandos AdministrativeJobs para implementar o arquivo de aplicativo nos destinos. Consulte o tópico de tipos de Tarefa
Administrativa.
Procedimento
- Clique em na árvore de
navegação do console administrativo.
- Escolha uma tarefa para instalar um arquivo de aplicativo.
- Selecione a tarefa Instalar Aplicativo na lista.
- Como opção, especifique uma descrição da tarefa.
- Clique em Avançar.
- Escolha os destinos da tarefa nos quais você deseja implementar o arquivo de aplicativo.
- Selecione um grupo de destinos a partir da lista ou selecione Nomes
de destino.
Apenas grupos de destinos que são válidos
para o tipo de tarefa que você selecionou são exibidos na lista de grupos
de destino.
- Se você selecionou Nomes de destino,
especifique um nome de destino e clique em Incluir ou
clique em Localizar e especifique os destinos escolhidos na
página Localizar destinos.
- Se a autenticação do usuário for obrigatória, especifique um nome de usuário, senha ou qualquer outro valor de autenticação necessário.
- Clique em Avançar.
- Especifique os parâmetros para a tarefa Instalar Aplicativo.
- Para Nome do Aplicativo, especifique o nome do arquivo base do
arquivo de aplicativo.
Por padrão, a tarefa anexa a extensão do arquivo
.ear para o nome do aplicativo.
Suponha que você tenha distribuído o arquivo DynaCacheEsi.ear conforme descrito no tópico sobre distribuição de arquivos do gerenciador de tarefa para destinos. Para continuar com o exemplo
DynaCacheEsi.ear nesse tópico, especifique o nome do arquivo do aplicativo sem a extensão
.ear:DynaCacheEsi
- Se você especificou um valor de Destino diferente
do nome do arquivo EAR ao distribuir o aplicativo, especifique esse
valor de destino para Local do Aplicativo.
Por padrão, a tarefa procura pelo aplicativo no local de destino padrão. Se você não especificar um valor para Local do aplicativo, então o local assume o padrão downloadedContent/application_name.ear do destino gerenciado. Portanto, se você especificou DynaCacheEsi para Nome de
Aplicativo, o local do aplicativo será padronizado como
downloadedContent/DynaCacheEsi.ear.
Ao
distribuir o arquivo, se você especificou um valor para Destino diferente do nome do arquivo EAR, especifique o valor de Destino
para Local do Aplicativo.
Para o exemplo DynaCacheEsi.ear, você não especificou
o nome do arquivo EAR, DynaCacheEsi.ear, para o
valor de destino ao distribuir o arquivo EAR. Você especificou dynacache_esi_sample para o
valor de destino. Assim, o local do aplicativo é downloadedContent/dynacache_esi_sample.
Para ativar os destinos para localizar o aplicativo, especifique o valor de destino:
dynacache_esi_sample
- Se você estiver instalando o aplicativo em um nó federado de um gerenciador de implementação, especifique os nomes do servidor de destino, do nó ou do cluster.
Para Nome do Servidor, clique em Localizar e
especifique o servidor de destino. Baseado em sua seleção, o produto completará os valores para os nomes do servidor e do nó.
Se o destino for um
cluster, para Nome do Cluster, clique em Localizar e especifique o cluster de destino.
- Clique em Avançar.
- Planeje a tarefa.
As horas e datas especificadas são relacionadas ao gerenciador de tarefas.
- Opcionalmente, especifique um ou mais endereços de e-mail em que as notificações são
enviadas quando a tarefa é concluída.
Se você
especificar múltiplos endereços de e-mail, separe-os com vírgulas.
- Selecione quando a tarefa está disponível para envio.
- Selecione a expiração da tarefa.
- Como opção, especifique um intervalo recorrente para a tarefa, uma data e hora de início e de encerramento para o intervalo.
- Clique em Avançar.
- Revise o resumo e clique em Concluir para enviar a tarefa.
Resultados
Os destinos executam a tarefa e tentam instalar o arquivo.
O que Fazer Depois
Na página Status de Tarefa, clique no ID da tarefa Instalar Aplicativo e visualize o
status de tarefa. Clique no ícone de atualização de status
para atualizar o status exibido.
Se a tarefa não for bem-sucedida, visualize quaisquer mensagens de erro
resultantes da execução da tarefa, corrija a condição de erro e envie a tarefa novamente.
Se a instalação for bem-sucedida, o nome do aplicativo será mostrado na lista de recursos de destino. Clique em para ver a lista de recursos.
Após a instalação do aplicativo, é possível
executar as tarefas que administram o aplicativo ou o arquivo:
- Iniciar o aplicativo
- Parar o aplicativo
- Atualizar o aplicativo
- Desinstalar o aplicativo
- Remover o arquivo