[AIX Solaris HP-UX Linux Windows][IBM i]

Configuração de Plug-ins

A Ferramenta de Configuração de Plug-ins do Servidor da Web configura um servidor de aplicativos para um tipo de servidor da Web e cria uma definição de servidor da Web na configuração do servidor de aplicativos. Conheça os diferentes caminhos de processamento que podem ser usados pela Ferramenta de Configuração dos Plug-ins do Servidor da Web.

Este artigo descreve as três maneiras com que o Web Server Plug-ins Configuration Tool pode configurar um servidor da web e criar o arquivo plugin-cfg.xml, que é o arquivo de configuração de plug-in.

Configurações suportadas Configurações suportadas: Esta ferramenta é suportada apenas no AIX, Linux e Windows. Como alternativa ao uso do Web Server Plug-ins Configuration Tool, é possível utilizar a ferramenta de linha de comandos pct com um arquivo de resposta para configurar um servidor da web. Para obter mais informações, leia Configurando um plug-in de servidor da web usando a ferramenta pct.sptcfg
Antes de Iniciar: Os arquivos de configuração de plug-ins e do servidor da web são atualizados durante a configuração de plug-ins. Se você estiver usando a Ferramenta de configuração de plug-ins de servidor da web ou a ferramenta de linha de comandos pct como um usuário não raiz, verifique se possui privilégios apropriados para atualizar os arquivos de configuração dos Plug-ins de servidor da web além dos arquivos de configuração do servidor da web (como o IHS) antes de iniciar uma configuração— , principalmente se você não for o proprietário desses arquivos.
Atenção: Ao usar a Ferramenta de Configuração de Plug-ins de Servidor da Web para configurar o IBM® HTTP Server Administration Server, o Websphere Customization Toolbox deve ser executado como uma conta "local" com privilégios administrator/root.

Além disso, o arquivo de configuração httpd.conf padrão deverá permanecer no diretório <IHS_HOME>/conf e você deverá executar setupadm manualmente após a configuração de administração.

Configurações suportadas Configurações suportadas: A Ferramenta de Configuração de Plug-ins de Servidor da Web é destinada para uso com o perfil WebSphere Application Server completo; ela não é necessária ou suportada para uso na geração de um plug-in de servidor da web para o perfil Liberty. Para obter informações sobre a geração de um plug-in do servidor da web para o perfil do Liberty, leia Configurando o perfil do Liberty com um plug-in do servidor da web.sptcfg

Fluxos de Configuração para o Produto Network Deployment

A Ferramenta de Configuração de Plug-ins do Servidor da Web resolve todas as configurações do servidor da Web e do WebSphere Application Server para três cenários: um servidor de aplicativos remoto, um servidor de aplicativos local distribuído e um servidor de aplicativos local independente. A lógica implementada na determinação de qual cenário aplicar a uma configuração é mostrada no diagrama a seguir.

Fluxo de Plug-ins da Lógica de Design

Legenda:
Tipo de instalação?
O tipo de instalação é remoto ou local.

Quando o servidor da Web e o servidor de aplicativos não estão no mesmo computador, escolha o cenário remoto. Quando ambos estão no mesmo computador, escolha o cenário local.

Perfil?
Se o produto estiver instalado, mas o Ferramenta de Gerenciamento de Perfil ainda não criou um perfil, o cenário será considerado uma instalação remota.
O servidor de aplicativos independente com a definição de servidor da Web?
Se o perfil tiver um servidor de aplicativos com uma definição de servidor da Web existente, a instalação será considerada uma instalação remota.
Profile_type?
A Ferramenta de Configuração de Plug-ins do Servidor da Web pode configurar apenas um perfil por vez. Estes três caminhos mostram como o processo varia para tipos diferentes de perfis.
Federado?
Se o nó do servidor de aplicativos estiver federado, a Ferramenta de Configuração de Plug-ins do Servidor da Web configurará a definição de servidor da Web no nó gerenciado. Isso tem vantagens. Suponha que o servidor da Web e o nó gerenciado estejam em uma máquina separada. O arquivo plugin-cfg.xml é automaticamente propagado para o nó remoto durante a sincronização do nó porque a definição do servidor da Web faz parte da configuração do nó.
Perfil distribuído?
Se o gerenciador de implementação tiver um nó customizado federado (perfil customizado), a Ferramenta de Configuração de Plug-ins de Servidor da Web configurará a definição de servidor da Web no nó gerenciado. Isso tem vantagens. Suponha que o servidor da Web e o nó gerenciado estejam em uma máquina separada. O arquivo plugin-cfg.xml é automaticamente propagado para o nó remoto durante a sincronização do nó porque a definição do servidor da Web faz parte da configuração do nó.

