[z/OS]

Instalando e configurando o IBM HTTP Server no sistema z/OS V2R2

é possível configurar uma instância do IBM® HTTP Server no sistema operacional z/OS. O IBM HTTP Server Versão 9 para WebSphere Application Server para z/OS é um elemento base do z/OS V2R2 e posteriores. É preciso configurar uma instância do IBM HTTP Server no sistema operacional z/OS após a instalação.

Antes de Iniciar

Atenção: O IBM HTTP Server agora é instalado com o sistema operacional base no z/OS V2R2 e posteriores. Nenhuma instalação separada é necessária. O IBM HTTP Server Versão 9 é instalado no diretório /usr/lpp/ihsa_zos.
Antes de utilizar o programa instalador:
  • Para uma primeira configuração, crie um ID do usuário e grupo do System Authorization Facility (SAF) para o IBM HTTP Server. Para obter informações adicionais, consulte Executando a configuração do sistema z/OS necessária.

    Os exemplos a seguir consideram um ID do usuário do servidor de WWWSERV e um grupo de servidores de WWWGROUP.

  • Se estiver usando o IBM HTTP Server com o WebSphere Application Server, crie um diretório de instalação para os arquivos de configuração para a instância do servidor. Para obter informações adicionais, consulte o tópico sobre como migrar e instalar o IBM HTTP Server nos sistemas z/OS.
    Os exemplos a seguir neste tópico supõem um diretório de instalação /etc/websrv1. Defina as permissões de diretório como 770 e a propriedade do diretório como o ID do usuário e o grupo do servidor:
    mkdir  /etc/websrv1 
    chown  WWWSERV:WWWGROUP /etc/websrv1
    chmod 770 /etc/websrv1
  • Se estiver instalando o produto pela primeira vez, ative o console administrativo para modificar o arquivo httpd.conf incluindo o ID do usuário da região de controle do WebSphere Application Server no grupo do IBM HTTP Server usando SAF. Por exemplo, para incluir um usuário ASCR1 no grupo WWWGROUP, digite o seguinte comando:
    CONNECT ASCR1 GROUP (WWWGROUP) OWNER (WWWGROUP)
Atenção: O IBM HTTP Server no z/OS V2R2 é instalado com o sistema operacional base e nenhuma instalação separada é necessária. Para lançamentos mais antigos do z/OS, siga as informações do IBM Installation Manager sobre este tópico.

Sobre Esta Tarefa

Usando o programa instalador, instale uma instância em execução do IBM HTTP Server for z/OS em sua máquina.

