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

Esta artigo descreve as duas maneiras que a Ferramenta de Configuração de Plug-ins de Servidor da Web pode configurar um servidor da web e criar o arquivo plugin-cfg.xml, que é 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

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 dois cenários: configuração de plug-in remoto e configuração de plug-in local. 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 perfil for acidentalmente excluído ou, caso contrário, estiver ausente, o cenário será considerado uma instalação remota. Crie um perfil antes de executar o script.
O servidor de aplicativos independente com a definição de servidor da Web?
Se o perfil tiver uma definição de servidor da Web existente, a instalação será considerada uma configuração de plug-in remoto. Você não pode ter mais de uma definição de servidor da Web em um servidor de aplicativos independente.

Cenário A. Configuração de plug-in independente local

Neste cenário, a Ferramenta de Configuração de Plug-ins do Servidor da Web cria uma definição de servidor da Web com o perfil do servidor de aplicativos diretamente, sem o uso de um script.

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 gera novamente o arquivo plugin-cfg.xml no diretório profile_root/config/cells/ cell_name/nodes/ web_server_name_node/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.

Após configurar o servidor de aplicativos para o servidor da Web local, você pode iniciar o servidor de aplicativos e o servidor da Web imediatamente.
Tabela 1. Configuração que se Qualifica para o Cenário do Servidor de Aplicativos Remoto.                                        
Tipo de Perfil 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 Yes Não

Um perfil de servidor de aplicativos que possui uma definição de servidor da Web deve ser processado como uma configuração de plug-in remoto. Um servidor de aplicativos pode ter apenas uma definição de servidor da Web.

Consulte Cenário B 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 o 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 a fim de 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 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 é 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 2. Configurações que se Qualificam para o Cenário do Servidor de Aplicativos Remoto.                                        
Tipo de Perfil 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 Por script N/A
Nenhum perfil Por script N/A
Perfil do servidor de aplicativos independente com uma definição de servidor da Web existente Por script Yes

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. Crie a definição de servidor da Web no servidor de aplicativos.
    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
    O script configureweb_server_name pode utilizar três parâmetros: profile_name, Admin_Console_Username e Admin_Console_Password.
    • profile_name indica o nome do perfil usado para criar a definição do servidor da Web.
    • Admin_Console_Username indica o nome do console administrativo. O perfil com o console administrativo implementado deve ter a segurança do console administrativo ativada. Esse parâmetro não poderá ser utilizado se profile_name estiver em branco.
    • Admin_Console_Password indica a senha correspondente ao nome do usuário. Esse parâmetro não pode ser usado se profile_name e Admin_Console_Username estiverem em branco.
    Nota: O valor webserverNodeName no script é uma concatenação do apelido escolhido para o servidor da Web e o sufixo -node. Ele é automaticamente criado durante a configuração do plug-in e não pode ser alterado. Por exemplo, se você nomeou o servidor da Web myserver durante a configuraçã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.

  2. 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.
  3. Inicie o servidor da Web com o procedimento adequado para seu servidor da Web. Abra o console administrativo e salve a configuração alterada.
  4. 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.
  5. Verifique se os endereços da Web exibem a página Snoop Servlet - Informações de Solicitação/Cliente.

Para resumir, existem dois 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 objetos do servidor de aplicativos que sejam relevantes a um servidor da Web e controlar as opções de configuração de plug-in binário. O arquivo identifica objetos como aplicativos e hosts virtuais para atender aos aplicativos.

Se o servidor da Web não puder acessar o arquivo na máquina do servidor de aplicativos, você deverá copiar o arquivo para o 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 B neste artigo.

No cenário local, o servidor da Web pode acessar o arquivo plugin-cfg.xml, pois o servidor da Web está na mesma máquina do arquivo.

Todas as configurações do Cenário A 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 3. 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ó do servidor da Web
A Perfil do servidor de aplicativos   X
B 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 com uma definição de servidor da Web existente X  
Legenda:
plugins_root
plugins_root/config/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-base-dist&topic=cins_webplugins
Nome do arquivo: cins_webplugins.html