[z/OS]

Instalando e configurando o plug-in para IBM HTTP Server for WebSphere Application Server no z/OS

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

  1. 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.
  2. 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.
  3. 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
  4. 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
  5. 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
  6. Configure o plug-in. Use o console administrativo ou emita o comando GenPluginCfg para criar seu arquivo plugin-cfg.xml.
    Evitar Problemas 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.
    1. 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
    2. 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:
    1. Selecione Servidores > Tipos de servidores > Servidores da web > webserver > Propriedades de plug-in.
    2. 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
    3. Clique OK.
    4. 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.

  7. 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 Servidores > Tipos de servidores > WebSphere Application Servers > Propriedades de plug-in > Solicitação e resposta no console administrativo e certifique-se de que Usando fisicamente a porta especificada na solicitação esteja selecionado para Correspondência do host virtual.
  8. 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 Servidores > Tipos de servidores > WebSphere Application Servers > server_name e, em seguida, na seção Configurações do Contêiner, clique em Configurações do contêiner da web > Cadeias de transporte do contêiner da web > secure_transport_chain > Canal de entrada SSL (SSL_2) e especifique este repertório para tal cadeia de transporte.
    Evitar Problemas 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.

  9. 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.

  10. 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).

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



Í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=trun_plugin_ihsz
Nome do arquivo: trun_plugin_ihsz.html