Instalação e Configuração do Apache HTTP Server

O Installation Manager instala e configura o Apache HTTP Server como o servidor da Web para o Build Forge. Usar o Apache HTTP Server fornecido é a maneira mais rápida de configurar um servidor da Web para o Build Forge.

Como alternativa à configuração padrão, é possível configurar um Apache HTTP Server existente em vez de um instalado e configurado pelo Build Forge. As instruções fornecidas presumem que você tenha experiência em instalação e configuração do Apache HTTP Server em seu sistema operacional.

Para usar o Apache HTTP Server existente, modifique sua instalação da seguinte forma:

  1. Modifique o arquivo de configuração do Apache HTTP Server (httpd-vhosts.conf) para apontar para o aplicativo Build Forge.
  2. Instale o PHP e configure os módulos PHP necessários para o Apache HTTP Server, o seu banco de dados Build Forge e a criptografia de senha se desejar usar esse recurso de segurança.
  3. Configure o Apache para o seu banco de dados.

Instalar o Build Forge Usando o Gerenciador de Instalação

No Gerenciador de Instalação, na página Configuração do Servidor da Web e de Aplicativo, selecione Sim no prompt Fornecer seu próprio servidor da Web.

Software Obrigatório

Editar o Arquivo de Configuração do Servidor Apache

  1. Localize o arquivo http-vhosts.conf do Apache no diretório extras da instalação do servidor.
    cd <apache-dir>/conf/extras/
vi httpd-vhosts.conf
  2. Edite o arquivo http-vhosts.conf do Apache. Para incluir informações sobre o Build Forge em httpd-vhosts.conf, inclua as linhas a seguir: 
    <VirtualHost *:80>
  ServerAdmin build@yourdomain.com
  DocumentRoot /opt/buildforge/webroot/public
	 ServerName ausbuild01.yourdomain.com
  ServerAlias build.yourdomain.com mc.yourdomain.com 
  ErrorLog logs/ausbuild.error_log
  CustomLog logs/ausbuild.access_log common
</VirtualHost>
  3. Modifique a configuração DocumentRoot para apontar para o aplicativo da Web do Build Forge. No exemplo, o diretório de instalação do Build Forge é /opt/buildforge.
  4. Deixe a porta como 80 ou altere-a para a porta em que você executa o Apache HTTP Server localmente.

    <VirtualHost *:80>

    Importante: Não utilize a porta 8080, ela é a porta padrão do Apache Tomcat.
  5. Modifique qualquer outra configuração em http-vhosts.conf conforme necessário para seu servidor Apache HTTP:
    • ServerAdmin: endereço de e-mail do administrador do Build Forge
    • DocumentRoot: local da página de entrada para o aplicativo Build Forge
    • ServerName: servidor no qual o aplicativo Build Forge está instalado
    • ServerAlias: aliases opcionais para a URL do ServerName do Build Forge
    • ErrorLog: Log de erros do Apache para o aplicativo Build Forge
    • CustomLog: Log de erros do Apache para a criação de log do acesso ao aplicativo Build Forge

Instalar e Configurar o PHP para o Apache HTTP Server

O PHP não é instalado com o Apache HTTP Server. Você deve instalar o PHP 5.2.4 e configurá-lo para apontar para httpd-vhosts.conf para o Apache HTTP Server.

Instalar e Configurar o PHP para o Banco de Dados do Build Forge

Durante a instalação do PHP, selecione e instale as extensões PHP para o tipo de banco de dados que você está usando como banco de dados do Build Forge.

(Opcional) Configurar o Módulo PHP OpenSSL para Suportar Criptografia de Senha

Para suportar SSL, o Build Forge usa o módulo PHP OpenSSL. Esse suporte é fornecido com o PHP 5.2.4; nenhuma configuração adicional é necessária.

Para suportar criptografia de senha, uma configuração adicional é necessária. O PHP 5.2.4 é necessário para suportar essa configuração. Você deve localizar os arquivos de correção para a extensão OpenSSL, instalá-los no diretório OpenSSL e recompilar o PHP, da seguinte forma:
  1. Localize os arquivos php_openssl.h e openssl.c no diretório misc, localizado no diretório de instalação do Build Forge, por exemplo:
    Windows C:\Arquivos de Programas\IBM\Build Forge\misc
    UNIX/Linux /opt/buildforge/Platform/misc
  2. Copie os arquivos de correção no diretório openssl, localizado no diretório de instalação do Build Forge.
  3. Compile PHP usando a opção de configuração --with-openssl=<path_to_openssl>, em que <path_to_openssl> é o diretório openssl do Build Forge.

Configurar o Apache para o seu Banco de Dados

É necessário incluir informações específicas no httpd.conf, dependendo do banco de dados.

Configuração do Apache para o DB2
  1. Inclua a seguinte linha no início do script de inicialização do Apache (normalmente, /etc/init.d/httpd ou /etc/init.d/apache2, dependendo da sua distribuição).
    source /home/db2bf/sqllib/db2profile
  2. Inclua as seguintes linhas no httpd.conf:
    PassEnv LD_LIBRARY_PATH
PassEnv CLASSPATH
PassEnv LIBPATH
PassEnv VWSPATH
Configuração do Apache para MySQL

Nenhuma configuração adicional é necessária.

Configuração do Apache para Oracle
  1. Inclua as seguintes linhas no httpd.conf:
    PassEnv LD_LIBRARY_PATH
PassEnv NLS_LANG
PassEnv ORACLE_HOME
PassEnv ORA_NLS
PassEnv ORA_NLS32
PassEnv TNS_ADMIN
  2. Inclua as seguintes linhas no script que inicia o Apache no tempo de inicialização (geralmente, /etc/init.d/httpd ou /etc/init.d/apache2) e fornece os valores das seguintes configurações.
    export LD_LIBRARY_PATH=<value>
export NLS_LANG=<value>
export ORACLE_HOME=<value>
export ORA_NLS=<value>
export ORA_NLS32=<value>
export TNS_ADMIN=<value>

Iniciar o IBM HTTP Server

Antes de iniciar o mecanismo do Build Forge e o Console de Gerenciamento, inicie o Apache HTTP Server.

Feedback