![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
Configuração do Servidor da Web
A configuração de plug-in envolve a configuração do servidor da Web para usar o módulo de plug-in binário que o WebSphere Application Server fornece. Ela também inclui a atualização do arquivo de configuração XML do plug-in para refletir a configuração atual do servidor de aplicativos. O módulo binário usa o arquivo XML para auxiliar no roteamento de solicitações do Web client.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
Consulte as seguintes descrições de cada arquivo.
Arquivo de Configuração do Servidor da Web
O arquivo de configuração do servidor da Web é instalado como parte do servidor da Web.
A Ferramenta de Configuração de Plug-ins do Servidor da Web deve reconfigurar o arquivo de configuração para um servidor da Web suportado.
Arquivo de Plug-in do Servidor da Web Binário
Um exemplo de um módulo de plug-in binário é o arquivo mod_was_ap22_http.dll para IBM HTTP Server na plataforma Windows.
Outro exemplo de módulo de plug-in binário é o programa de serviço QSVTAP20 na plataforma IBM i.
O arquivo do plug-in binário não é alterado. No entanto, o arquivo de configuração para o plug-in binário é um arquivo XML. O servidor de aplicativos altera o arquivo de configuração quando determinadas alterações ocorrem na configuração do WebSphere Application Server.
O módulo binário lê o arquivo XML para ajustar as configurações e rotear pedidos para o servidor de aplicativos.
Arquivo de Configuração de Plug-in, plugin-cfg.xml
O arquivo de configuração do plug-in é um arquivo XML com configurações que podem ser ajustadas no console administrativo. O arquivo lista todos os aplicativos instalados na definição de servidor da Web. O módulo binário lê o arquivo XML para ajustar as configurações e rotear pedidos para o servidor de aplicativos.
O
servidor de aplicativos independente regenera 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.
O
gerenciador de implementação regenerará o arquivo plugin-cfg.xml
no diretório profile_root/config/cells/cell_name/nodes/node_name/servers/web_server_name
sempre que ocorrer uma alteração na configuração do servidor de aplicativos que afete
os aplicativos implementados no nó gerenciado.
Quando você
fizer alterações na configuração do servidor de aplicativos que afetem os aplicativos implementados,
regenere o arquivo XML de configuração de plug-in.
Após a regeneração, propague (copie) o arquivo para a máquina do servidor da Web. O plug-in binário, então, tem acesso à cópia mais atual desse arquivo de configuração.
O serviço de configuração do plug-in de servidor da Web regenera automaticamente o arquivo
plugin-cfg.xml após determinados eventos que alteram a configuração. O serviço de configuração
propaga automaticamente o arquivo plugin-cfg.xml a uma máquina do
IBM HTTP
Server quando o arquivo é gerado novamente. Você deve copiar manualmente o arquivo em outros servidores da Web.
Em sistemas IBM i, o plug-in não é gerado automaticamente. É necessário regenerar e
propagar o arquivo manualmente.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
O Arquivo de Configuração do Plug-in Padrão, plugin-cfg.xml
A Ferramenta de Configuração de Plug-ins do Servidor da Web cria o arquivo plugin-cfg.xml temporário no diretório plugins_root/config/web_server_name. A ferramenta cria o arquivo para cada cenário de instalação remota.
O arquivo padrão é um marcador que você deve substituir pelo arquivo plugin-cfg.xml da definição de servidor da Web no servidor de aplicativos. O arquivo padrão é uma réplica do arquivo que o servidor de aplicativos cria para um servidor de aplicativos independente padrão.
Execute o script configureweb_server_name a partir do diretório app_server_root/bin da máquina do servidor de aplicativos para uma instalação remota ou diretamente do diretório plugins_root/bin para uma instalação local. O script cria a definição de servidor da Web nos arquivos de configuração do perfil padrão. Para configurar um perfil diferente do padrão, edite o script configureweb_server_name. Use o parâmetro -profileName para identificar um perfil diferente do perfil padrão.
Depois que a definição de servidor da Web é criada, o serviço de configuração de plug-in de servidor da Web no servidor de aplicativos cria o primeiro arquivo plugin-cfg.xml na definição de servidor da Web na máquina do servidor de aplicativos. Se você instalar um aplicativo, criar um host virtual ou fizer algo que altere a configuração, deverá propagar o arquivo plugin-cfg.xml atualizado a partir da máquina do servidor de aplicativos para a máquina do servidor da Web para substituir o arquivo padrão.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Configurar o Script web_server_name para a Definição de Servidor da Web
A Ferramenta de Configuração de Plug-ins do Servidor da Web cria o script configureweb_server_name na máquina do servidor da Web do diretório plugins_root/bin. Se uma máquina em um cenário remoto estiver em execução em um sistema operacional como o AIX ou o Linux e outra máquina estiver sendo executada no Windows, utilize o script criado no diretório plugins_root/bin/crossPlatformScripts. O script é criado apenas para cenários de instalação remotos.
Copie o script da máquina do servidor da Web para o diretório app_server_root/bin em uma máquina do servidor de aplicativos remoto. Não é necessário copiar o script em uma instalação local. Execute o script para criar uma definição de servidor da Web na configuração do servidor de aplicativos.
O problema é um conflito potencial entre uma variável de ambiente de shell, a variável de ambiente WAS_USER_SCRIPT, e o perfil padrão real. O script sempre funciona em relação ao perfil padrão. Se a variável de ambiente WAS_USER_SCRIPT estiver configurada, no entanto, um conflito surgirá, pois o script tentará trabalhar no perfil identificado pela variável.
A variável é facilmente definida acidentalmente. Emita qualquer comando no diretório profile_root/bin de qualquer perfil e a variável será definida com esse perfil.
Se você possuir mais de um perfil no sistema, é possível que o perfil padrão e o perfil identificado pela variável sejam perfis diferentes. Em caso afirmativo, ocorrerá um conflito e o script poderá não criar a definição de servidor da Web no perfil correto ou ainda poderá não criá-la em lugar algum.
Se uma definição de servidor da Web existir para um servidor de aplicativos independente, executar o script não incluirá uma nova definição de servidor da Web. Cada servidor de aplicativos independente poderá ter apenas uma definição de servidor da Web.
Um nó gerenciado, por outro lado, pode ter várias definições de servidor da Web. O script cria uma nova definição de servidor da Web, a menos que o nome do servidor da Web seja igual.
![[IBM i]](../images/iseries.gif)
Script de Configuração para a Definição de Servidor da Web
A configuração do servidor da Web com o script configureOs400WebserverDefinition ou usando a GUI administrativa do IBM i cria o script configureweb_server_name na máquina do servidor da Web no diretório plugins_root/bin. O script é criado apenas para cenários de instalação remotos.
Copie o script da máquina do servidor da Web para o diretório app_server_root/bin na partição IBM i. Execute o script para criar uma definição de servidor da Web na configuração do servidor de aplicativos.
Se uma definição de servidor da Web existir para um servidor de aplicativos independente, executar o script não incluirá uma nova definição de servidor da Web. Cada servidor de aplicativos independente pode possuir apenas uma definição de servidor da Web.
Alternativamente, você pode utilizar os scripts configureOs400WebServerDefinition e removeOs400WebServerDefinition para executar essas tarefas.
Um nó gerenciado, por outro lado, pode ter várias definições de servidor da Web. O script cria uma nova definição de servidor da Web, a menos que o nome do servidor da Web seja igual.
Substituindo o Arquivo de Configuração de Plug-in Padrão pelo Arquivo da Definição de Servidor da Web (Propagação)
O arquivo padrão utiliza valores de parâmetros fixos que podem não corresponder com os valores de parâmetros no arquivo real no servidor de aplicativos. O arquivo padrão é apenas um marcador.
O arquivo não pode refletir alterações que ocorrem na configuração do servidor de aplicativos. O arquivo também não pode refletir valores não padrão que possam estar em vigor no servidor de aplicativos.
O servidor de aplicativos
deve possuir os valores a seguir no arquivo real plugin-cfg.xml. Se for o caso, o arquivo padrão pode configurar com êxito o módulo de plug-in binário. Depois, o módulo de plug-in pode se comunicar com êxito com o servidor da Web e o servidor de aplicativos.
Suponha que o servidor de aplicativos não
possui os valores a seguir no arquivo real plugin-cfg.xml. Nesse caso, o arquivo padrão configura o módulo de plug-in binário incorretamente.
O módulo de plug-in sempre pode se comunicar com o servidor da Web. Mas, com um
arquivo de configuração impróprio, o módulo de plug-in não pode se comunicar com êxito
com o servidor de aplicativos.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)