O WebSphere Application Server fornece um plug-in de servidor da web que pode ser configurado para se comunicar com uma marca específica de servidor da web. Aprenda a instalar o servidor da web e seu plug-in de servidor da web para WebSphere Application Server em uma máquina e a configurar o servidor de aplicativos no perfil padrão em outra máquina para se comunicar com o servidor da web.
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.
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
Esse
procedimento configura o perfil do servidor de aplicativos que é o perfil
padrão na máquina. Existe um relacionamento de um para um entre um servidor da Web e o servidor de aplicativos.
Este artigo descreve como criar a seguinte topologia:
Atenção: Se você estiver planejando incluir o nó de servidor de aplicativos em uma célula do gerenciador de implementação, mas ainda não tiver feito isso, inicie o gerenciador de implementação federar e federe o nó antes de configurar o plug-in.
Não é possível incluir um servidor de aplicativos com uma definição de servidor da Web na célula do gerenciador de implementação.
A topologia a seguir é considerada uma topologia remota, pois o servidor da Web está em uma máquina separada. O diagrama mostra uma topologia remota típica para um ambiente distribuído:
Este artigo descreve a instalação de um servidor da Web em uma máquina e do servidor de
aplicativos em uma máquina separada. Nesta situação, a Ferramenta de Configuração de Plug-ins do Servidor da Web em uma máquina não pode criar a definição do servidor da Web na configuração do servidor de aplicativos na outra máquina.
Neste caso, a Ferramenta de Configuração de Plug-ins do Servidor da Web cria um script na máquina do servidor da Web que é possível copiar para a máquina do servidor de aplicativos. Execute
o script na máquina do servidor de aplicativos para criar a definição da configuração do servidor da Web dentro da configuração do servidor de aplicativos.
Execute o seguinte procedimento para instalar o plug-in e configurar o servidor da Web e o servidor de aplicativos.
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 um servidor de aplicativos independente na Máquina A.
- Opcional: Crie um novo alias do host para o host virtual padrão.
Se tiver configurado o servidor da Web para usar uma porta que não seja a porta 80, você deverá incluir um novo alias de host para essa porta do host padrão. Por exemplo, ao executar como não raiz, o IBM HTTP Server
é configurado com um valor de porta padrão 8080.
- 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.
Esse painel não será exibido se você selecionar o cenário remoto na etapa anterior.
- 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.
Resultados
Este procedimento resulta na instalação dos Plug-ins do Servidor da Web para WebSphere Application
Server em uma máquina do servidor da Web. A Ferramenta de Configuração de Plug-ins do Servidor da Web também configura o servidor da Web para suportar um servidor de aplicativos em uma máquina separada.
A instalação dos Plug-ins do Servidor da Web resulta na criação do diretório
Plugins e de vários subdiretórios. Os seguintes diretórios estão entre os criados
em um sistema Linux,
por exemplo:
- plugins_root/bin/32 bits ou plugins_root/bin/64bits contém
os plug-ins binários para todos os servidores da web suportados
- plugins_root/logs contém
arquivos de registro
- plugins_root/properties contém
informações sobre a versão
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 Configuração do Servidor da Web para obter informações sobre os arquivos envolvidos na configuração de um servidor da web.
Consulte Configuração de Plug-ins para obter informações sobre o local do arquivo de configuração do plug-in.
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.