Procedimento

  1. Efetue login no shell z/OS UNIX System Services com o ID do usuário que executa o instalador. Consulte a seção Antes de iniciar para esse tópico. Altere o diretório para o diretório do código do produto do IBM HTTP Server:
    cd /usr/lpp/ihsa_zos
  2. Configure o valor de umask como 022 especificando umask 022. Para verificar se o valor de umask está configurado como 022, execute o comando umask.
  3. Execute o programa instalador bin/install_ihs para instalar os arquivos do produto no diretório de instalação, executar a customização inicial e criar links simbólicos do diretório de instalação para o diretório do produto.
    Nota: Com o parâmetro -31, bin/install_ihs cria a mesma estrutura de diretório e arquivos que criariam sem o parâmetro, mas todos os links apontam para o caminho .31bit no caminho da instalação do IHS. Todas as referências para o executável, tal como apachectl, permanecem as mesmas.
    Quatro parâmetros podem ser usados para chamar o programa instalador.
    • Opcional: A palavra-chave -admin, que permite o uso do console administrativo para modificar o arquivo httpd.conf.
    • O diretório de instalação para a instância do servidor. Ele não deve ser igual ao do diretório do produto.
    • Opcional: A porta não SSL para o servidor da Web. A porta padrão é 80. Também é possível alterar a porta na diretiva Listen.
    • Se estiver utilizando o IBM HTTP Server com o WebSphere Application Server, se dirigido por um produto ou componente dependente para criar uma instância 31-bit do IHS, transmita o parâmetros -31 para o bin/install_ihs. Isto resulta em um diretório de instância que está configurado para apontar para executáveis 31-bit. Nunca referencie diretamente o subdiretório .31bit de uma instalação somente leitura ou de um diretório de instâncias (64-bit).
    Os exemplos a seguir chamam o programa instalador a partir do console administrativo. Você pode chamar o comando com ou sem suporte para modificar o arquivo httpd.conf. Para os dois exemplos, /etc/websrv1 é o diretório de instalação e 80 é a porta não SSL do servidor da Web.
    • Esse exemplo chama o comando com suporte para modificar o arquivo httpd.conf.
      bin/install_ihs -admin /etc/websrv1 80
    • Esse exemplo chama o comando sem suporte para modificar o arquivo httpd.conf.
      bin/install_ihs /etc/websrv1 80
    Nota: Se o caminho do diretório do produto contiver links simbólicos, aponte os links simbólicos para o seguinte diretório do produto padrão: /usr/lpp/ihsa_zos. Se você não usar o diretório de produto padrão, deve-se chamar o script de instalação usando seu caminho absoluto, como /WebSphere/9.0/SMPE/bin/install_ihs. Se você não usar uma das duas opções, o IBM HTTP Server criará links físicos, não links lógicos, quando ele criar os links simbólicos para o diretório de instalação.
  4. Opcional: Esta etapa é opcional, a menos que o console administrativo esteja configurado para iniciar e parar o IBM HTTP Server. É possível iniciar a instância do IBM HTTP Server a partir do console MVS criando um procedimento catalogado de JCL para a instância. Para obter informações adicionais, consulte o tópico sobre como usar procedimentos JCL para iniciar o IBM HTTP Server no z/OS. Certifique-se de que o procedimento JCL está designado para o usuário e grupo que você definiu para o IBM HTTP Server. Para obter mais informações, consulte "Executando configurações de sistema z/OS necessárias". Esta etapa é necessária se você estiver usando o console administrativo para iniciar e parar o IBM HTTP Server.
    Aviso: O valor de PARM no seu procedimento catalogado JCL é limitado a 100 caracteres. Como o valor do PARM contém o diretório de instalação (&DIR), o comprimento total pode exceder o limite de 100 caracteres se o caminho do diretório for muito longo. O comprimento do nome do caminho precisa ser levado em consideração ao escolher o diretório de instalação. Se o nome do caminho do diretório de instalação for muito longo, é possível utilizar um caminho de nome mais curto no JCL que é simbolicamente vinculado ao nome do caminho do diretório de instalação original.
  5. Opcional: É possível criar diversas instâncias do IBM HTTP Server executando o programa instalador do IBM HTTP Server mais de uma vez. No entanto, você deve especificar um diretório de instalação diferente sempre que executar o programa instalador.

Resultados

Desempenhe as tarefas a seguir para confirmar se você instalou com êxito uma versão em execução do produto em sua máquina:

  1. Efetue logon no shell OMVS utilizando o ID do usuário do servidor. Verifique se o ID do usuário do servidor tem um valor UID diferente de zero. Altere o diretório para o diretório de instalação da instância do servidor:
    cd /etc/websrv1
  2. Execute os seguintes comandos para verificar a instalação do programa: apachectl -v e apachectl configtest
    A saída de amostra a seguir é um exemplo de uma instalação de programa bem-sucedido:
    # bin/apachectl -v
    Server version: IBM_HTTP_Server/9.0.0.0 (Unix)
    Server built:   Jan  27 2016 12:38:02
    # bin/apachectl configtest
    Sintaxe OK
    A sequência de versão e a data de compilação reais variam.
  3. Inicie o IBM HTTP Server.
    bin/apachectl start
  4. Aponte um navegador da Web para o nome ou endereço IP de seu sistema z/OS, usando o número da porta não SSL especificado ao executar o programa instalador ou a porta padrão de 80. Você deve ver a página inicial padrão do IBM HTTP Server.
  5. Pare o IBM HTTP Server executando o comando a seguir:
    bin/apachectl stop

