Implementando um Plug-in de Servidor da Web

Esse tópico descreve como implementar um plug-in de servidor da Web. O produto funciona com um servidor da Web para rotear solicitações para conteúdo dinâmico, como servlets, a partir de aplicativos da Web. Os servidores da Web são necessários para direcionar o tráfego dos navegadores para os aplicativos executados em um servidor de aplicativos. O plug-in de servidor da Web utiliza o arquivo de configuração XML para determinar se um pedido é para um servidor de aplicativos.

Antes de Iniciar

  • Consulte as informações sobre a escolha de um front end para sua topologia do WebSphere Application Server. Esse tópico ajuda a determinar a necessidade de configurar um plug-in de servidor da Web, um servidor proxy ou um servidor proxy seguro para fornecer afinidade de sessão, suporte de failover e balanceamento de carga de trabalho para sua topologia do WebSphere Application Server. Instale o servidor da Web, se ele ainda não estiver instalado.
    Evitar Problemas Evitar Problemas: O servidor da Web fornecido com o IBM® i, já é instalado com como produto 5761-DG1 para IBM i V6R1 ou 5770-DG1 para IBM i V7R1. O servidor da Web do IBM i web server é citado como o IBM HTTP Server para IBM i. Esse servidor da web é diferente do IBM HTTP Server fornecido com o WebSphere Application Server, que não é executado no IBM i.gotcha

    [AIX Solaris HP-UX Linux Windows]Se desejar usar o Servidor IBM HTTP fornecido com o produto, consulte as informações sobre instalação do Servidor IBM HTTP. Caso contrário, consulte as informações de instalação que são fornecidas com o seu servidor da Web.

  • [AIX Solaris HP-UX Linux Windows][z/OS]Certifique-se de que o arquivo de plug-in adequado tenha sido instalado em seu servidor da Web e o script configureweb_server_name tenha sido executado para criar e configurar a definição do servidor da Web para esse servidor da Web.

    [AIX Solaris HP-UX Linux Windows]Se estiver usando um servidor da Web de plataforma distribuída, use a Ferramenta de Configuração do Plug-in de Servidor da Web para instalar o arquivo de plug-in adequado para seu servidor da Web. Em seguida, execute o script configureweb_server_name criado pela ferramenta para criar e configurar a definição do servidor da Web no Repositório de Configuração do WebSphere.

    [z/OS]Se estiver usando o IBM HTTP Server para z/OS, desenvolvido por Apache, fornecido com o produto, consulte as informações sobre instalação e configuração do plug-in para o IBM HTTP Server for WebSphere Application Server em z/OS.

    [z/OS]Se estiver usando o IBM HTTP Server Versão 5.3, fornecido com o sistema operacional base do z/OS, consulte as informações sobre instalação e configuração do plug-in de servidor da Web para o IBM HTTP Server para z/OSV5.3.

    [z/OS]Se estiver usando um servidor da Web de plataforma distribuída com uma versão do produto que está em execução nos sistemas operacionais z/OS, use uma conexão FTP para enviar o plug-in para o servidor da Web e use o Assistente de Instalação de Plug-ins para instalar o arquivo de plug-in adequado para seu servidor da Web.

Se estiver fazendo diversas mudanças simultâneas, como a instalação de vários aplicativos, talvez deseje que o serviço de configuração fique desativado até a execução da última mudança. O serviço de configuração de plug-in de servidor da Web está ativado por padrão. Para desativar esse serviço, no console administrativo, clique em Servidores > Tipos de servidor > Servidores de aplicativos do WebSphere > server_name > Serviços de administração > Serviço de configuração de plug-in de servidor da web e, em seguida, desmarque a opção Ativar processamento automatizado de configuração do servidor da web.

Evitar Problemas Evitar Problemas: Se a instalação usar um firewall, certifique-se de configurar o plug-in de servidor da Web para usar uma porta que esteja aberta. Consulte o administrador de segurança para obter informações sobre como obter uma porta aberta. gotcha

Sobre Esta Tarefa

[IBM i]O arquivo de plug-in apropriado é instalado. Além disso, um perfil http foi criado (/QIBM/UserData/WebSphere/Plugins/V85/webserver/profiles/http). O perfil http pode ser usado para facilitar a criação de definições de servidor da Web. Consulte o tópico sobre a seleção de um diagrama de topologia e um roteiro do servidor da Web para obter instruções sobre como configurar o IBM HTTP Server para IBM i para se comunicar com um servidor de aplicativos.

