O plug-in do IBM® HTTP Server for WebSphere Application Server faz parte do componente de plug-in do
servidor da web do WebSphere Application Server. O plug-in
permite que um IBM HTTP
Server para WebSphere Application
Server se comunique com um WebSphere Application Server. Para utilizar esse plug-in, você deve ter um IBM HTTP Server para WebSphere Application Server, que
é desenvolvido com Apache e executado no z/OS.
Antes de Iniciar
Antes de instalar o plug-in, instale o software do IBM HTTP Server para WebSphere Application Server no sistema z/OS e configure uma instância do IBM HTTP Server. Consulte a documentação do produto para instalar o IBM HTTP Server para WebSphere Application Server no z/OS.
Sobre Esta Tarefa
Como parte do processo de configuração do servidor da Web, você criará um diretório de instalação para a instância do servidor da Web. Nos exemplos seguintes, um valor /etc/websrv1 é usado para o diretório de instalação do servidor da Web. O local recomendado para arquivos de configuração de plug-in é o subdiretório Plugins no diretório de instalação do servidor da Web. O diretório Plugins conterá um subdiretório conf/nome_do_Web_Server_WAS, e o arquivo de configuração do plug-in plugin-cfg.xml normalmente
residirá nesse diretório.
Este procedimento descreve como instalar e configurar o plug-in para IBM HTTP
Server para WebSphere Application Server no z/OS.
Procedimento
- Instale os plug-ins do servidor da Web. Use o IBM Installation Manager para instalar os
plug-ins de servidor da web para o WebSphere Application Server para z/OS e montar o sistema de arquivos do produto em seu sistema z/OS de destino. Por padrão, os plug-ins estão localizados no diretório /usr/lpp/WebSphere/Plugins/V9R0.
- Efetue logon no shell OMVS utilizando o ID do servidor da instância do
servidor da Web. Os scripts install_plugin e ConfigureIHSPlugin devem ser executados nesse ID de usuário para que todos os arquivos sejam de propriedade do mesmo grupo da instância do servidor da Web.
- Crie um diretório de instalação para o plug-in. O diretório do plug-in conterá informações de configuração que serão usadas pelo plug-in ao executar nessa instância do servidor da Web.
O local recomendado para esse diretório é o subdiretório Plugins no diretório de instalação da instância do servidor da Web.
Para criar a imagem de instalação do
tempo de execução, execute o comando
plugin_smp_location/bin/install_plugin.sh:
./install_plugin.sh
-pluginInstallLocation diretório_do_produto_do_código_do_plug-in
-pluginRuntimeLocation diretório_de_instalação_do_plug-in_do_servidor_da_Web
-wasInstallLocation diretório_do_produto_do_WebSphere_Application_Server
O exemplo a
seguir é uma amostra de chamada desse comando:
cd /usr/lpp/WebSphere/Plugins/V9R0/bin
./install_plugin.sh
-pluginInstallLocation /usr/lpp/WebSphere/Plugins/V9R0/
-pluginRuntimeLocation /etc/websrv1/Plugins
-wasInstallLocation /usr/lpp/WebSphere/AppServer/V9R0
- Configure a instância do IBM HTTP
Server para z/OS para usar o plug-in do servidor da Web.
Execute o comando
plugin_runtime_location/bin/ConfigureIHSPlugin.sh para configurar o IBM HTTP Server para usar o plug-in do servidor da Web:
./ConfigureIHSPlugin.sh
-plugin.home diretório_de_instalação_do_plugin_do_servidor_da_Web
-plugin.config.xml local_do_arquivo_plugin-cfg.xml
-ihs.conf.file local_do_arquivo_httpd.conf
-operating.system ZOS
-WAS.webserver.name nome_do_servidor_da_Web_definido_para_o_WebSphere_Application_Server
-WAS.host.name nome_do_host_ou_endereço_IP_do_WebSphere_Application_Server
O
exemplo a seguir é uma chamada de amostra deste comando:
cd /etc/websrv1/Plugins/bin
./ConfigureIHSPlugin.sh
-plugin.home /etc/websrv1/Plugins
-plugin.config.xml /etc/websrv1/Plugins/config/webserver1/plugin-cfg.xml
-ihs.conf.file /etc/websrv1/conf/httpd.conf
-operating.system ZOS
-WAS.webserver.name webserver1
-WAS.host.name appsrv1.mycorp.com
- Crie uma definição de servidor da web noWebSphere Application Server para o servidor da web z/OS
local ou remoto.
- Para incluir uma definição de servidor da Web durante a criação de perfil, use Profile Management Tool ou o comando zpmt.
- Para incluir um servidor da Web em um perfil existente do WebSphere Application Server use o console administrativo, o script createWebServerDefinition.jacl ou o comando wsadmin createWebServer.
Ao definir o servidor da Web no
WebSphere Application Server:
- Para o nome do servidor da Web, use o valor especificado para WAS.webserver.name
- Para o diretório de instalação de plug-in do servidor da Web, use o valor especificado para PluginRuntimeLocation
- Configure o plug-in. Use o console administrativo ou emita o comando
GenPluginCfg para criar seu arquivo plugin-cfg.xml.
Evitar Problemas: Você deve excluir o arquivo
plugin-cfg.xml
no diretório
profile_root/config/cells
antes de concluir essa tarefa. Caso contrário,
as mudanças na configuração não persistirão no arquivo
plugin-cfg.xml.
gotcha
Nota: Os dois métodos criam o arquivo de configuração de plug-in,
plugin-cfg.xml, em formato ASCII.
- Se for necessário editar esse arquivo, emita
o seguinte comando para converter o arquivo para o formato EBCDIC:
iconv -f ISO8859-1 -t IBM-1047 plugin-cfg.xml.ASCII > plugin-cfg.xml.EBCDIC
- Edite
o arquivo e, em seguida, emita o seguinte comando para convertê-lo novamente
em formato ASCII:
iconv -f IBM-1047 -t ISO8859-1 plugin-cfg.xml.EBCDIC > plugin-cfg.xml.ASCII
Para
utilizar o console administrativo:
- Selecione .
- Selecione Gerar automaticamente o arquivo de configuração de plug-in ou clique em
um ou mais dos seguintes tópicos para configurar manualmente o arquivo plugin-cfg.xml:
- Armazenamento em Cache
- Pedido e Resposta
- Roteamento de Pedidos
- Serviço
- Clique OK.
- Talvez seja necessário parar o servidor de aplicativos e depois iniciá-lo novamente para permitir que ele localize o arquivo plugin-cfg.xml.
Você pode precisar copiar manualmente o arquivo plugin-cfg.xml para o local correto no diretório de instalação de plug-in do servidor da Web.
- Certifique-se de que o host virtual esteja configurado com um alias para o
número da porta usado pelo IBM HTTP
Server para z/OS. Se você configurou manualmente
o arquivo plugin-cfg.xml, acesse a página no console administrativo e certifique-se de que Usando
fisicamente a porta especificada na solicitação esteja selecionado para
Correspondência do host virtual.
- Se você quiser ativar o plug-in do servidor da Web para usar cabeçalhos privados, defina um repertório de configuração SSL que defina um arquivo de confiança. Em seguida, no console administrativo, clique em e, em seguida, na seção Configurações do Contêiner, clique em
e especifique este
repertório para tal cadeia de transporte.
Evitar Problemas: O arquivo de confiança fornece a mesma funcionalidade para o IBM HTTP Server
para z/OS,
desenvolvido com Apache, que a propriedade customizada TrustedProxy fornecia para a Versão
5.3 do HTTP Server para z/OS em versões anteriores do produto.
gotcha
Se você tentar utilizar cabeçalhos particulares sem configurar um
repertório de configuração SSL que não inclui uma definição do arquivo confiável,
os cabeçalhos particulares serão ignorados. Se os cabeçalhos privados forem ignorados, o servidor de
aplicativos poderá não localizar o aplicativo solicitado.
Após a ativação
do uso de cabeçalhos particulares, o canal de entrada SSL da cadeia de
transporte confia em todos os cabeçalhos particulares que receber. Portanto,
você deve assegurar que todos os caminhos para o canal de entrada SSL da
cadeia de transporte sejam confiáveis.
- Se você quiser ativar o plug-in do servidor da Web para usar um conjunto de chaves System
Authorization Facility (SAF) em vez de um arquivo kdb com uma propriedade do arquivo stash, deverá criar as duas propriedades customizadas de plug-in a seguir do console administrativo.
- KeyringLocation, que é configurada para o local do diretório do conjunto de chaves SAF
- StashfileLocation, que é configurada para "" (nulo)
Consulte as informações sobre as propriedades de configuração de plug-in do servidor da Web para obter instruções sobre como criar KeyringLocation e StashfileLocation a partir do console administrativo para usar um conjunto de chaves SAF na configuração SSL. Consulte também as informações no arquivo plugin-cfg.xml.
- A configuração está concluída. Para ativar a configuração,
pare e reinicie o servidor de aplicativos e o IBM HTTP Server.
Resultados
Se o plug-in do IBM HTTP Server para z/OS exibir-se com êxito quando o IBM HTTP Server
for iniciado novamente, uma mensagem será incluída no arquivo de log do plug-in, /plugin_runtime_dir/log/webserver_name/http_plugin.log.
A mensagem que aparece em http_plugin.log é semelhante à seguinte
amostra de saída:
PLUGIN: Plugins loaded.
PLUGIN: --------------------System Information-----------------------
PLUGIN: Bld version: 9.0.0
PLUGIN: Bld date: Jun 13 2016, 09:55:09
PLUGIN: Webserver: IHS 390 Webserver: Http Plug-in Build Info: build level 9.0.0.0 (cf031208.05) release WAS90.ZNATV date 06/13/16 09:54:07
PLUGIN: Hostname = ZWASAXXX
PLUGIN: NOFILES = hard: 64000, soft: 64000
PLUGIN: MAX COREFILE SZ = hard: 4194304, soft: 4194304
PLUGIN: DATA = hard: INFINITE, soft: INFINITE
PLUGIN: --------------------------------------------------------------
O que Fazer Depois
Após o servidor de aplicativos, o IBM HTTP Server e o plug-in estão configurados
corretamente:
- O WebSphere Application Server para a plataforma z/OS pode usar esse plug-in para executar funções de plug-in regulares.
- Os pedidos podem ser roteados de um navegador, através do IBM HTTP Serve e plug-in, para um servidor de
aplicativos no qual o aplicativo solicitado é implementado. Um novo pedido é enviado para um servidor de aplicativos aleatoriamente selecionado no
qual o aplicativo é implementado. Depois que uma sessão é estabelecida, os pedidos
subsequentes são roteados para o servidor de aplicativos designado ao pedido original.
- Use cabeçalhos privados como um mecanismo para encaminhar informações de proxy do plug-in do servidor da Web para um servidor de aplicativos em um sistema z/OS. (Essas informações não são incluídas, de
outra maneira, com os pedidos de HTTP).