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

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]Após instalar um servidor da Web suportado, você deve instalar um módulo de plug-in binário para o servidor da Web instalando os Plug-ins do Servidor da Web. O módulo de plug-in permite que o servidor da Web se comunique com o servidor de aplicativos. A Ferramenta de Configuração de Plug-ins do Servidor da Web permite que você configure o servidor da Web e crie uma definição de servidor da Web na configuração do servidor de aplicativos. A Ferramenta de Configuração de Plug-ins do Servidor da Web usa os seguintes arquivos para configurar um plug-in para o servidor da Web que você seleciona:
  • O arquivo de configuração do servidor da Web na máquina do servidor da Web, como o arquivo httpd.conf para IBM® HTTP Server.
  • O arquivo de plug-in do servidor da Web binário na máquina do servidor da Web.
  • O arquivo de configuração de plug-in, plugin-cfg.xml, na máquina servidor de aplicativos que você propaga (copia) em uma máquina servidor da Web.
  • O arquivo de configuração de plug-in padrão (temporário), plugin-cfg.xml, na máquina do servidor da Web.
  • O script configureweb_server_name , copiado da máquina do servidor da web para a máquina do servidor de aplicativos.
[IBM i]O processo de configuração de plug-ins usa os seguintes arquivos para configurar um plug-in para o servidor da Web que você seleciona:
  • O arquivo de configuração do servidor da Web na máquina do servidor da Web, como o arquivo httpd.conf para IBM HTTP Server.
  • O arquivo de plug-in do servidor da Web binário na máquina do servidor da Web.
  • O arquivo de configuração de plug-in, plugin-cfg.xml, na máquina servidor de aplicativos que você propaga (copia) em uma máquina servidor da Web.
  • O script de configuração para configurar a definição de servidor da Web para seu servidor de aplicativos em um cenário de HTTP remoto.

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.

[AIX Solaris HP-UX Linux Windows]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.

A configuração consiste na inclusão de diretivas que identificam os locais de arquivos de dois arquivos:
  • Arquivo de Plug-in do Servidor da Web Binário
  • Arquivo de Configuração de Plug-in, plugin-cfg.xml

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.

[IBM i]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.

[AIX Solaris HP-UX Linux Windows]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.

[AIX Solaris HP-UX Linux Windows]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.

[IBM i]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.

[AIX Solaris HP-UX Linux Windows]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.

[IBM i]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]

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]

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.

Ao utilizar o IBM HTTP Server, configure também o IBM HTTP Administration Server. O IBM HTTP Administration Server trabalha com o console administrativo para gerenciar definições do servidor da Web. Além disso, use o console administrativo para atualizar sua definição de servidor da Web com as opções de gerenciamento do servidor da Web remoto. Clique em Servidores > Tipo de Servidor > Servidores da Web > web_server_name para ver as opções de configuração. Por exemplo, clique em Gerenciamento de Servidor da Web Remoto para alterar propriedades como:
  • Nome do Host
  • Porta Administrativa
  • ID do Usuário
  • Senha
Importante: Sempre abra uma nova janela de comandos antes de executar esse script. Fazendo isso, você pode evitar um possível problema.

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.

Reconfigure a variável de duas maneiras:
  • Feche a janela de comandos na qual a variável é definida e abra uma nova.
  • Vá para o diretório profile_root/bin do perfil padrão e especifique a origem do script setupCmdLine.sh:
    [Windows]
    1. Abra uma janela de prompt de comandos.
    2. Vá para o diretório app_server_root\bin.
    3. Emita o comando setupCmdLine.bat.
    [AIX][HP-UX][Linux][Solaris]
    1. Abra uma janela shell de comandos.
    2. Altere os diretórios para o diretório app_server_root/bin.
    3. Emita o comando . ./setupCmdLine.sh. Observe o espaço entre os pontos. O formato especial para este comando especifica a origem do comando para tornar a configuração ativa para todos os processos iniciados a partir do shell de comandos.

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.

Não é possível utilizar o console administrativo de um servidor de aplicativos independente para incluir ou excluir uma definição de servidor da Web. No entanto, é possível fazer ambas as tarefas utilizando a interface de script administrativa:
  • Inclua uma definição de servidor da Web através do recurso wsadmin, usando o script configureweb_server_name. O script usa um script Java™ Command Language (Jacl), denominado configureWebserverDefintion.jacl, para criar e configurar a definição de servidor da Web.
  • Exclua uma definição de servidor da Web usando comandos wsadmin. O servidor da Web é denominado webserver1 no exemplo a seguir:
     set webserverName webserver1
     set webserverNodeSuffix _node
     set webserverNodeName   $webserverName$webserverNodeSuffix
     $AdminConfig remove [$AdminConfig getid /Node:$webserverNodeName/Server:$webserverName]
     $AdminConfig remove [$AdminConfig getid /Node:$webserverNodeName]
     $AdminConfig save

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]

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.

