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: 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
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]](../images/dist.gif)
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.
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.
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.
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.
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 e, em seguida, desmarque a opção .
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
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]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
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.
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.
- 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.
- 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.
- O repositório master é atualizado e salvo.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
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]](../images/dist.gif)
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
- 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: 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:
- Selecione .
- 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: 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
- Clique em OK.
Propagar a configuração do plug-in. Para propagar a configuração de plug-in no console administrativo, clique em web_server_name. 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: 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.
- 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.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Ajuste seu servidor da Web. Consulte a página sobre ajuste de servidores da Web para obter informações adicionais.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
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
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.
- Copie o arquivo keystore no diretório do keystore
em seu servidor da web.
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.