Em um ambiente de gerenciamento flexível, é possível enviar tarefas a destinos remotos para gerenciar aplicativos, modificar a configuração do produto em máquinas remotas ou executar tarefas gerais, como executar um script.
É possível especificar quando as tarefas são iniciadas, se elas são recorrentes e quando elas expiram.
Antes de Iniciar
Antes de poder enviar uma tarefa, você deve ter
registrado pelo menos um destino com o gerenciador de tarefa. Um destino pode ser um nó de servidor de aplicativos que antes tenha sido registrado com um agente administrativo, um no do gerenciador de implementação ou um computador host.
Inicie o gerenciador de tarefa e os destinos. Se um destino for um servidor de aplicativos independente, inicie também o agente
administrativo.
Seu ID para o gerenciador de tarefa deve possuir autorização para a função do administrador ou a função do operador
para enviar tarefas. Ao enviar uma tarefa, é possível especificar um nome de usuário e senha para autenticação e autorização no destino ou destinos. Se você não fornecer um nome de usuário e senha nos parâmetros da tarefa, as credenciais para o
requisitante da tarefa no gerenciador de tarefa serão usadas para este propósito. Ao enviar uma tarefa para diversos destinos, o nome de usuário e a senha ou as credenciais para o requisitante devem se aplicar a todos os destinos da tarefa.
É possível simplificar a administração de diversos destinos enviando tarefas com relação a grupos de destinos.
Cada grupo de destinos representa um grupo de destinos. Para poder enviar uma tarefa de um grupo de destinos, você deve ter criado o grupo de destinos.
A funcionalidade do gerenciador de tarefa existe em um gerenciador de tarefas e em um gerenciador de implementação. Para mais clareza, esta documentação faz referência a essa funcionalidade como gerenciador de tarefa.
Sobre Esta Tarefa
É possível usar o console administrativo do gerenciador de tarefas ou do gerenciador de implementação para enviar tarefas para gerenciar aplicativos, modificar a configuração do produto em estações de trabalho remotas ou executar tarefas de propósito geral, como a execução de scripts. Para concluir o envio da tarefa, escolha o tipo de tarefa, escolha os destinos em que deseja executar a tarefa, especifique os parâmetros da tarefa que sejam específicos ao tipo de tarefa, planeje a tarefa, revise o resumo e envie a tarefa.
Os tópicos dessa seção descrevem como enviar tarefas usando o console do gerenciador de tarefas ou o console do gerenciador de implementação. Em vez de usar um console, é possível enviar tarefas a partir da linha de comandos, usando o comando wsadmin submitJob no grupo de comandos AdministrativeJobs. Consulte o tópico sobre tipos de
tarefas administrativas.
Procedimento
- Clique em na árvore de navegação do console do gerenciador de tarefas ou no console do gerenciador de implementação.
- Escolha o tipo de tarefa.
- Selecione o tipo de tarefa na lista.
A lista de tipos de tarefa varia com base nos destinos que você
registrou com o gerenciador de tarefa. Os valores exibidos na lista são recuperados dos comandos
getJobTypes e
getJobTypeMetadata do objeto AdminTask. É possível ter tipos de tarefas que gerenciam aplicativos, modificam a configuração do produto em máquinas remotas ou executam tarefas gerais como executar um script.
Os seguintes tipos de tarefas existem:
- Como opção, especifique uma descrição da tarefa.
A descrição é uma cadeia que pode conter até 256 caracteres. A descrição padrão é o tipo de tarefa. É possível alterar ou incluir uma descrição padrão. A descrição é útil ao utilizar a
função Localizar para visualizar tarefas existentes.
- Clique em Avançar.
- Escolha os destinos das tarefas.
Você está determinando os destinos em que deseja executar a tarefa.
- Selecione um grupo de destinos da lista ou selecione Nome de Destino.
Somente grupos de destinos que são válidos para o tipo de tarefa que você selecionou são exibidos na lista de grupos de destinos.
- Se você selecionou Nome de destino,
então insira um nome de destino e clique em
Incluir, ou gere uma lista de destinos
utilizando a opção Localizar.
- Nome de destino que você inserir
- Se você inseriu um nome de destino, ele deve ser um destino que
foi registrado no gerenciador de tarefa. O nome de destino é validado quando você clicar em
Avançar.
- Lista de nomes de destino
- Clique em Localizar.
A página Localizar Destinos
é exibida.
- Para Tipo de destino ,
selecione Todos, Host,
ou Nó. O valor padrão é Todos.
- Para executar a operação Localizar em palavras-chave específicas,
especifique um operador válido e uma cadeia de texto.
A lista de palavras-chave é dinâmica.
Os operadores válidos são = (igual),
!= (diferente), is null e is
not null.
A cadeia de texto pode ser completa ou parcial e pode conter um asterisco (*) para incluir caracteres variáveis ou desconhecidos.
- Clique em Localizar.
Os resultados são exibidos
na lista Destinos Excluídos e são selecionados.
- Mova os destinos que deseja destinar da lista Destinos
Excluídos para a lista Destinos Escolhidos.
- Para mover destinos específicos da lista Destinos Excluídos
para a lista Destinos Escolhidos, selecione os destinos
na lista Destinos Excluídos e clique em >.
- Para mover destinos específicos da lista Destinos Escolhidos
para a lista Destinos Excluídos, selecione destinos
na lista Destinos Escolhidos e clique em <.
- Após ter uma lista dos destinos desejados na lista Destinos
Escolhidos, clique em OK.
Os destinos
são exibidos na página Escolher Destinos da Tarefa.
- Se o destino solicitar uma autenticação, especifique um nome de usuário e uma senha para que o destino possa executar a tarefa.
Por exemplo, para acessar um host de destino, geralmente, são especificados valores para Nome de Usuário e Autenticação de Senha.
O nome de usuário e a senha são os valores de login do host. Se o host de destino não exigir uma senha, deixe os campos em branco.
Se
desejar que um usuário substituto execute comandos no host de destino,
selecione
Usar sudo para alterar os usuários antes de
uma execução da tarefa e, em seguida, especifique o nome de usuário e a senha para
o usuário substituto, conforme necessário.
sudo significa
"substitute user do".
Se o
host de destino não requerer uma senha, deixe os campos de senha
em branco. As seguintes combinações de seleção são válidas:
- Selecionar Usar sudo e deixar o nome de usuário e senha
sudo em branco. Essas seleções usam o usuário padrão que é configurado no
arquivo /etc/sudoers e também a senha do usuário de
conexão.
- Selecione Usar sudo, especifique um nome do usuário e deixe a senha
sudo em branco. Essas seleções usam o usuário especificado e também a senha do usuário de
conexão.
- Selecionar Usar sudo, especificar um nome do usuário e também uma senha
sudo. Estas seleções usam o usuário e a senha do
sudo especificados.
O padrão é não usar o sudo. A opção de sudo é suportada
apenas nos sistemas operacionais AIX, HP-UX, Linux e Solaris.
Se desejar usar uma autenticação de chave pública-privada, selecione
Autenticação de Chave Pública-Privada e, em seguida, especifique o caminho completo para o keystore e, se necessário, para o keystore, a passphrase.
boas práticas: Para usar autenticação de chave pública-privada, primeiro gere um par de chaves usando uma ferramenta de geração de chaves, como ssh-keygen. Depois,
inclua a chave pública no campo authorized_keys
do usuário no host de destino. Em seguida, nesta página Escolher
Destinos da Tarefa, especifique o nome de usuário, o arquivo de chave privado
completo e, opcionalmente, a passphase completa.
- Clique em Avançar.
- Especifique os parâmetros da tarefa.
A lista de parâmetros de tarefas é dinâmica e baseada no tipo de tarefa. Por exemplo, se o tipo de tarefa destina-se a instalar um aplicativo, especifique o nome do aplicativo, o local do aplicativo a ser instalado e, opcionalmente, o nome do servidor em que o sistema instala o aplicativo.
Ao enviar uma tarefa para diversos destinos, os valores de parâmetro devem se aplicar a todos os destinos da tarefa.
A tabela a seguir descreve os tipos de parâmetros.
Tipo de Parâmetro |
Description |
Sequência |
É possível inserir texto para os parâmetros apropriados. O texto será validado apenas quando a tarefa for enviada. |
Recurso de Destino |
Você pode selecionar um recurso de destino. A opção Localizar estará disponível para procurar o recurso, dependendo do tipo de tarefa selecionado na primeira etapa. |
- Como opção, clique em Localizar, se estiver disponível.
A página Localizar Recursos de Destino
é exibida.
- Para executar a operação Localizar em palavras-chave específicas,
especifique um operador válido e uma cadeia de texto.
A lista de palavras-chave é dinâmica. Os operadores válidos são = (igual),
!= (diferente), is null e is
not null. A cadeia de texto pode ser completa ou parcial e pode conter um asterisco (*) para incluir caracteres variáveis ou desconhecidos.
- Clique em Localizar.
Os resultados são exibidos na
lista Recursos disponíveis comuns a todos os terminais selecionados.
- Clique em OK para salvar os resultados e retornar
para a página de especificação de parâmetros da tarefa.
- 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 especificar diversos endereços de e-mail, separe-os por vírgulas. Os endereços de e-mail são salvos em suas preferências de console. Cada endereço de e-mail é validado para erros de formatação.
- Selecione quando a tarefa está disponível para envio.
É possível enviar a tarefa para ser disponibilizada agora ou especificar uma hora e data em que a tarefa será recuperada
do gerenciador de tarefas.
- Selecione a expiração da tarefa.
A expiração da tarefa é a mesma data na qual a tarefa não
está mais disponível aos destinos para execução. É possível utilizar a expiração padrão, especificar uma hora e data para a expiração da tarefa ou especificar um período de tempo em que a tarefa será expirada. A expiração padrão é definida na página Configuração do Gerenciador de 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 envie a tarefa.
- Se você deseja alterar as opções, clique em Prévio até
atingir a página que deseja alterar. Faça a correção nessa
página e, em seguida, continue nas páginas até revisar a página
Resumo e Submeter a Tarefa.
- Quando estiver satisfeito com as opções, clique em Concluir para enviar a tarefa.
A página de coleção Status da Tarefa
é exibida onde apenas o status para a tarefa que você submeteu
é exibido.
Resultados
Depois de enviar uma tarefa, ela pode não ser executada imediatamente.
O gerenciador de tarefa enfileira tarefas enviadas. Os agentes administrativos e
gerenciadores de implementação sondam o gerenciador de tarefa para tarefas quando
eles estão on-line, com base em seus intervalos de sondagem configurados. O intervalo de sondagem
padrão é de 30 segundos. Leva pelo menos dois ciclos de sondagem para agentes
administrativos e gerenciadores de implementação recuperarem tarefas e, em seguida, retornarem resultados para o gerenciador de tarefa. Dependendo de quanto tempo leve
para o destino processar a tarefa, podem ser necessários mais ciclos para concluir a tarefa.
O que Fazer Depois
Após submeter uma tarefa, a página Status da Tarefa
mostra um ID da tarefa exclusivo; por exemplo, 122763380912576341. É possível usar
o ID da tarefa para consultar, suspender, resumir ou excluir a tarefa. Quando você clica em um ID da tarefa, vê as propriedades específicas dessa tarefa, incluindo o prazo de ativação e de expiração da tarefa e seu status. Se você clicar no
link de status da tarefa, vê o histórico da tarefa para cada destino da tarefa.
Clique no ícone de atualização de status
para atualizar o status exibido.
É possível verificar o estado e o status
de uma tarefa usando o console de gerenciador de tarefa ou um comando wsadmin.
O estado da tarefa
mostra onde a tarefa está no processo de execução a partir da perspectiva
do gerenciador de tarefa. A Tabela 1 lista os estados da tarefa.
Tabela 1. Estados da Tarefa. O estado indica
se a tarefa está ativa.Estados da Tarefa |
Description |
Pendente |
Você enviou a tarefa, mas a tarefa ainda não está disponível
para ser executada nos destinos. |
Ativo |
Um ou mais destinos iniciaram a execução da tarefa. |
Expirado |
A tarefa expirou. Se um destino começou a
executar a tarefa antes dela expirar, a tarefa continua a execução. Após uma
tarefa expirar, um destino não pode começar a executar a tarefa. |
Suspenso |
A operação da tarefa foi suspensa. Se um destino começou a
executar a tarefa antes dela ser suspensa, a tarefa continua a execução.
Após uma
tarefa ser suspensa, um destino não pode começar a executar a tarefa. |
O
status da tarefa mostra um histórico do processamento de tarefa
no destino gerenciado. Um histórico da tarefa típico é para o status progredir
de Distribuído para Em Andamento para Bem-Sucedido. A Tabela 2 mostra os valores
de status da tarefa.
Tabela 2. Descrições de Status de Tarefa. O status indica se a tarefa foi concluída
com êxito.Status da Tarefa |
Description |
Nenhuma tentativa |
O destino não recebeu a tarefa. O status
é NOT_ATTEMPTED. |
Distribuído |
O destino recebeu a tarefa. O status é
DISTRIBUTED. |
Em andamento |
O destino está executando a tarefa
simultaneamente com outras tarefas. O status é ASYNC_IN_PROGRESS. |
Com falha |
A tarefa falhou e não está mais em execução. O
status é FAILED. |
Rejeitado |
O destino rejeitou a tarefa porque, por
exemplo, o destino não suporta o tipo de tarefa. O status é REJECTED. |
Bem-sucedido |
A tarefa foi concluída com êxito. O status é SUCCEEDED. |
Parcialmente com êxito |
Aplica-se apenas nas tarefas startCluster e stopCluster
onde o cluster possui vários membros de cluster e para as tarefas startApplication
e stopApplication onde o aplicativo é instalado em vários destinos. Se somente alguns membros de cluster forem iniciados ou interrompidos ou o aplicativo não iniciar em todos os destinos do aplicativo, o status
da tarefa é PARTIALLY_SUCCEEDED. |
Por padrão, tarefas enviadas permanecem ativas por um dia (24 horas). Uma tarefa ativa é um processo Java em execução que consome recursos
de máquina. Exclua tarefas que não são mais necessárias. É possível usar a página de Status da Tarefa do console do gerenciador de tarefa. Clique em , selecione as tarefas e clique em
Excluir.