A Ferramenta de Configuração de Plug-ins do Servidor da Web cria uma definição de servidor da Web dentro do perfil do servidor de aplicativos.

A Ferramenta de Configurações de Plug-ins do Servidor da Web configura o servidor da Web para usar o arquivo plugin-cfg.xml que está no perfil do servidor de aplicativos. O servidor de aplicativos independente regenerará o arquivo profile_root/config/cells/cell_name/nodes/web_server_name_node/servers/web_server_name/plugin-cfg.xml sempre que ocorrer uma alteração na configuração do servidor que afete os aplicativos implementados.

Após instalar o plug-in binário para o servidor da Web local, você poderá iniciar o servidor de aplicativos e o servidor da Web imediatamente após a conclusão da instalação.

Suponha que você crie uma definição de servidor da Web em um servidor de aplicativos independente e depois federe o nó. A definição de servidor da Web não é federada na célula porque a definição de servidor da Web é definida como um nó separado em um servidor de aplicativos independente. É necessário recriar a definição de servidor da Web no nó gerenciado. Consulte Cenário 2.
Tabela 1. Configuração que se Qualifica para o Cenário do Servidor de Aplicativos Local Independente.                                        
Tipo de Perfil Status da Federação Criação automática da definição de servidor da Web? O Servidor da Web Já Foi Definido na Configuração do Application Server?
Servidor de aplicativos Não federado Sim Não

Um servidor de aplicativos independente não federado que possui uma definição de servidor da Web existente deve ser processado como uma configuração de plug-in remoto.

Uma definição de servidor da Web existente em um servidor de aplicativos independente exige que a Ferramenta de Configuração de Plug-ins do Servidor da Web siga o caminho de instalação remoto. Um servidor de aplicativos independente pode ter apenas uma definição de servidor da Web.

Consulte Cenário 3 para obter uma descrição desse tipo de nó.

Um servidor de aplicativos independente federado deve ser processado como uma configuração de plug-in distribuído local. Consulte Cenário 2 para obter uma descrição desse tipo de nó.

A seguinte visão geral mostra o procedimento para verificar a configuração do servidor da Web:

  1. Inicie o servidor da Web com o procedimento adequado para seu servidor da Web.
    Por exemplo, inicie o IBM HTTP Server em uma linha de comandos:
    • [AIX][HP-UX][Linux][Solaris]./IHS_root/bin/apachectl start
    • [Windows]IHS_root\bin\apache
  2. Iniciar o servidor de aplicativos.
    Altere os diretórios e vá para o diretório para profile_root/bin e execute o comando startServer:
    • [AIX][HP-UX][Linux][Solaris]./profile_root/bin/startServer.sh server1
    • [Windows]profile_root\bin\startServer server1
    Abra o console administrativo e salve a configuração alterada.
  3. Aponte o navegador para http://localhost:9080/snoop para testar o transporte HTTP interno fornecido pelo servidor de aplicativos. Aponte o navegador para http://Host_name_of_Web_server_machine/snoop para testar o plug-in de servidor da Web.
  4. Verifique se os endereços da Web exibem a página Snoop Servlet - Informações de Solicitação/Cliente.

A Ferramenta de Configuração de Plug-ins do Servidor da Web não cria automaticamente uma definição de servidor da Web dentro de um perfil do servidor de aplicativos federado. A ferramenta cria o script configureweb_server_name no diretório plugins_root/bin.

A Ferramenta de Configurações de Plug-ins do Servidor da Web configura o servidor da Web para usar o arquivo plugin-cfg.xml que será criado no perfil do servidor de aplicativos quando você executa o script. O gerenciador de implementação regenera o arquivo plugin-cfg.xml no diretório profile_root/config/cells/cell_name/nodes/node_name/servers/web_server_name. A regeneração ocorre sempre que uma alteração ocorrer na configuração do servidor de aplicativos que afeta os aplicativos implementados no nó gerenciado.

