Aplicando os Arquivos de Propriedades para Configurar Servidores Usando o Gerenciador de Tarefa

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:

  1. 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.
  2. 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.

  3. 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.
  4. 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.

  5. 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 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
  6. 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

  1. Clique em Tarefas > Enviar na árvore de navegação do console administrativo.
  2. Escolha uma tarefa para aplicar um arquivo de propriedades a um ou mais destinos de servidores de aplicativos.
    1. Selecione o tipo de tarefa Configurar Propriedades da lista.
    2. Descreva opcionalmente a tarefa.
    3. Clique em Avançar.
  3. Para o destino da tarefa, escolha os destinos do servidor de aplicativos que você deseja configurar aplicando um arquivo de propriedades.
    1. Selecione Nomes de destinos.
    2. 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.
    3. Clique em Avançar.
    4. 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.
    5. Clique em Avançar.
  4. Especifique os parâmetros para a tarefa Configurar Propriedades.
    1. 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.

    2. 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.

    3. Clique em Avançar.
  5. Planeje a tarefa.

    As horas e datas especificadas são relacionadas ao gerenciador de tarefas.

    1. 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.

    2. 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.

    3. 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.

    4. Como opção, especifique um intervalo recorrente para a tarefa, uma data e hora de início e de encerramento para o intervalo.
    5. Clique em Avançar.
  6. 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 Especifica o ícone de visualização de atualização para status da tarefa 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.


Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tagt_jobmgr_server_propfile
Nome do arquivo: tagt_jobmgr_server_propfile.html