Em um ambiente de gerenciamento flexível, é possível enviar a tarefa
Configurar Propriedades para aplicar os arquivos de propriedades nos
servidores de aplicativo gerenciados pelo gerenciador de tarefa. Após editar um arquivo de propriedades que é direcionado a um destino de servidor de aplicativos gerenciado, utilize o gerenciador de tarefa para distribuir o arquivo de propriedades para o destino gerenciado e aplicar o arquivo alterado para atualizar a configuração do servidor de aplicativos.
Antes de Iniciar
Arquivos de propriedades fornecem uma maneira de consultar e alterar a
configuração do produto. Os arquivos listam as propriedades usadas com mais frequência em pares de nome e valor.
Antes que você possa enviar uma tarefa para aplicar
um arquivo de propriedades, faça o seguinte:
- Inicie o gerenciador de tarefas. Se você estiver aplicando o arquivo de propriedades a um destino do gerenciador de implementação, inicie o gerenciador de implementação e o nó federado do gerenciador de implementação. Se você estiver aplicando o arquivo de propriedades ao destino do servidor de aplicativos independente, inicie o agente administrativo. Os destinos devem ser gerenciados pelo gerenciador de tarefa.
- Use o comando extractConfigProperties no grupo de comandos PropertiesBasedConfiguration
para o objeto AdminTask extrair um arquivo de propriedades de um servidor de aplicativos
que é gerenciado pelo gerenciador de tarefa. Você deve executar o comando
extractConfigProperties localmente ou executar um script wsadmin que
extrai o arquivo de propriedades em uma tarefa Executar o Script wsadmin.
O gerenciador de tarefa não tem uma tarefa que especificamente extraia um arquivo de propriedades.
Por exemplo, suponha que você queira extrair a configuração do servidor de um destino do servidor de aplicativos que tenha um servidor chamado server1 e um perfil chamado AppSrv02. Execute os seguintes comandos wsadmin
a partir do diretório bin do perfil AppSrv02:
wsadmin -lang jython
AdminTask.extractConfigProperties('[-propertiesFileName server.props -configData Server=server1 ]')
O
produto extrai a configuração do servidor em um arquivo denominado server.props no diretório bin do perfil AppSrv02.
- Abra um editor no arquivo de propriedades, altere o valor de uma ou mais
propriedades e salve o arquivo.
Importante: O arquivo de propriedades
deve estar em UTF-8. O arquivo gerado está em UTF-8 automaticamente.
Certifique-se de que o arquivo permaneça em UTF-8 após qualquer edição. Use um editor
que manipule UTF-8 ou US-ASCII se o arquivo não tiver caracteres fora
do conjunto de caracteres US-ASCII de 7 bits.
- Copie o arquivo properties 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 de propriedades existir em um destino gerenciado, você poderá executar a tarefa Coletar arquivo para copiar o arquivo de propriedades 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 distribuir o arquivo de propriedades do gerenciador de tarefa para um ou mais destinos do servidor de aplicativos. Lembre-se de qualquer valor que especificar para Destino porque você usa esse local para a tarefa que se aplica ao arquivo de propriedades.
Evitar Problemas: Você deve distribuir o arquivo de propriedades aos destinos antes de poder executar a tarefa
Configurar propriedades.
A tarefa Distribuir arquivo copia o arquivo de propriedades no diretório /config/temp/JobManager do perfil do gerenciador de tarefa para os destinos. O nome do arquivo de propriedades nos destinos se transforma em qualquer valor que você especificar ao distribuir o arquivo. Consulte o tópico na tarefa de arquivo distribuído.
gotcha
- Se o arquivo de propriedades usar um arquivo de mapeamento variável, execute a tarefa
Distribuir Arquivo para distribuir o arquivo de mapeamento variável. Lembre-se de qualquer valor que especificar para Destino.
Seu ID no gerenciador de tarefa deve possuir autorização para a função do administrador ou
a função do operador para enviar tarefas. Quando você envia uma tarefa, é possível
especificar um nome e senha de usuário para autenticação e autorização
no destino ou nos destinos. Ao enviar uma tarefa para diversos destinos, o nome do usuário e a senha ou as credenciais para o
requisitante devem ser aplicáveis a todos os destinos da tarefa.
Sobre Esta Tarefa
É possível usar o console administrativo do gerenciador de tarefa ou do gerenciador de implementação para enviar uma tarefa que se aplica ao arquivo de propriedades e configura um servidor de aplicativos. No console, escolha a tarefa Configurar Propriedades, especifique o arquivo de propriedades a ser aplicado, especifique as opções da tarefa, planeje a tarefa, revise o resumo e envie a tarefa.
A tarefa faz as seguintes alterações em uma configuração do servidor de aplicativos.
- Configure o atributo correspondente a cada propriedade especificada no arquivo de propriedades
para o novo valor.
- Se um atributo correspondente à propriedade especificada não existir
na configuração, cria um atributo na configuração.
- Se um objeto de configuração especificado no arquivo de propriedades não
existir na configuração, cria um objeto de configuração.
Opcionalmente, você pode especificar se o gerenciador de tarefa usa variáveis que
são configuradas em um arquivo de mapeamento variável ao aplicar o arquivo de propriedades.
Especifique o local de um arquivo de mapeamento variável para incluir com o arquivo de propriedades.
As etapas descrevem como usar o console do gerenciador de tarefa ou o gerenciador de implementação para enviar a tarefa. Em vez de usar um console, é possível enviar a tarefa executando o comando configProperties no grupo de comandos AdministrativeJobs para configurar as propriedades para o destino do servidor de aplicativos. Consulte o tópico de tipos de Tarefa
Administrativa.
A tarefa configurar propriedades usa o comando applyConfigProperties no grupo de comandos PropertiesBasedConfiguration do objeto AdminTask para configurar as propriedades para o destino.
Procedimento
- Clique em na árvore de navegação do console administrativo.
- Escolha uma tarefa para aplicar um arquivo de propriedades a um ou mais destinos de servidores de aplicativos.
- Selecione o tipo de tarefa Configurar Propriedades da
lista.
- Descreva opcionalmente a tarefa.
- Clique em Avançar.
- Para o destino da tarefa, escolha os destinos do servidor de aplicativos que você deseja configurar aplicando um arquivo de propriedades.
- Selecione Nomes de destinos.
- Especifique os nomes de destino ao qual você anteriormente distribuiu o arquivo de propriedades e clique em Incluir, ou clique em Localizar e especifique os destinos do servidor de aplicativos como destinos escolhidos na página Localizar destinos.
- Clique em Avançar.
- Se a autenticação do usuário for necessária, especifique um nome de usuário, uma senha ou quaisquer outros valores de autenticação, conforme necessário.
- Clique em Avançar.
- Especifique os parâmetros para a tarefa Configurar Propriedades.
- Especifique o local do arquivo de propriedades que você deseja aplicar.
O local do arquivo de propriedades é o valor de destino que você especificou para a tarefa
Distribuir Arquivo.
- Se o arquivo de propriedades usar um arquivo de mapeamento variável, especifique o
calo do arquivo de mapeamento variável.
Use o valor de destino especificado para a
tarefa Distribuir Arquivo.
- 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 diversos endereços de e-mail, separe-os por vírgulas. Os endereços de e-mail
são salvos em suas preferências do 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 hora na qual a tarefa não estará mais disponível para ser executada nos destinos. É 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 clique em Concluir para enviar a tarefa.
Resultados
O gerenciador de tarefa executa as seguintes operações:
- Disponibiliza a tarefa Configurar propriedades aos destinos.
- Relata o status da tarefa em cada destino.
O que Fazer Depois
Na página Status da Tarefa, clique no ID da tarefa e visualize o
status da 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 o status da tarefa for Bem-sucedida, verifique um destino para assegurar que o arquivo de propriedades foi aplicado.