Gerando uma configuração de plug-in mesclada para servidores Liberty usando o gerenciador de tarefa

É possível submeter a tarefa Gerar configuração de plug-in mesclada para servidores de perfil do Liberty para criar um arquivo plugin-cfg.xml único e mesclado que instrui um plug-in de servidor da web a redirecionar as solicitações a diversos servidores de aplicativos em diversos hosts. A tarefa gera primeiro arquivos plugin-cfg.xml específicos do servidor em cada host de destino. A tarefa mescla, então, os arquivos plugin-cfg.xml específicos do servidor em um arquivo plugin-cfg.xml no host do gerenciador de tarefa.

Antes de Iniciar

Inicie o gerenciador de tarefa e os servidores do Liberty nos hosts de destino.

Se precisar gerar uma configuração do plug-in de servidor da web para uma instância única de um servidor Liberty, consulte a documentação do Liberty sobre como configurar o Liberty com um plug-in do servidor da web.

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.

Ao registrar um host de destino no gerenciador de tarefa, é possível salvar as informações de segurança do sistema operacional. Ao enviar uma tarefa a um ou mais destinos para os quais as informações de segurança não foram salvas, você deve especificar um nome de usuário do sistema operacional e a senha ou as informações da chave pública-privada para o nome do usuário. As credenciais de segurança devem ser válidas para todos os destinos da tarefa.

Essa tarefa requer uma conexão Java™ Management Extensions (JMX) com os servidores do Liberty nos hosts de destino. Para configurar um servidor do Liberty para suportar as conexões JMX, inclua o recurso do conector local ou o recurso do conector HTTP/REST no arquivo server.xml. O seguinte exemplo mostra o recurso do conector local e o recurso do conector HTTP/REST no elemento do gerenciador de recurso de um arquivo server.xml:
<featureManager>
  <feature>localConnector-1.0</feature>
  <feature>restConnector-1.0</feature>
  ...
</featureManager>
Ao enviar uma tarefa, se um ou mais servidores do Liberty incluírem somente o recurso do conector HTTP/REST, você deverá especificar o nome do usuário e a senha de um administrador do servidor do Liberty. O gerenciador de tarefa usa essas credenciais ao estabelecer uma conexão JMX com os servidores. Se todos os servidores incluírem o recurso do conector local, não será necessário especificar um nome de usuário e uma senha.

Para obter mais informações sobre como definir de administradores do servidor, consulte "Mapeando a função de administrador para o Liberty."

Um servidor Liberty requer um Java Development Kit (JDK) ou um Java Runtime Environment (JRE) para executar essa tarefa. Configure o local de JDK ou JRE concluindo uma das ações a seguir:
  • Configure a propriedade JAVA_HOME para o local de JDK ou JRE no arquivo server.env. A tarefa lê a propriedade JAVA_HOME e configura-a no ambiente de destino antes de executar o comando para gerar um arquivo plugin-cfg.xml para o servidor Liberty.
  • [AIX][HP-UX][Linux][Solaris][z/OS]Configure a propriedade JAVA_HOME ao local de JDK ou JRE no arquivo .bashrc do usuário.
  • [AIX][HP-UX][Linux][Solaris][z/OS]Anexe o caminho de JDK ou JRE à variável de ambiente PATH.
  • [Windows]Configure a propriedade JAVA_HOME para o local de JDK ou JRE como uma variável de ambiente do sistema.
  • [Windows]Anexe o caminho de JDK ou JRE à variável do sistema PATH.

Sobre Esta Tarefa

É possível usar o console administrativo do gerenciador de tarefa ou o gerenciador de implementação para gerar um arquivo plugin-cfg.xml único e mesclado que instrui um plug-in de servidor da web a redirecionar as solicitações a diversos servidores do Liberty residindo em diversos hosts. No console, escolha a tarefa Gerar configuração de plug-in mesclada para servidores Liberty, especifique os servidores e as opções da tarefa, revise o resumo e envie a tarefa.

As etapas descrevem como executar a tarefa Gerar configuração de plug-in mesclada para servidores de perfil Liberty usando o console do gerenciador de tarefa ou o console do gerenciador de implementação. Em vez de usar um console, é possível executar o script da tarefa generateMergedPluginConfigForLibertyProfileServers no grupo de comandos AdministrativeJobs. Consulte o tópico de tipos de Tarefa Administrativa.