Após instalar o plug-in binário para o servidor da Web local, você deverá executar o script antes de poder iniciar o servidor da Web. O servidor da Web já foi configurado para usar o arquivo plugin-cfg.xml na configuração do servidor de aplicativos. Esse arquivo não existirá até o script configureweb_server_name ser executado.
Tabela 2. Configurações que se Qualificam para o Cenário do Servidor de Aplicativos Local Distribuído.                                        
Tipo de Perfil Status da Federação Criação de definição do servidor da Web? O Servidor da Web Já Foi Definido na Configuração do Application Server?
Perfil do servidor de aplicativos Federado Por script N/A
Perfil Personalizado Não federado Por script N/A
Perfil Customizado Federado Por script N/A
Perfil de gerenciador de implementação com um nó gerenciado (perfil distribuído) N/A Por script N/A

A seguinte visão geral mostra o procedimento para concluir a configuração e verificação de configuração do servidor da Web:

  1. Inicie o Deployment Manager.
  2. Se você pretende incluir um nó do servidor de aplicativos em uma célula do gerenciador de implementação, mas ainda não o fez, federe o nó antes de instalar os plug-ins. Se a definição de servidor da Web existir ao federar o nó, a definição de servidor da Web será perdida durante a federação.
  3. Crie a definição de servidor da Web no servidor de aplicativos. Você tem duas opções:
    • Use o console administrativo do gerenciador de implementação para criar uma definição de servidor da Web para um nó gerenciado. Clique em Servidores > Servidores da Web > Novo e utilize o Assistente para Criar Nova Entrada de Servidor da Web para criar a definição de servidor da Web.
    • Execute o script para criar manualmente a definição de servidor da Web dentro da configuração do gerenciador de implementação. Execute o script do diretório plugins_root/bin. O script pode endereçar o gerenciador de implementação na mesma máquina.
      Abra uma janela de comandos para executar o script apropriado:
      • [AIX][HP-UX][Linux][Solaris]./configureweb_server_name.sh
      • [Windows]configureweb_server_name.bat
      Nota: O valor webserverNodeName no script é uma concatenação do apelido escolhido para o servidor da Web e o sufixo -node. É criado automaticamente durante a instalação do plug-in e não pode ser alterado. Por exemplo, se você nomeou o servidor da Web myserver durante a instalação de plug-in, o valor para a definição de servidor da Web associado criado após a execução do script será myserver-node.

      Se você tiver ativado a segurança ou alterado o tipo do conector JMX padrão, edite o script e inclua os parâmetros apropriados.

  4. Inicie o servidor da Web com o procedimento adequado para seu servidor da Web.
    Por exemplo, inicie o IBM HTTP Server em uma linha de comandos:
    • [AIX][HP-UX][Linux][Solaris]./IHS_root/bin/apachectl start
    • [Windows]IHS_root\bin\apache
  5. Iniciar o servidor de aplicativos.
    Altere os diretórios e vá para o diretório para profile_root/bin e execute o comando startServer:
    • [AIX][HP-UX][Linux][Solaris]./profile_root/bin/startServer.sh server1
    • [Windows]profile_root\bin\startServer server1
  6. Abra o console administrativo do gerenciador de implementação. Aguarde até que ocorra a sincronização do nó e salve a configuração alterada que inclui a nova definição de servidor da Web.
  7. Aponte o navegador para http://localhost:9080/snoop para testar o transporte HTTP interno fornecido pelo servidor de aplicativos. Aponte o navegador para http://Host_name_of_Web_server_machine/snoop para testar o plug-in de servidor da Web.
  8. Verifique se os endereços da Web exibem a página Snoop Servlet - Informações de Solicitação/Cliente.

A Ferramenta de Configuração de Plug-ins do Servidor da Web não cria automaticamente uma definição de servidor da Web dentro do perfil distribuído em uma máquina remota. A ferramenta cria o script configureweb_server_name.

A Ferramenta de Configuração de Plug-ins do Servidor da Web configura o servidor da Web para usar o arquivo plugin-cfg.xml que será mantido na máquina do servidor da Web no diretório plugins_root/config/web_server_name. O arquivo requer propagação periódica. A propagação está copiando o arquivo plugin-cfg.xml atual da máquina do servidor de aplicativos para substituir o arquivo plugins_root/config/web_server_name/plugin-cfg.xml.

