Usando o IBM HTTP Server em vez do Apache HTTP Server

É possível configurar o IBM HTTP Server (IHS) para uso com o Console de Gerenciamento, mas é altamente recomendado que você use um Servidor Apache HTTP integrado.

Antes de Iniciar

Sobre Esta Tarefa

Esse tópico descreve como executar as tarefas a seguir:

  1. Configure os arquivos PHP pré-compilados.
  2. Modifique os arquivos de configuração do IBM HTTP Server para apontar para o aplicativo da Web do Build Forge.
  3. Se você utilizar um servidor proxy para acessar o banco de dados, modifique o PHP para utilizar o servidor proxy.
  4. Se você utilizar SSL, configure o IHS para trabalhar com o Build Forge por meio do SSL.
  5. Sistemas Windows: substituir a libeay32.dll no diretório de instalação do IBM HTTP Server.
  6. Sistemas AIX: Configuração Adicional

Configurar os Arquivos PHP Pré-compilados

Sobre Esta Tarefa

Essa tarefa descreve como localizar os arquivos PHP fornecidos e copiá-los para os locais especificados. Os arquivos estão nos seguintes diretórios:

  • Sistemas Windows
    <bfinstall>\ihs_modules
  • Sistemas UNIX e Linux
    <bfinstall>/Platform/ihs_modules

Procedimento

  1. Copie os módulos PHP. Crie o diretório modules, se necessário.
    • Sistemas Windows
      cd <bfinstall>\ihs_modules\modules\
      copy *.dll C:\Program Files\IBM\HTTPServer\modules
    • Sistemas UNIX e Linux
      cd <bfinstall>/Platform/ihs_modules/modules
      cp libphp5.so /opt/IBM/HTTPServer/modules
  2. Copie as extensões PHP. Crie o diretório extensions, se necessário.
    • Sistemas Windows
      cd <bfinstall>\ihs_modules\lib\php\extensions\
      copy *.dll C:\Program Files\IBM\HTTPServer\extensions
    • Sistemas UNIX e Linux
      cd <bfinstall>/Platform/ihs_modules/lib/php/extensions/no-debug-zts-20090626
      cp *.so /opt/IBM/HTTPServer/extensions
  3. Copie o arquivo php.ini fornecido. Crie o diretório conf, se necessário.
    • Sistemas Windows
      cd <bfinstall>\ihs_modules
      copy php.ini C:\Program Files\IBM\HTTPServer\conf
    • Sistemas UNIX e Linux
      cd <bfinstall>/Platform/ihs_modules
      cp php.ini /opt/IBM/HTTPServer/conf
  4. Edite o arquivo php.ini copiado para o diretório conf para incluir um ponteiro para o diretório extensions. Inclua ou substitua a linha a seguir:
    • Sistemas Windows
      extension_dir = C:\Program Files\IBM\HTTPServer\extensions
    • Sistemas UNIX e Linux
      extension_dir = /opt/IBM/HTTPServer/extensions
  5. Edite o arquivo php.ini com informações de seu sistema. É possível usar o arquivo php.ini fornecido para o Apache HTTP Server como um guia. O arquivo é fornecido na localização a seguir:
    • Sistemas Windows
      <bfinstall>\Apache\php\php.ini
    • Sistemas UNIX e Linux
      <bfinstall>/server/apache/conf/php.ini
  6. Inclua acesso para todos os diretórios usados em php.ini. Nos sistemas UNIX e Linux, execute o comando a seguir nos diretórios:
    chmod -R 777

Editar o Arquivo de Configuração do IBM HTTP Server

Procedimento

  1. Localize o arquivo httpd.conf do IBM HTTP Server (IHS) no diretório conf da instalação de servidor.
  2. Modifique a configuração DocumentRoot para apontar para o aplicativo da Web do Build Forge, conforme mostrado no exemplo. Neste exemplo, o diretório de instalação do Build Forge é /opt/buildforge.
    <VirtualHost *:80>
         ServerAdmin build@yourdomain.com
         DocumentRoot /opt/buildforge/webroot/public
         ServerName ausbuild01.yourdomain.com
         ServerAlias build.yourdomain.com mc.yourdomain.com #optional server aliases
         ErrorLog logs/ausbuild.error_log
         CustomLog logs/ausbuild.access_log common
    </VirtualHost>
  3. Inclua entradas relacionadas ao PHP.
    • Sistemas Windows
      LoadModule php5_module "C:\Program Files\IBM\HTTPServer\modules\php5apache2_2.dll"
      
      <IfModule dir_module>     
         DirectoryIndex index.html index.php
      </IfModule>  
      
      AddType application/x-httpd-php .php 
      
      # PHPIniDir é o local do arquivo php.ini
      PHPIniDir "C:\Program Files\IBM\HTTPServer\conf"
    • Sistemas UNIX e Linux
      LoadModule php5_module "/opt/IBM/HTTPServer/modules/libphp5.so"
      
      <IfModule dir_module>     
         DirectoryIndex index.html index.php
      </IfModule>  
      
      AddType application/x-httpd-php .php 
      
      # PHPIniDir é o local do arquivo php.ini
      PHPIniDir "/opt/IBM/HTTPServer/conf"
  4. Altere as instruções para o usuário padrão:
    • Se você estiver usando um sistema AIX, use o User daemon e Group staff em vez de User daemon e Group daemon.
    • Para um Sistema Linux, altere as instruções para Daemon de usuário e Daemon de grupo no arquivo templates_c na pasta <bfinstall>/webroot/templates_c. Um exemplo para um Sistema Linux é chown daemon:daemon /opt/buildforge/webroot/templates_c.
  5. Altere as permissões no arquivo templates_c. Use daemon: daemon nos sistemas Linux e daemon: staff nos sistemas AIX. Eis um exemplo para os sistemas Linux:
    chown daemon:daemon /opt/buildforge/webroot/templates_c
  6. Se necessário, altere o número da porta do IHS. O número da porta padrão é 80. Faça qualquer outra alteração necessária em httpd.conf.

