É possível instalar e configurar diversos servidores da web e servidores de aplicativos em máquinas separadas.
Antes de Iniciar
Quando
existem vários perfis, você pode selecionar o perfil que a
Ferramenta de Configuração de Plug-ins do Servidor da Web configurar. Consulte Configuração de Plug-ins para obter uma descrição do fluxo de lógica que determina como selecionar o perfil a ser configurado.
Quando
existem vários perfis, você pode selecionar o perfil que a
Ferramenta de Configuração de Plug-ins do Servidor da Web configurar. Consulte Configuração de Plug-ins para obter uma descrição do fluxo de lógica que determina como selecionar o perfil a ser configurado.
Se a família de produtos WebSphere Application Server suportar uma marca específica de servidor da Web, como IBM® HTTP Server ou Microsoft Internet Information Services
(IIS), seu produto WebSphere Application
Server fornece um plug-in de binário para o servidor da Web que você deve instalar.
Se a família de produtos WebSphere Application Server não fornecer um plug-in de binário para uma marca específica de servidor da Web, o servidor da Web não será suportado. O objetivo do plug-in de binário é fornecer o protocolo de comunicação entre o servidor da Web e o servidor de aplicativos.
Suponha que você crie um novo perfil e também queira usar um servidor da Web. Você deve instalar um novo servidor da Web para o novo perfil,
instalar os Plug-ins do servidor da Web, e usar a Ferramenta de
Configuração de Plug-ins do servidor da Web para configurar ambos, o
servidor da Web e o servidor de aplicativos.
Se o servidor da Web ainda não estiver instalado, será possível instalar o Web Server Plug-ins para uso futuro.
Sobre Esta Tarefa
A instalação do Web Server Plug-ins instala o módulo de plug-in. A Ferramenta de Configuração de Plug-ins do Servidor da Web configura
o servidor da Web para se comunicar com o servidor de aplicativos e
cria uma definição de configuração do servidor da Web no servidor de
aplicativos, se possível.
Este artigo descreve como criar a seguinte topologia:

Execute o procedimento a seguir para instalar o plug-ins e configurar tanto o servidor da Web quanto o servidor de aplicativos.
Esta topologia permite que cada perfil tenha aplicativos, configurações, dados e arquivos de log exclusivos, ao mesmo tempo compartilhando o mesmo conjunto de arquivos de sistema. A criação de vários perfis cria vários ambientes do servidor de aplicativos que você pode, então, dedicar a diferentes finalidades.
Por exemplo, cada servidor de aplicativos em
um Web site pode entregar um aplicativo diferente. Em outro exemplo,
cada servidor de aplicativos pode ser um ambiente de teste separado que você designa
a um programador ou a uma equipe de desenvolvimento.
Configurações suportadas: Esta ferramenta é suportada apenas no
AIX, Linux e Windows. Como uma alternativa ao uso
do Web Server Plug-ins Configuration Tool, é possível usar a ferramenta de linha de comandos pct com
um arquivo de resposta para configurar um servidor da web. Consulte
Configurando um plug-in do servidor da web usando a ferramenta pct para obter informações adicionais.
sptcfg
Procedimento
- Instale o Installation Manager nas Máquinas A e B.
- Use o Installation Manager para instalar o WebSphere
Application Server Network Deployment na Máquina A.
Crie o primeiro perfil de servidor de aplicativos utilizando o Ferramenta de Gerenciamento de Perfil na Máquina A.
Utilize o comando managedProfile para criar o primeiro perfil de servidor de aplicativos na Máquina A.
- Use o Installation Manager para instalar o seguinte na Máquina B.
- Plug-ins de Servidor da Web para o WebSphere Application
Server
- Websphere Customization Toolbox
- Use o Installation Manager para instalar o IBM HTTP Server na Máquina B ou instale outro servidor da Web suportado na Máquina B.
Abra a WebSphere Customization Toolbox e ative a Ferramenta de Configuração de Plug-ins do Servidor da Web na máquina que tem o servidor da Web.
- Selecione um local de tempo de execução do plug-in de servidor da Web.
Se o local de um servidor da Web anteriormente instalado que você deseja usar não estiver na lista, execute as seguintes ações para incluir o local em seu conjunto de trabalhos:
- Clique em Incluir.
- Insira um nome para o local do plug-in do servidor da Web.
- Execute uma das seguintes ações:
- Insira o local.
- Clique em Procurar, localize o local e clique em OK.
- Clique em Criar.
- Selecione o tipo de servidor da Web que você está configurando e clique em Avançar.
- Selecione a arquitetura do servidor da Web de destino instalado (64 ou 32 bits) e clique em Avançar, caso seja solicitado.
- Clique em Procurar para selecionar um ou mais arquivos de configuração para o seu servidor da Web, verifique se a porta do servidor da Web está correta e clique em Avançar quando tiver concluído.
Selecione o arquivo e não apenas o diretório do arquivo. Alguns servidores da Web têm dois arquivos de configuração e requerem que você navegue para cada arquivo.
A lista a seguir mostra os arquivos de configuração para os servidores da Web suportados:
- Apache HTTP Server
- apache_root/config/httpd.conf
- Servidor do Domino Web
- names.nsf e Notes.jar
O
assistente solicita o arquivo notes.jar. O nome real é Notes.jar.
A Ferramenta de Configuração de Plug-ins do Servidor da Web verifica se os arquivos existem mas não valida nenhum arquivo.
- IBM HTTP
Server
IHS_root/conf/httpd.conf
IHS_profile_root/conf/httpd.conf
- Microsoft Internet
Information Services (IIS)
- A Ferramenta de Configuração de Plug-ins do Servidor da Web pode determinar os arquivos corretos a serem editados.
- Sun Java™ System Web Server
(anteriormente Sun ONE Web Server e iPlanet Web Server) Versão 6.0 e
mais recente
- obj.conf e magnus.conf
- Se você estiver configurando um plug-in do servidor da Web IBM HTTP, execute as seguintes ações.
- Opcionalmente, defina a configuração do servidor de administração para administrar o servidor da Web.
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.
- Selecione Configurar Servidor de Administração do IBM HTTP
Server.
- Especifique um número de porta na qual o servidor de administração do IBM HTTP
se comunicará.
- Opcionalmente, selecione Criar um ID de Usuário para Autenticação do IBM Server Administration Server e insira um ID do usuário e senha para autenticação do servidor administrativo do IBM HTTP Server a partir do console administrativo.
- Clique em Avançar.
![[AIX]](../images/aixlogo.gif)
Especifique o ID do usuário e grupo do sistema para ter permissão de gravação para o IBM HTTP
Server, o servidor administrativo IBM HTTP Server e os arquivos de configuração de plug-in do servidor da Web.Selecione Criar um Novo ID de Usuário e Grupo do Sistema Exclusivos Usando as Credenciais, se necessário.
Restrição: A configuração poderá falhar caso você especifique um novo ID do usuário ou nome do grupo que exceda o limite da plataforma, que geralmente é de 8 caracteres e, às vezes, é configurável.
Opcionalmente, configure o servidor de administração do IBM HTTP Server para executar como um serviço do Windows.- Selecione Executar o Servidor de Administração do
IBM HTTP Server como um Serviço do
Windows.
- Execute uma das seguintes ações:
- Selecione Efetuar Logon como uma Conta do Sistema Local.
- Selecione Efetuar Logon como uma Conta de Usuário Especificada e insira o ID do usuário e senha dessa conta.
O ID do usuário requer os seguintes direitos de usuário avançado:
- Agir como parte do sistema operacional
- Efetuar logon como serviço
- Escolha se seu tipo de inicialização será automático ou manual.
- Clique em Avançar.
- Especifique um nome exclusivo para a definição do servidor da Web e clique em Avançar.
- Selecione o cenário de configuração.
- Escolha o cenário remoto.
- Identifique o nome de host ou endereço IP da Máquina A, que é a máquina do servidor de aplicativos.
- Clique em Avançar.
- Selecione o perfil para configurar com o plug-in do servidor da Web atual e clique em Avançar.
- Examine o painel de resumo e clique em Configurar para iniciar a configuração.
O painel notifica que você tem etapas manuais a executar
para concluir a instalação e a configuração.
A Ferramenta de Configuração de Plug-ins do Servidor da Web cria o script configureweb_server_name no diretório plugins_root/bin/ da Máquina B (a máquina com o servidor da Web).
A Ferramenta de Configuração de Plug-ins do Servidor da Web também cria o arquivo plugin-cfg.xml
no diretório plugins_root/config/web_server_name.
O servidor da Web lê o arquivo plugin-cfg.xml para determinar os aplicativos que o servidor de aplicativos na Máquina A pode usar para o servidor da Web na Máquina B. Sempre que a configuração é alterada, o servidor de aplicativos regenera o arquivo. Quando ocorrer a regeneração, propague ou copie o arquivo plugin-cfg.xml real da máquina do servidor de aplicativos para a máquina do servidor da Web. É possível propagar automaticamente o arquivo para o produto IBM HTTP Server.
- Verifique o êxito da instalação no painel de resumo e clique em Concluir.
Se ocorrer um problema e a instalação
for mal-sucedida, examine os registros no diretório plugins_root/logs. Corrija todos os problemas e reconfigure.
- Copie o script configureweb_server_name da Máquina B (a máquina com o servidor da Web) para o diretório app_server_root /bin na Máquina A (a máquina do servidor de aplicativos).
web_server_name é o apelido do servidor da Web especificado. web_server_name não é um nome de fornecedor, como IIS ou Apache.
Em um sistema operacional, como AIX ou Linux, o arquivo é configureweb_server_name.sh.
Em um sistema Windows, o arquivo é configureweb_server_name.bat.
Por exemplo, em um sistema Linux com um IBM HTTP Server denominado web_server_1 no local padrão, copie plugins_root/bin/configureweb_server_1.sh da Máquina B (a máquina com o servidor da Web) para o diretório app_server_root/bin na Máquina A (a máquina do servidor de aplicativos).
Por exemplo, em um sistema IBM i com um IBM HTTP Server denominado web_server_1 no local padrão, copie plugins_root/bin/configureweb_server_1 da Máquina B (a máquina com o servidor da Web) para o diretório app_server_root/bin na Máquina A (a máquina do servidor de aplicativos).
- Compense diferenças de codificação de arquivos para evitar
falhas de script.
O conteúdo do script configureweb_server_name.bat ou do script
configureweb_server_name.sh poderá ser corrompido se a codificação do arquivo padrão das duas máquinas for diferente.
Esse cenário é
possível quando uma máquina estiver configurada para um código do idioma DBCS (Conjunto de Caracteres de Byte Duplo) e a outra máquina não.
O conteúdo do script configureweb_server_name poderá ser corrompido se a codificação do arquivo padrão das duas máquinas for diferente.
Esse cenário é
possível quando uma máquina estiver configurada para um código do idioma DBCS (Conjunto de Caracteres de Byte Duplo) e a outra máquina não.
Determine a codificação de arquivo e
utilize um dos procedimentos a seguir para contornar a falha. Para determinar
a codificação de arquivo padrão, execute o comando apropriado.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
- Execute o comando locale charmap
em um sistema como AIX ou Linux.
- Execute o comando CHCP em uma máquina Windows.
Utilize o resultado do comando em cada máquina como o valor da
variável web_server_machine_encoding e da variável application_server_machine_encoding
em um dos procedimentos a seguir.Procedimentos para compensar diferenças de
codificação
Omita os caracteres de continuação (\) se digitar o comando em uma linha.
Se o mapeamento de conversão não for suportado pelo comando iconv no seu sistema, copie o conteúdo do script de configuração do servidor da Web para uma área de transferência e cole-o na máquina em que o servidor de aplicativos está sendo executado.
Nota: Se você copiar um arquivo .sh
para o sistema operacional baseado em UNIX após a configuração remota em um sistema operacional Windows,
deve-se executar chmod 755.
- Inicie o servidor de aplicativos na Máquina A.
- Abra uma janela de comando e altere para o diretório de perfil em que o servidor da Web deve ser atribuído. Execute o script copiado para
a Máquina A (a máquina do servidor de aplicativos). Serão necessários os seguintes parâmetros:
- Nome do Perfil
- (Opcional) ID do usuário admin
- (Opcional) Senha do usuário admin
Por exemplo, é possível inserir o seguinte:configurewebserver1.sh AppSrv01 my_user_ID my_Password
O servidor da Web será configurado via wsadmin.O conteúdo do script configurewebserver1.sh
será semelhante a este:
wsadmin.bat -profileName AppSrv01 -user my_user_ID -password my_Password
-f "%WAS_HOME%\bin\configureWebserverDefinition.jacl" webserver1 IHS..
- A partir do console administrativo do gerenciador de implementação, clique em Administração do Sistema > Salvar Alterações no Repositório Principal
> Sincronizar Alterações com Nós > Salvar.
Apenas para o Domino Web Server: Configure a variável
de ambiente WAS_PLUGIN_CONFIG_FILE. Em plataformas como AIX ou Linux, o fornecimento de um script para o shell pai permite que processos-filhos herdem as variáveis exportadas.
Em sistemas Windows, execute o
script conforme você executaria qualquer outro comando. A fornecimento é automático
em sistemas Windows.
- Abra uma janela de comando.
- Vá para o diretório raiz da instalação de plug-ins.
- Emita o comando adequado para o script plugins_root/bin/setupPluginCfg.sh:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
. plugins_root/bin/setupPluginCfg.sh (Observe o espaço entre o ponto e o diretório raiz da instalação.)
source plugins_root/bin/setupPluginCfg.sh
O script também está no diretório lotus_root/notesdata
em sistemas operacionais, tais como, AIX ou Linux.
Emita o comando apropriado
para o script antes de iniciar o Servidor do Domino Web.
- Gere novamente o arquivo plugin-cfg.xml na Máquina A (a máquina do servidor de aplicativos) usando o console administrativo. Clique em Servidores > Tipos de Servidor > Servidores da Web.
Selecione o servidor da Web e clique em Gerar Plug-in.
Durante a instalação dos plug-ins, o arquivo plugin-cfg.xml padrão é instalado na Máquina B (a máquina do servidor da Web) no diretório plugins_root/config/web_server_name.
O serviço de configuração do plug-in de servidor da Web regenera o arquivo plugin-cfg.xml automaticamente. Para usar o arquivo plugin-cfg.xml atual a partir
do servidor de aplicativos, propague o arquivo plugin-cfg.xml conforme descrito
na próxima etapa.
Esta etapa mostra como gerar novamente o arquivo plugin-cfg.xml. Os produtos WebSphere Application Server
são configurados para gerarem novamente o arquivo automaticamente
sempre que ocorrer um evento significante. Tais eventos incluem, por exemplo,
a instalação de aplicativos no servidor de aplicativos e no servidor da Web,. A criação
de um novo host virtual é outro desses eventos.
- Propague o arquivo plugin-cfg.xml do servidor de aplicativos para o servidor da Web usando o console administrativo. Clique em Servidores > Servidor da Web. Selecione o servidor da Web e clique em Propagar Plug-in.
Servidores da Web, exceto IBM HTTP Server, requerem propagação manual.
O serviço de configuração do plug-in de servidor da web
propaga o arquivo plugin-cfg.xml automaticamente
apenas para o IBM HTTP Server. Para todos os outros servidores da Web, propague o arquivo de configuração de plug-in copiando manualmente o arquivo plugin-cfg.xml do diretório profile_root/config/cells/cell_name/nodes/node_name/servers/web_server_name na Máquina A (a máquina do servidor de aplicativos) para o diretório plugins_root/config/web_server_name na Máquina B (a máquina com o servidor da Web).
- Inicie o Snoop servlet para verificar a habilidade do servidor da Web para recuperar um aplicativo a partir do servidor de aplicativos.
Teste seu ambiente iniciando seu servidor de aplicativos, seu servidor da Web e utilizando o Snoop servlet com um endereço IP.
- Inicie o servidor de aplicativos. Em um ambiente do Network Deployment, o Snoop servlet está disponível na célula apenas se você tiver incluído o DefaultApplication ao incluir o servidor de aplicativos na célula. A opção -includeapps para o comando addNode migra
o DefaultApplication para a célula. Se o aplicativo não estiver presente, ignore
essa etapa.
- Inicie o IBM HTTP Server ou o servidor da Web que estiver usando.
Use a página 2001 ou use o comando STRTCPSVR
SERVER(*HTTP) HTTPSVR(instance_name ) para iniciar
o IBM HTTP Server.
Use uma janela de comando para alterar o diretório para a imagem instalada do IBM HTTP Server ou a imagem instalada de seu servidor da Web. Emita o comando adequado para iniciar o servidor da Web, como os comandos a seguir para o IBM HTTP Server:
Para iniciar o
IBM HTTP Server a partir da linha de comandos:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Acesse
os comandos
apache e
apachectl no
diretório
IBMHttpServer/bin.
- Aponte o navegador para http://localhost:9080/snoop para testar o
transporte HTTP interno fornecido pelo servidor de aplicativos.
Aponte seu navegador para http://Host_name_of_Web_server_machine/snoop para testar o plug-in de servidor da Web.
A porta do Transporte HTTP é 9080,
por padrão, e deve ser exclusiva para cada perfil. A porta está associada a um host virtual denominado default_host, que está configurado para hospedar o DefaultApplication instalado. O Snoop servlet faz parte do DefaultApplication. Altere a porta para corresponder à porta real do
Transporte HTTP.
- Verifique se o Snoop está em execução.
O endereço da Web
deve exibir a página Snoop Servlet - Informações do Pedido/Cliente.
- Apenas IBM HTTP Server remoto:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Verifique se a função de propagação automática
pode funcionar em um IBM HTTP Server remoto usando as seguintes etapas.
Esse procedimento não é necessário para servidores da Web locais.
- Crie user=adminUser, password=adminPassword no arquivo IHS_root /conf/admin.passwd.
Por exemplo: c:\ws\ihs85\bin\htpasswd -cb c:\ws\ihs85\conf\admin.passwd
adminUser adminPassword
- Use o console administrativo do gerenciador de implementação ou o servidor de aplicativos para inserir as informações de ID de Usuário e senha criadas para o usuário administrativo do IBM HTTP Server. Acesse Servidores > Servidor da Web > web_server_definition > Administração do Servidor da Web Remoto. Defina os seguintes valores: admin Port=8008, User Id=adminUser, Password=adminPassword.
- Defina as permissões de leitura/gravação corretas para o arquivo httpd.conf
e o arquivo plugin-cfg.xml. Consulte o arquivo IHS_root /logs/admin_ERROR.
LOG para obter mais informações.
A propagação automática do arquivo de configuração de plug-in requer
que o servidor administrativo IBM HTTP
esteja em funcionamento. Se você estiver gerenciando um IBM HTTP Server usando o console administrativo do WebSphere Application Server,
o seguinte erro poderá ser exibido:
"Não foi possível se conectar ao erro do servidor de administração IHS"
Execute
o seguinte procedimento para corrigir o erro:
- Verifique se o servidor de administração do IBM HTTP Server está em execução.
- Verifique se o nome de host do servidor da Web e a porta que estão definidos no console administrativo do WebSphere Application Server correspondem ao nome de host de administração e à porta do IBM HTTP Server.
- Verifique se o firewall não está impedindo o acesso
ao servidor de administração do IBM HTTP Server
a partir do console administrativo do WebSphere Application
Server.
- Verifique se o ID do usuário e senha especificados no console administrativo do WebSphere Application Server
em gerenciamento remoto foram criados no arquivo admin.passwd
usando o comando htpasswd.
- Se estiver tentando conectar-se de forma segura, verifique se exportou o
certificado pessoal keydb do servidor do administração do IBM HTTP Server
para o banco de dados de chaves do WebSphere Application Server
como um certificado de assinante. Esse banco de dados de chaves é especificado pela diretiva com.ibm.ssl.trustStore no arquivo sas.client.props
no perfil no qual o console administrativo está em execução. Essa consideração
é principalmente para certificados auto-assinados.
- Se ainda tiver problemas, verifique o arquivo IBM HTTP Server
admin_ERROR. LOG e os logs do WebSphere Application
Server (arquivo trace.log) para determinar a causa do problema.
Crie o segundo perfil do servidor de aplicativos usando a Ferramenta de Gerenciamento de Perfil na Máquina A. Torne o perfil padrão durante sua criação, marcando a caixa de seleção no painel adequado.
Utilize o comando managedProfile para criar o segundo perfil de servidor de aplicativos. Durante o processo de criação, designe esse perfil como o padrão.O script que o Installation Manager cria só funciona no perfil padrão. Portanto, esse script pode criar apenas uma definição de servidor da Web no perfil que é padrão no momento da execução do script.
- Instale um segundo IBM HTTP
Server ou outro servidor da Web suportado na Máquina B.
- Na Máquina B, configure o segundo servidor da Web usando a Ferramenta de Configuração de Plug-ins do Servidor da Web.
Os dois servidores da Web compartilham uma única instalação dos binários de plug-in, mas devem ser configurados manualmente.
- O Installation Manager cria um script denominado configureweb_server_name para o segundo servidor da Web. O script está localizado no diretório plugins_root/bin da Máquina B. Copie esse script para o diretório app_server_root/bin na Máquina A.
- Inicie o segundo servidor de aplicativos.
- Execute o script configureweb_server_name na Máquina A para criar uma definição de servidor da Web no console administrativo. Em seguida, é possível utilizar o console administrativo para gerenciar o servidor Web.
- Propague o arquivo plugin-cfg.xml do segundo servidor de aplicativos para o servidor da Web usando o console administrativo. Clique em Servidores > Servidor da Web > Propagar Plug-in. Servidores da Web, exceto IBM HTTP Server, requerem propagação manual.
- Execute o Snoop servlet no segundo servidor da Web para verificar se ele está funcionando.
Resultados
Esse procedimento resulta na instalação de dois ou mais servidores de aplicativos em uma máquina e na instalação dedicada de servidores da Web em outra máquina. Esse procedimento instala os Plug-ins do Servidor da Web para os dois servidores da Web e configura os dois servidores da Web e os dois servidores de aplicativos.
O que Fazer Depois
Veja Selecionando um diagrama e um roteiro de
topologia de servidor da web para obter uma visão geral do procedimento de instalação.
Consulte Editando Arquivos de Configuração do Servidor da Web para obter informações sobre como a Ferramenta de Configuração de Plug-ins do Servidor da Web configura os servidores da Web suportados.
Consulte Configuração do Servidor da Web para obter informações sobre os arquivos envolvidos na configuração de um servidor da web.
Para servidores da Web
IHS, você pode parar e iniciar o servidor da Web e propagar o arquivo
plugin-cfg.xml a partir da máquina do WebSphere Application Server para a máquina do servidor da Web. Para todos os outros servidores da Web, não é possível iniciar/parar ou propagar o arquivo
plugin-cfg.xml no console administrativo.
Será necessário propagar o arquivo
plugin-cfg.xml manualmente. As três etapas a seguir descrevem como realizar a propagação manual:
- Após a conclusão da configuração com servidores da Web diferentes de IHS 6.x, verifique se o arquivo plugin-cfg.xml existe em <WAS_HOME>/profiles/<PROFILE_HOME>/config/cells/<CELL_NAME>/nodes/<SERVER_NAME>/servers/<WEBSERVER_DEFINITION>
- Transfira o plugin-cfg.xml acima para substituir <PLUGIN_HOME>/config/<WEBSERVER_DEFINITION>/plugin-xfg.xml
- Reinicie o servidor da Web e o perfil correspondente.