Após instalar o plug-in binário para o servidor da Web local, você não precisa executar o script antes de poder iniciar o servidor de aplicativos e o servidor da Web. No entanto, você não tem os benefícios de uma definição de servidor da Web no nó do servidor de aplicativos até executar o script.
Tabela 3. Configurações que se Qualificam para o Cenário do Servidor de Aplicativos Remoto.                                        
Tipo de Perfil Status da Federação Criação de definição do servidor da Web? O Servidor da Web Já Foi Definido na Configuração do Application Server?
Qualquer perfil em qualquer local, se você selecionar um tipo de instalação remota na Ferramenta de Configuração de Plug-ins do Servidor da Web Não Disponível Por script N/A
Nenhum perfil N/A Por script N/A
Perfil do servidor de aplicativos independente não federado com uma definição de servidor da Web existente Não federado Por script Yes
Perfil de gerenciador de implementação sem nós gerenciados N/A Por script N/A

A visão geral a seguir mostra o procedimento para verificar o arquivo plugins_root/config/web_server_name/plugin-cfg.xml temporário.

O servidor da Web se comunica com o servidor de aplicativos remoto usando o arquivo plugin-cfg.xml temporário.

Se o servidor de aplicativos possuir uma designação de porta de Transporte HTTP diferente de 9080, o teste não obterá êxito. Continue na próxima seção para criar a definição de servidor da Web no servidor de aplicativos e para concluir seu teste de configuração.

  1. Inicie o servidor da Web com o procedimento adequado para seu servidor da Web.
    Por exemplo, inicie o IBM HTTP Server em uma linha de comandos:
    • [AIX][HP-UX][Linux][Solaris]./IHS_root/bin/apachectl start
    • [Windows]IHS_root\bin\apache
  2. Inicie o servidor de aplicativos na máquina remota.
    Altere os diretórios e vá para o diretório para profile_root/bin e execute o comando startServer:
    • [AIX][HP-UX][Linux][Solaris]./profile_root/bin/startServer.sh server1
    • [Windows]profile_root\bin\startServer server1
  3. Aponte o navegador para http://localhost:9080/snoop para testar o transporte HTTP interno fornecido pelo servidor de aplicativos. Aponte o navegador para http://Host_name_of_Web_server_machine/snoop para testar o plug-in de servidor da Web.
  4. Verifique se os endereços da Web exibem a página Snoop Servlet - Informações de Solicitação/Cliente.
A visão geral a seguir mostra o procedimento para concluir a configuração. A configuração não é concluída até a definição de servidor da Web existir na configuração do nó do servidor de aplicativos. A definição de servidor da Web é um elemento central na regeneração de um arquivo de configuração de plug-in válido, plugin-cfg.xml.
  1. Inicie o gerenciador de implementação se estiver configurando o gerenciador de implementação ou um nó gerenciado.
  2. Federe um nó do servidor de aplicativos remoto ou nó personalizado agora, se pretender federar o nó em algum momento. Se a definição de servidor da Web já existir ao federar um nó, a definição será perdida.
  3. Crie a definição de servidor da Web no servidor de aplicativos. Há duas opções para um nó gerenciado. Utilize a opção de script para um nó do gerenciador de implementação sem nós gerenciados.
    • Use o console administrativo do gerenciador de implementação para criar uma definição de servidor da Web para um nó gerenciado. Clique em Servidores > Servidores da Web > Novo e use o assistente Criar Nova Entrada do Servidor para criar a definição de servidor da web.
    • Execute o script para criar manualmente a definição de configuração do servidor da Web dentro da configuração do nó do servidor de aplicativos:
      1. Copie o script do diretório plugins_root/bin para o diretório remoto app_server_root/bin.
      2. Abra uma janela de comandos e execute o script:
        • [AIX][HP-UX][Linux][Solaris]./configureweb_server_name.sh
        • [Windows]configureweb_server_name.bat
      Nota: O valor webserverNodeName no script é uma concatenação do apelido escolhido para o servidor da Web e o sufixo -node. É criado automaticamente durante a instalação do plug-in e não pode ser alterado. Por exemplo, se você nomeou o servidor da Web myserver durante a instalação de plug-in, o valor para a definição de servidor da Web associado criado após a execução do script será myserver-node.

      Se você tiver ativado a segurança ou alterado o tipo do conector JMX (Java™ Management Extensions) padrão, edite o script e inclua os parâmetros apropriados.

  4. Abra o console administrativo do gerenciador de implementação, se o nó for federado. Aguarde até que ocorra a sincronização do nó no nó gerenciado e salve a configuração alterada que inclui a nova definição de servidor da Web. Se o nó remoto não for federado, abra o console administrativo do servidor de aplicativos e salve a configuração alterada.
  5. Copie o arquivo de configuração de plug-in atual, plugin-cfg.xml, no diretório profile_root/config/cells/cell_name/nodes/web_server_name_node/servers/web_server_name. Cole o arquivo na máquina do servidor da Web para substituir o arquivo temporário plugins_root/config/web_server_name/plugin-cfg.xml. O IBM HTTP Server suporta propagação automática. Outros servidores da Web exigem propagação manual.
  6. Inicie o servidor da Web com o procedimento adequado para seu servidor da Web.
  7. Aponte o navegador para http://localhost:9080/snoop para testar o transporte HTTP interno fornecido pelo servidor de aplicativos. Aponte o navegador para http://Host_name_of_Web_server_machine/snoop para testar o plug-in de servidor da Web.
  8. Verifique se os endereços da Web exibem a página Snoop Servlet - Informações de Solicitação/Cliente.