Identifique o Servidor Proxy no PHP

Sobre Esta Tarefa

Execute esta etapa apenas se o console de gerenciamento precisar usar um servidor proxy para acessar seu banco de dados.

Procedimento

Edite o arquivo de configuração do PHP php.ini. Ele está localizado em <php-install>/lib;, por exemplo, /usr/local/php-5.3.6.

Inclua as seguintes entradas:

bf_proxyHost=<your_proxy_server_hostname>
bf_proxyPath=<your_proxy_path>
bf_symlinkPath=<symlink_to_proxy_path>

Configurando SSL para IHS

Sobre Esta Tarefa

Além da configuração SSL normal para IHS, há requisitos adicionais para que ele funcione com Build Forge®.

Procedimento

  1. Inclua os diretórios de ferramenta do Build Forge® em seu caminho.
    • Sistemas Windows:
      • bfinstall\ibmjdk\bin
      • bfinstall\openssl
    • Sistemas Unix ou Linux:
      • bfinstall/server/ibmjdk/bin
  2. Inclua os diretórios de ferramenta do Build Forge® no caminho da biblioteca.
    • Sistemas AIX (LIBPATH):
      • bfinstall/openssl
    • Sistemas Unix ou Linux (LD_LIBRARY_PATH):
      • bfinstall/openssl
  3. Converta as chaves do Build Forge® de PKCS12 para CMS. Use a versão mais recente da ferramenta GSKIT. Em gsk7\bin (Windows) ou bin (Unix ou Linux), execute o comando a seguir (quebras de linha são incluídas para maior clareza):
    gsk7cmd -keydb 
            -convert 
            -db bfinstall\keystore\buildForgeKeyStore.p12 
            -pw buildForgeKeyStore_password 
            -old_format pkcs12 
            -new_format cms
  4. Armazene a senha em um arquivo stash. O IHS usa esse arquivo para obter a senha durante a inicialização. Sem ele, o IHS solicita a senha. Use a versão mais recente da ferramenta GSKIT. Em gsk7\bin (Windows) ou bin (Unix ou Linux), execute o comando a seguir (quebras de linha são incluídas para maior clareza):
    gsk7cmd -keydb 
            -stashpw 
            -db bfinstall\keystore\buildForgeKeyStore.kdb 
            -pw buildForgeKeyStore_password
  5. Modifique o httpd.conf. Inclua as entradas a seguir para Windows. Se quiser que os usuários acessem usando apenas https, comente a linha Listen 80.
    LoadModule ibm_ssl_module modules/mod_ibm_ssl.so
    # Listen 80
    Listen 0.0.0.0:443
    <VirtualHost *:443>
    SSLEnable
    SSLClientAuth None
    SSLProtocolDisable SSLv2 
    SSLServerCert buildforge
    KeyFile bfinstall\keystore\buildForgeKeyStore.kdb
    SSLStashFile bfinstall\keystore\buildForgeKeyStore.sth
    ErrorLog bfinstall\Apache\logs\ssl_error.log
    TransferLog bfinstall\Apache\logs\transfer.log
    </VirtualHost>

    Inclua as entradas a seguir para Unix e Linux. Se quiser que os usuários acessem usando apenas https, comente a linha Listen 80.

    LoadModule ibm_ssl_module modules/mod_ibm_ssl.so
    # Listen 80
    Listen 0.0.0.0:443
    <VirtualHost *:443>
    SSLEnable
    SSLClientAuth None
    SSLProtocolDisable SSLv2 
    SSLServerCert buildforge
    KeyFile bfinstall/Platform/keystore/buildForgeKeyStore.kdb
    SSLStashFile bfinstall/Platform/keystore/buildForgeKeyStore.sth
    ErrorLog bfinstall/server/apache/logs/ssl_error.log
    TransferLog bfinstall/server/apache/logs/transfer.log
    </VirtualHost>

    bfinstall é a raiz do diretório de instalação. Para as etapas acima, no Unix e Linux, talvez seja necessário anexar /Platform a bfinstall para atingir o diretório correto. Você também deve usar uma barra (/) em vez de uma barra invertida (\) para separar diretórios.

Resultados

Consulte a documentação do IHS sobre configuração SSL para obter mais informações.

Windows: substituir DLL

Sobre Esta Tarefa

Se estiver usando uma versão do IBM HTTP Server anterior à versão 8.0, você deverá substituir o DLL pelo fornecido com Rational® Build Forge®.

Procedimento

Localize e substitua o arquivo libeay32.dll existente em vários locais no diretório de instalação do IBM HTTP Server.
  • Utilize o libeay32.dll fornecido em <bfinstall>/openssl.
  • Procure por todas as instâncias do DLL e substitua-as. Os locais de exemplo no Windows 2003 são:
    <ihs_install>\Plugins\gsk7\gsk7_32\icc\osslib
    <ihs_install>\gsk7\icc\osslib

Resultados

O servidor HTTP poderá ser iniciado normalmente após você substituir a DLL. Se você não substituí-la, ocorrerá falha na inicialização do servidor HTTP.

Sistemas AIX: Configuração Adicional

Para sistemas AIX, uma configuração adicional é necessária.

Procedimento


Feedback