Procedimento

  1. Clique em Tarefas > Enviar na árvore de navegação do console administrativo.
  2. Escolha uma tarefa para gerar um arquivo de configuração de plug-in de servidor da web para diversos servidores do Liberty.
    1. Selecione o tipo de tarefa Gerar configuração de plug-in mesclado para servidores de perfis Liberty na lista.
    2. Como opção, especifique uma descrição da tarefa.
    3. Clique em Avançar.
  3. Escolha os destinos das tarefas.
    1. 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.

    2. 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.
    3. Se você não escolheu salvar as informações sobre autenticação de segurança ao registrar os hosts de destino no gerenciador de tarefa, especifique um nome de usuário e uma senha ou informações da chave pública-privada do sistema operacional para acesso aos hosts de destino. As credenciais de segurança devem ser válidas para todos os destinos da tarefa.
    4. Clique em Avançar.
  4. Especifique os parâmetros para a tarefa Gerar configuração de plug-in mesclada para servidores de perfil do Liberty.
    1. Para os Servidores, especifique o nome do recurso ou o ID do recurso completo de um servidor ou um padrão que identifique um ou mais servidores.

      Se um nome do servidor direcionar a mais de um servidor de mesmo nome, o produto retorna um erro e não gera o arquivo plugin-cfg.xml.

      Por exemplo, suponha que deseja especificar o defaultServer do servidor. Você pode especificar um dos seguintes valores para identificar o recurso do servidor:

      Nome do Recurso
      defaultServer
      ID do recurso completo
      runtime/wlp/liberty_server/defaultServer
      Padrão do nome do recurso
      *Server
      Padrão do ID do recurso completo
      runtime/wlp/liberty_server/*

      Para ver os nomes de servidores existentes do Liberty nos destinos, clique em Localizar na página Especificar parâmetros da tarefa. Na página Localizar recursos do destino, clique em Localizar para localizar um identificador do servidor do Liberty que exista em todos os hosts de destino. Selecione o ID do recurso do servidor para o qual gerar uma configuração de plug-in de servidor da web.

    2. Se um ou mais dos servidores incluírem somente o recurso do conector HTTP/REST (restConnector), para Nome de usuário, especifique o nome de usuário de um administrador do servidor do Liberty. O gerenciador de tarefa usa esse valor ao estabelecer uma conexão JMX com os servidores.
    3. Se um ou mais dos servidores incluírem somente o recurso do conector HTTP/REST (restConnector), para Senha, especifique a senha do administrador do servidor do Liberty. O gerenciador de tarefa usa esse valor ao estabelecer uma conexão JMX com os servidores.
    4. 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 múltiplos endereços de e-mail, separe-os com vírgulas.

    2. Selecione quando a tarefa está disponível para envio.
    3. Selecione a expiração da 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

Os arquivos plugin-cfg.xml específicos do servidor são gerados em cada host de destino. O gerenciador de tarefa mescla, então, os arquivos em um arquivo plugin-cfg.xml único e mesclado no host do gerenciador de tarefa.

O que Fazer Depois

Na página Status da tarefa, clique no ID da tarefa Gerar configuração de plug-in mesclada para servidores de perfil do Liberty 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 for bem-sucedida, o produto grava o arquivo plugin-cfg.xml fundido no diretório app_server_root/profiles/job_manager_profile/config/temp/JobManager/job_ID/_mergedPluginDir/.

Se a tarefa não for bem-sucedida, a tarefa para e o produto retorna um erro quando uma das condições a seguir existir:
  • Um servidor Liberty de destino não está em execução.
  • O conector JMX é configurado para um servidor do Liberty de destino.
  • As propriedades da tarefa não especificam as credenciais válidas do administrador do servidor para estabelecer uma conexão JMX com um servidor do Liberty de destino que inclua somente o recurso HTTP/REST (restConnector).
Visualize quaisquer mensagens de erro resultantes da execução da tarefa, corrija a condição de erro e envie a tarefa novamente.

Í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_liberty_plugin_merge
Nome do arquivo: tagt_jobmgr_liberty_plugin_merge.html