Para resumir, existem três cenários para Plug-ins de Servidor da Web. Cada cenário fica em um único local para o arquivo de configuração de plug-ins, plugin-cfg.xml. O servidor de aplicativos gera o arquivo de configuração de plug-ins. O propósito do arquivo é publicar o local de todos os elementos do servidor de aplicativos que sejam relevantes a um servidor da Web. Esses elementos incluem aplicativos, hosts virtuais para atender aplicativos, clusters e membros de cluster, por exemplo.

Se o servidor da Web não puder obter o arquivo na máquina do servidor de aplicativos, você deverá colocar o arquivo no servidor da Web. Esse processo é chamado de propagação. A propagação é reservada para o cenário de configuração de plug-in remoto, que é o Cenário 3 neste artigo.

Em cada cenário local, o servidor da Web pode acessar o arquivo plugin-cfg.xml, pois está na mesma máquina do arquivo. Dois cenários locais existem, devido a dois locais distintos para um arquivo local plugin-cfg.xml.

O esquema de configuração do WebSphere Application Server coloca o arquivo de configuração de plug-in em uma definição de servidor da Web que está em um nó do servidor da Web ou em um nó gerenciado. O tipo de nó é a diferença entre o Cenário 2 e o Cenário 1 neste artigo. Todas as configurações do Cenário 2 exigem que a definição de servidor da Web exista em um nó do servidor de aplicativos gerenciado. Todas as configurações do Cenário 1 têm a definição de servidor da Web em seu nó de servidor da Web.

Opções de gerenciamento limitadas não permitem criar ou excluir a definição de servidor da Web no console administrativo de um servidor de aplicativos independente. A incapacidade de um servidor de aplicativos independente em criar uma definição de servidor da Web é a base para os scripts de configuração criados pela Ferramenta de Configuração de Plug-ins do Servidor da Web. Sem os scripts, você não poderá criar facilmente uma definição de servidor da Web em um nó do servidor de aplicativos independente.

O local do arquivo plugin-cfg.xml para cada configuração descrita neste artigo é mostrada na tabela a seguir:
Tabela 4. Locais do Arquivo de Configuração de Plug-ins. Esta tabela descreve os locais de arquivo de configuração de plug-in.
Cenário Tipo de Perfil Local do Arquivo plugin-cfg.xml
plugins_root profile_root: no nó gerenciado profile_root: no nó do servidor da Web
1 Perfil do servidor de aplicativos     X
2 Perfil do servidor de aplicativos   X  
Perfil Customizado   X  
Perfil de gerenciador de implementação com um nó gerenciado (perfil distribuído)   X  
3 Qualquer perfil em qualquer local, se você selecionar um tipo de instalação remota na Ferramenta de Configuração de Plug-ins do Servidor da Web X    
Nenhum perfil X    
Perfil do servidor de aplicativos não federado (independente) com uma definição de servidor da Web existente X    
Perfil de gerenciador de implementação sem nós gerenciados X    
Legenda:
plugins_root
plugins_root
/config/web_server_name/plugin-cfg.xml
profile_root: no nó gerenciado
profile_root/config/cells/cell_name/nodes/node_name_of_AppServer/servers/web_server_name/plugin-cfg.xml
profile_root: no nó do servidor da Web
profile_root/config/cells/cell_name/nodes/web_server_name_node/servers/web_server_name/plugin-cfg.xml

Ícone que indica o tipo de tópico Tópico de Referência



Í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=cins_webplugins
Nome do arquivo: cins_webplugins.html