[z/OS]

Instalando e Configurando o Plug-in para o HTTP Server para z/OS V5.3

O plug-in do Servidor HTTP para z/OS faz parte do componente de plug-ins do servidor da web do WebSphere Application Server for z/OS. Para utilizar esse plug-in, você deve ter um HTTP Server Versão 5.3 para z/OS configurado como parte de um sistema z/OS.

Sobre Esta Tarefa

Nota: No WebSphere Application Server para z/OS Versão 7 e anterior, o plug-in de servidor da Web para IBM® HTTP Server (IHS/390) era localizado no diretório bin do produto base WebSphere Application Server para z/OS. Na Versão 8.0 e posterior, este plug-in está localizado no diretório bin do sistema de arquivos de produtos de Plug-ins de Servidor da Web e o plugin-in foi renomeado deihs390WAS70Plugin_http.so paraihs390WASPlugin_http.so.

O HTTP Server Versão 5.3 para z/OS é fornecido com o sistema operacional de base z/OS. O Servidor HTTP para z/OS não é um servidor baseado no Apache. O Servidor HTTP para z/OS não suporta arquitetura de 64 bits e não suporta IPv6.

Este procedimento descreve como instalar e configurar o plug-in do HTTP Server para z/OS.

Procedimento

  1. Certifique-se de que um HTTP Server Versão 5.3 para z/OS esteja instalado em um sistema z/OS.
  2. 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.
  3. Se o HTTP Server não tiver acesso ao sistema de arquivos de produtos de plug-ins do servidor da Web, execute as seguintes etapas para efetuar download, no formato binário, do plug-in do HTTP Server para z/OS e do arquivo plugin-cfg.xml do LPAR no qual o servidor de aplicativos está executando no LPAR no qual o HTTP Server está instalado. O diretório no qual o plug-in é transferido por download deve ser legível ao ID do MVS sob o qual o HTTP Server é executado.
    1. Utilize FTP ou outro mecanismo de transferência de arquivos para fazer download, no formato binário, do plug-in HTTP Server para z/OS de seu diretório de instalação para o sistema do HTTP Server, e para um diretório que seja legível ao ID do MVS sob o qual o HTTP Server é executado. A DLL ihs390WASPlugin_http.so está localizada no diretório /bin/ de plug-ins do servidor da Web; por exemplo:
      /usr/lpp/WebSphere/Plugins/V9R0/bin 
    2. Configure as permissões (755 +p) no arquivo ihs390WASPlugin_http.so do plug-in. Utilizando um ID do usuário autorizado do z/OS, emita os seguintes comandos a partir de um prompt de linha de comandos OMVS para ativar o bit "p" no HFS no qual o plug-in HTTP Server para z/OS está agora localizado:
      chmod 755 ihs390WASPlugin_http.so
      extattr +p ihs390WASPlugin_http.so
      Para verificar o resultado do comando extattr, emita o seguinte comando:
      ls -E  ihs390WASPlugin_http.so
      Em seguida, procure "ps" nos atributos estendidos. Exemplo:
      -rwxr-xr-x  -ps-  1 USER123  WASUSER  1482752 Aug  2 14:17 ihs390WASPlugin_http.so
  4. Execute setup.sh para criar dois arquivos, httpd.conf e httpd.enwars, para customização e configuração do servidor da Web. Crie os arquivos httpd.conf e httpd.enwars no diretório /etc. O arquivo setup.sh está localizado no diretório usr/lpp/internet/sbin.
  5. Adicione as diretrizes ServerInit, ServerTerm e Service ao arquivo de configuração httpd.conf do servidor HTTP:
    • Inclua as seguintes diretivas ServerInit e ServerTerm para indicar os pontos de entrada na inicialização do plug-in e nas rotinas de saída. Essas rotinas existem como pontos de entrada init_exit e term_exit, respectivamente, no arquivo DLL ihs390WASPlugin_http.so.
      Evitar Problemas Evitar Problemas:
      • Nesta discussão, as diretrizes ServerInit e Service são divididas por questões de impressão. No arquivo httpd.conf real, digite cada uma destas diretivas em uma única linha.
      • Na diretiva ServerInit, http_plugin_conf representa o caminho completo para o local do arquivo plugin-cfg.xml.
      • Nas diretivas ServerInit, Service e ServerTerm, http_plugin_dir representa:
        1. O caminho completo do diretório de plug-ins do servidor da web do WebSphere Application Server, tais como /usr/lpp/WebSphere/Plugins/V9R0, se o Servidor HTTP estiver no mesmo LPAR que o WebSphere Application Server ou
        2. O caminho completo que você designou como o destino da operação de FTP na etapa anterior, se o HTTP Server não estiver em um sistema com acesso ao sistema de arquivos do produto de plug-ins do servidor da Web.
      gotcha
      ServerInit /http_plugin_dir/bin/
          ihs390WASPlugin_http.so:init_exit /http_plugin_conf/
          plugin-cfg.xml
      ServerTerm /http_plugin_dir/bin/ihs390WASPlugin_http.so:term_exit
    • Inclua a seguinte diretiva de serviço em cada aplicativo que usará o plug-in de servidor da Web. Essa diretriz indica o ponto de entrada para a rotina de pedido do plug-in. A rotina de solicitação existe como o ponto de entrada service_exit no arquivo Dynamic Link Library (DLL) ihs390WASPlugin_http.so.
      Service /webapp_contextroot/*  /http_plugin_dir/
           ihs390WASPlugin_http.so:service_exit

      webapp_contextroot representa a raiz de contexto do aplicativo

    transição: O plug-in do servidor da Web para z/OS HTTP Server, Versão 5.3, usa uma interface SSL que é diferente da interface SSL usada nas versões anteriores do produto. O z/OS PTF UK35083 inclui a mudança da interface SSL para o z/OS HTTP Server, Versão 5.3, que corresponde a essa mudança de plug-in do servidor da Web. Portanto, esse PTF deve ser aplicativo ao seu sistema antes que a interface SSL do novo plug-in do servidor da Web possa funcionar corretamente.

    Também é necessário incluir a opção SSLMode multi no arquivo httpd.conf do z/OS HTTP Server, Versão 5.3. Se a opção SSLMode multi não for especificada no arquivo httpd.conf ou se você não tiver o z/OS PTF UK35083 aplicado ao seu sistema, poderá receber a mensagem de erro IMW0584W, que indica que o modo SSL especificado para o HTTP Server não é compatível com o modo SSL do plug-in de servidor da Web usado no z/OS HTTP Server, Versão 5.3. Em qualquer uma dessas situações, resultados imprevisíveis poderão ocorrer.

    Evitar Problemas Evitar Problemas:
    1. O servidor HTTP interpreta um espaço em branco na especificação de uma diretriz como um delimitador e um sinal de grade (#) como o início de um comentário que deve ser ignorado. Assim, se for necessário utilizar um espaço em branco ou um sinal de grade em uma diretriz, você deverá incluir um barra invertida (\) antes do espaço em branco ou do sinal de grade para permitir que o servidor HTTP processe a diretriz corretamente.
    2. Se um servlet definir um código de resposta HTTP por qualquer meio, como utilizando os métodos lastModified() ou setStatus(), e o cliente não receber o código de resposta esperado, adicione a seguinte diretriz ao arquivo de configuração do servidor HTTP:
      ServiceSync On
    gotcha
  6. Se o arquivo httpd.conf contiver um diretiva Pass configurada como /*, certifique-se de que as diretivas Service precedem a diretiva Pass.
  7. Crie uma definição de servidor da Web para o servidor da Web z/OS remoto ou local usando Profile Management Tool ou o comando zpmt.
  8. Configure o plug-in. Use o console administrativo ou emita o comando genplugincfg para criar seu arquivo plugin-cfg.xml.
    Nota: Os dois métodos criam o arquivo de configuração de plug-in, plugin-cfg.xml, em formato ASCII. (Anteriormente, o arquivo de configuração era gerado em formato EBCDIC).
    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 Servidor > Servidores da Web > web_server_name > Propriedades de Plug-in.
    2. Selecione Gerar Automaticamente o Arquivo de Configuração do 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 em 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.
  9. Certifique-se de que o host virtual esteja configurado com um alias para o número da porta usado pelo z/OS V5.3 HTTP Server. Se você configurou manualmente o arquivo plugin-cfg.xml no console administrativo, clique em Servidores > Tipos de Servidor > Servidores da Web > web_server_name > Propriedades de Plug-in > Request Routing e verifique se Usando Fisicamente a Porta Especificada na Solicitação está selecionada para a propriedade Correspondência do Host Virtual.
  10. Pare o servidor de aplicativos e o servidor HTTP e inicie-os novamente.

    A configuração está concluída. Para ativar a configuração, pare e inicie o servidor de aplicativos e o servidor HTTP novamente.

Resultados

Se o plug-in HTTP Server para z/OS exibir-se com êxito quando o HTTP Server iniciar novamente, você receberá as seguintes mensagens:
O plug-in WebSphere HTTP para z/OS Versão 6.00 Nível de Serviço 0 está iniciando
 Plug-in WebSphere HTTP para z/OS inicializando com o arquivo de configuração:
         caminho_completo_para_o_arquivo_plugin-cfg.xml 
Inicialização do plug-in WebSphere HTTP para z/OS OK :-)

O que Fazer Depois

Após a configuração apropriada do servidor de aplicativos, do HTTP Server e do plug-in:
  • O produto pode utilizar esse plug-in para desempenhar funções comuns do plug-in.
  • Os pedidos podem ser roteados de um navegador, através do HTTP Server e plug-in, para um servidor de aplicativos no qual o aplicativo solicitado é implementado. (Novos pedidos são enviados para servidores de aplicativos selecionados de forma aleatória, nos quais esse aplicativo é implementado. Após estabelecer uma sessão, os pedidos são roteados de volta para o servidor de aplicativos designado para o pedido original).
  • Cabeçalhos privados podem ser usados como mecanismo para encaminhamento de 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_390
Nome do arquivo: trun_plugin_390.html