[AIX Solaris HP-UX Linux Windows][z/OS]As seguintes etapas são executadas durante o processo de instalação do plug-in. Consulte o Roteiro de Instalação de Plug-in para obter informações adicionais.
  1. [AIX Solaris HP-UX Linux Windows]Um nó é criado.

    Um nó não gerenciado é criado quando o servidor da Web está em um computador diferente do servidor de aplicativos. Um nó não-gerenciado é um nó que não possui um agente do nó sendo executado nele. Utilizando nós não gerenciados, o produto pode representar servidores que não são servidores de aplicativos dentro de sua topologia de configuração. Essa representação permite que sejam mantidas informações de conexão entre esses servidores e os servidores de aplicativos. Consulte o tópico sobre inclusão, gerenciamento e remoção de nós para obter informações adicionais.

  2. Uma definição de servidor da Web é criada.

    Também é possível usar o console administrativo ou o script ConfigurewebServerDefinition.jacl para criar uma definição de servidor da web.

  3. Um aplicativo ou módulos são mapeados para um servidor da Web. Se um aplicativo que você deseja utilizar com esse servidor da Web já estiver instalado, o aplicativo será automaticamente mapeado para o servidor da Web. Se o aplicativo não está instalado, selecione este servidor da web durante a etapa "Mapear Módulos para Servidores" do processo de instalação do aplicativo.
  4. O repositório master é atualizado e salvo.

[AIX Solaris HP-UX Linux Windows][z/OS]Ao configurar um plug-in, o arquivo de configuração para esse plug-in é automaticamente criado. É possível alterar ou sintonizar as configurações padrão das propriedades neste arquivo de configuração. Se alguma das configurações for alterada, será necessário gerar novamente o arquivo para que as mudanças entrem em vigor.

[AIX Solaris HP-UX Linux Windows][z/OS]Gerar ou gerar novamente o arquivo de configuração pode demorar para ser concluído. Após concluir, todos os objetos na célula administrativa utilizam suas configurações mais recentes, as quais o servidor da Web pode acessar. Se o servidor de aplicativos estiver na mesma estação de trabalho física que o servidor da Web, a nova geração normalmente levará de 30 a 60 segundos para ser concluída. A nova geração levará mais tempo se o servidor de aplicativos e o servidor da Web estiverem em diferentes estações de trabalho.

O procedimento a seguir descreve as etapas para atualização do arquivo de configuração do plug-in de servidor da Web, incluindo a configuração do SSL e o ajuste do servidor da Web.