A IBM i GUI Administrativa tem plug-ins que permitem que o console administrativo gerencie os IBM HTTP Servers. Use o console administrativo para atualizar sua definição de servidor da Web com as opções de gerenciamento do servidor da Web remoto. Clique em Servidores > Tipo de Servidor > Servidores da Web > web_server_name para ver as opções de configuração. Por exemplo, clique em Gerenciamento de Servidor da Web Remoto para alterar propriedades como:
  • Nome do Host
  • Porta Administrativa
  • ID do Usuário
  • Senha

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.

Não é possível utilizar o console administrativo de um servidor de aplicativos independente para incluir ou excluir uma definição de servidor da Web. No entanto, é possível fazer ambas as tarefas utilizando a interface de script administrativa:
  • Inclua uma definição de servidor da Web através do recurso wsadmin, usando o script configureweb_server_name. O script usa um script Java Command Language (Jacl), denominado configureWebserverDefintion.jacl, para criar e configurar a definição de servidor da Web.
  • Exclua uma definição de servidor da Web usando comandos wsadmin. O servidor da Web é denominado webserver1 no exemplo a seguir:
    set webserverName webserver1
    set webserverNodeSuffix _node
    set webserverNodeName 
    $webserverName$webserverNodeSuffix
    $AdminConfig remove 
      [$AdminConfig getid 
        /Node:$webserverNodeName/Server:$webserverName]
    $AdminConfig remove 
      [$AdminConfig getid /Node:$webserverNodeName]
    $AdminConfig save

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.

[AIX Solaris HP-UX Linux Windows]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.

[AIX Solaris HP-UX Linux Windows]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]A seguir, os valores de parâmetros fixos no arquivo de configuração de plug-in temporário.
  • Nome do Host Virtual

    Valor padrão: default_host

    Esse host virtual é configurado para servir ao DefaultApplication. Esse valor é, provavelmente, o mesmo valor do arquivo real plugin-cfg.xml. No entanto, suponha que você crie outro host virtual para atender aplicativos e instalar o DefaultApplication nele. Se criar, o arquivo real plugin-cfg.xml é gerado novamente. O servidor da Web não pode acessar DefaultApplication. (O aplicativo inclui os snoop servlets e hitcount.)

    Para acessar aplicativos no novo host virtual, propague o arquivo real plugin-cfg.xml. A propagação é a cópia do arquivo atualizado da máquina do servidor de aplicativos para a máquina do servidor da Web.

  • Porta de Transporte HTTP

    Valor padrão: 9080

    O valor 9080 é o valor padrão para a porta de transporte HTTP para o host virtual default_host. Esse valor é provavelmente o mesmo valor do arquivo atualizado. No entanto, esse valor é alterado para todos os perfis na máquina servidor de aplicativos. O valor da porta de transporte HTTP deve ser exclusivo para todos os servidores de aplicativos.

    Para comunicar-se por uma porta diferente, propague o arquivo real plugin-cfg.xml.

  • Porta de Atendimento do Servidor da Web

    Valor padrão: 80

    O valor 80 é o valor padrão para a porta que controla a comunicação com o servidor da Web. No entanto, cada perfil do servidor de aplicativos deve ter um valor de porta exclusivo para se comunicar com um servidor da Web. O valor de porta real pode ser 81 ou outro número.

    Para comunicar-se por uma porta diferente, propague o arquivo real plugin-cfg.xml.

  • Porta de Transporte HTTPS

    Valor padrão: 9443

    O valor 9443 é o valor padrão para a porta de transporte HTTPS (seguro) para o host virtual default_host. Esse valor é provavelmente o mesmo valor do arquivo atualizado. No entanto, esse valor é alterado para todos os perfis na máquina servidor de aplicativos. O valor da porta de transporte HTTPS deve ser exclusivo para todos os servidores de aplicativos.

    Para comunicar-se por uma porta segura diferente, propague o arquivo real plugin-cfg.xml.

  • Aplicativos Instalados no Servidor de Aplicativos server1

    Todos os servlets e aplicativos padrão estão incluídos no arquivo padrão.

    Para servir a um aplicativo que você desenvolveu com o servidor da Web, propague o arquivo real plugin-cfg.xml.


Ícone que indica o tipo de tópico Tópico de Conceito



Í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_webserver
Nome do arquivo: cins_webserver.html