O que Fazer Depois

  • Se estiver usando o IBM HTTP Server com o WebSphere Application Server, instale e configure o plug-in do WebSphere Application Server para o IBM HTTP Server.
  • Para obter informações sobre como editar o arquivo de configuração do IBM HTTP Server, httpd.conf, e informações sobre os módulos Apache suportados, consulte Configurando o IBM HTTP Server.
    As alterações típicas que você pode fazer no arquivo de configuração são:
    • Edite a diretiva DocumentRoot para apontar para as páginas da Web do seu site.
    • Ative o plug-in do WebSphere Application Server para IBM HTTP Server incluindo as seguintes diretivas no final de httpd.conf:
      LoadModule was_ap24_module  <plugin_config_hfs>/bin/mod_was_ap24_http.so
      WebSpherePluginConfig /path/to/existing/plugin-cfg.xml
      Se o arquivo de configuração de plug-in tiver sido usado com um plug-in do WebSphere Application Server Versão 5.0 ou 5.1, o arquivo estará em EBCDIC. Antes de usar o arquivo com este plug-in do WebSphere Application Server Versão 6.0 ou superior, é necessário convertê-lo em ASCII. O exemplo a seguir é para converter o arquivo de configuração de plug-in de EBCDIC em ASCII:
      $ iconv -f IBM1047 -t ISO8859-1 < /path/to/existing/plugin-cfg.xml \
      > /path/to/ascii/plugin-cfg.xml
    • Ative o suporte SSL incluindo as seguintes diretivas no final de httpd.conf:
      LoadModule ibm_ssl_module modules/mod_ibm_ssl.so
      Listen 443
      <VirtualHost *:443>
      SSLEnable
      </VirtualHost>
      SSLDisable
      Keyfile /saf saf-keyring-name
      A diretiva Keyfile pode especificar um nome do arquivo HFS usando a sintaxe: Keyfile /path/to/keyfile.kdb. O arquivo .sth deve estar no mesmo diretório do arquivo .kdb. Para obter informações adicionais, consulte Protegendo com Comunicações SSL e Diretivas SSL.
    • Ative o mod_status removendo o delimitador de comentário no arquivo de configuração padrão destacado no exemplo a seguir:
      <IfModule mod_status.c>
      ExtendedStatus On
      </IfModule>
      ...
      #<Location /server-status>
      #    SetHandler server-status
      #    Order deny,allow
      #    Deny from all
      #    Allow from .example.com
      #</Location> 
      Se você desejar restringir o acesso a redes específicas, remova o comentário da configuração da amostra mod_access, mas modifique a diretiva Allow from para especificar o domínio ou a rede apropriado.
    • É possível instalar o servidor da Web em um R/W compartilhado do HFS através de vários hosts em um sysplex.
      Há requisitos de configuração especiais para componentes do servidor da Web que utilizam soquetes AF_UNIX. Os soquetes AF_UNIX não são suportados por um HFS que são R/W compartilhados, de modo que as diretivas de configuração são utilizadas para colocar soquetes AF_UNIX em um sistema de arquivos possuído pelo host no qual o servidor da Web é executado.
      • Se mod_ibm_ssl estiver carregado, utilize a diretiva SSLCachePortFilename para especificar um arquivo em um sistema de arquivos possuído pelo host local.
      • Se mod_fastcgi estiver carregado, utilize a diretiva FastCGIIpcDir para especificar um diretório em um sistema de arquivos possuído pelo host local.
  • Se estiver usando o IBM HTTP Server com o WebSphere Application Server, inclua o suporte para o console administrativo após a instalação inicial.
    • Execute o script bin/enable_admin para definir as permissões necessárias para modificar o arquivo httpd.conf do console administrativo.
    • Para modificar o arquivo httpd.conf a partir do console administrativo, você deve incluir o ID do usuário da região de controle no grupo do IBM HTTP Server usando SAF. Por exemplo, para incluir um usuário ASCR1 no grupo WWWGROUP, digite o seguinte comando:
      CONNECT ASCR1 GROUP (WWWGROUP) OWNER (WWWGROUP)
    • Para usar o console administrativo para iniciar e parar o IBM HTTP Server, você deve criar um procedimento JCL catalogado. Para obter informações, consulte o tópico sobre como usar procedimentos JCL para iniciar o IBM HTTP Server no z/OS. Certifique-se de que o procedimento JCL está designado para o usuário e grupo que você definiu para o IBM HTTP Server. Para obter mais informações, consulte "Executando configurações de sistema z/OS necessárias".

Í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=ihs-dist&topic=tihs_installihsz
Nome do arquivo: tihs_installihsz.html