Procedimento

  1. Utilize o console administrativo para alterar as configurações no arquivo de configuração do plug-in.
    Ao configurar o plug-in de servidor da Web, será necessário decidir se a configuração será gerada automaticamente em resposta a uma mudança na configuração. O arquivo de configuração de plug-in será automaticamente gerado quando o serviço de configuração do plug-in do servidor da Web estiver ativado e qualquer uma das condições a seguir ocorrer:
    • Quando o servidor da Web for criado ou salvo.
    • Quando um aplicativo for instalado.
    • Quando um aplicativo for desinstalado.
    • Quando a definição do host virtual for atualizada.
    Evitar Problemas Evitar Problemas: Quando o arquivo de configuração de plug-in é gerado pela primeira vez, ele não inclui admin_host na lista de hosts virtuais. As informações sobre a permissão de servidores da Web acessarem o console administrativo descrevem como incluí-los na lista.gotcha

    É possível utilizar o console administrativo, ou emitir o comando GenPluginCfg para gerar novamente o arquivo plugin-cfg.xml.

    Conclua as etapas a seguir para gerar novamente o arquivo plugin-cfg.xml usando o console administrativo:

    1. Selecione Servidores > Tipos de servidores > Servidores da web > web_server_name > propriedade de plug-in.
    2. Selecione Gerar automaticamente o arquivo de configuração de plug-in ou clique em um ou mais dos tópicos a seguir para configurar manualmente o arquivo plugin-cfg.xml:
      Evitar Problemas Evitar Problemas: Não atualize o arquivo plugin-cfg.xml manualmente. Todas as atualizações manuais feitas em um servidor da Web são substituídas sempre que o arquivo plugin-cfg.xml desse servidor da Web é gerado novamente.gotcha
    3. Clique em OK.
    4. [IBM i]Propagar a configuração do plug-in. Para propagar a configuração de plug-in no console administrativo, clique em Servidores > Tipos de servidor > Servidores da webweb_server_namePropagar plug-in.

      Outro método para propagar a configuração de plug-in é executar o comando GenPluginCfg. Para obter informações adicionais, consulte a documentação do comando GenPluginCfg.

      Você não precisará propagar a configuração de plug-in se o servidor da Web estiver na mesma máquina que a versão independente associada do produto. Se a propagação da configuração de plug-in falhar devido a uma causa desconhecida, você deverá copiar manualmente o arquivo plugin-cfg.xml no local para a instalação do servidor da web remoto.

      Evitar Problemas Evitar Problemas: Se você utilizar a função de FTP para executar a cópia, e o recarregamento da configuração falhar, verifique as autoridades de arquivo no arquivo plugin-cfg.xml e certifique-se de que os usuários QTMHHTTP, QNOTES e QEJBSVR tenham autoridade RWX. Se o atributo não estiver correto, o servidor da Web não poderá acessar a nova versão do arquivo, causando falha no recarregamento da configuração. Para verificar as autoridades, execute o seguinte comando IBM i:
      wrklnk 'plug_in_folder_location/plugin-cfg.xml' 
      Em seguida, selecione a opção 9 para visualizar as autoridades designadas para os usuários (QTMHHTTP, QNOTES e QEJBSVR).gotcha
      Se as autoridades estiverem incorretas, emita o seguinte comando do IBM i para alterar as autoridades do arquivo para as configurações adequadas:
      CHGAUT USER(QEJBSVR QTMHHTTP QNOTES) OBJ('plug_in_folder_location/plugin-cfg.xml') DTAAUT(*RWX)
      plug_in_folder_location é o local especificado ao transferir o arquivo plugin-cfg.xml.
    5. Talvez seja necessário parar o servidor de aplicativos e, em seguida, iniciar o servidor de aplicativos para o servidor da Web localizado no arquivo plugin-cfg.xml.
  2. [AIX Solaris HP-UX Linux Windows][IBM i]Ajuste seu servidor da Web. Consulte a página sobre ajuste de servidores da Web para obter informações adicionais.
  3. [AIX Solaris HP-UX Linux Windows][z/OS]Propagar a configuração do plug-in. O arquivo de configuração do plug-in de servidor da Web, plugin-cfg.xml, será automaticamente propagado para o servidor da Web se o serviço de configuração do plug-in de servidor da Web estiver ativado e uma das seguintes condições for verdadeira:
    • O servidor da Web for um servidor da Web local, o que significa que o servidor da Web estará localizado na mesma estação de trabalho que um servidor de aplicativos.
    • O servidor da Web é um IBM HTTP Server Versão 7 remoto que possui um servidor de administração IBM HTTP Server executando.

    Se nenhuma das condições for verdadeira, será necessário copiar manualmente o arquivo plugin-cfg.xml para o local da instalação do servidor da Web remoto. Copie o arquivo plugin-cfg.xml em <app_server_root>/profiles/<profilename>/config/cells/../../nodes/../servers/<webservername> para o local do host do servidor da web, que é <PluginInstallRoot>/config/<webservername>/.

    Importante: Se você usar a função FTP para copiar o arquivo e o recarregamento da configuração falhar, verifique as permissões do arquivo no arquivo plugin-cfg.xml e certifique-se de que elas estejam configuradas como rw-r--r--. Se as permissões de arquivo não estiverem corretas, o servidor da Web não poderá acessar a nova versão do arquivo, o que fará com que o recarregamento da configuração falhe.
    Se as permissões de arquivo estiverem incorretas, emita o seguinte comando para alterar as permissões de arquivo para as configurações apropriadas:
    chmod 644 plugin-cfg.xml

    [AIX]A função FTP do AIX não preserva os atributos de arquivo. Portanto, se for necessário copiar manualmente plugin-cfg.xml de um sistema operacional AIX, você talvez deseje usar a função RCP do AIX, em vez da função FTP para copiar o arquivo.

    O local da instalação do servidor da Web remoto é o local que você especificou quando criou o nó para esse servidor da Web.

  4. Copie o arquivo keystore no diretório do keystore em seu servidor da web.
    Evitar Problemas Evitar Problemas: Esta etapa é necessária para que o servidor da web funcione corretamente.gotcha

    Para obter instruções detalhadas sobre como copiar o arquivo keystore, leia o tópico sobre como configurar o plug-in de servidor da web para Secure Sockets Layer.

Resultados

A configuração está concluída. Para ativar a configuração, pare e reinicie o servidor da Web. Se encontrar problemas ao reiniciar o servidor da Web, verifique o arquivo http_plugin.log para obter informações sobre qual parte do arquivo plugin-cfg.xml contém erros. o arquivo de log determina o número da linha onde o erro ocorreu, juntamente com outros detalhes que podem ajudá-lo a diagnosticar o motivo pelo qual o servidor da Web não iniciou. É possível usar o console administrativo para atualizar o arquivo plugin-cfg.xml.

Se as instalações e desinstalações de aplicativos forem pouco frequentes, que, geralmente é a situação em um ambiente de produção, ou se for possível tolerar o impacto de desempenho causado pela geração e distribuição do arquivo de configuração do plug-in toda vez que uma das ações listadas anteriormente ocorrer, considere ativar o serviço de configuração.


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