Apache HTTP Server の代わりに IBM HTTP Server を使用

デフォルトでインストールされている Apache HTTP Server の代わりに、IBM HTTP Server (IHS) を構成して、 管理コンソールで使用できるようにすることができます。

始める前に

このタスクについて

このセクションでは、以下の作業を行う方法について説明します。

  1. プリコンパイルされた PHP ファイルをセットアップします。
  2. Build Forge Web アプリケーションを指すように、IBM HTTP Server 構成ファイルを変更します。
  3. データベースへのアクセスにプロキシー・サーバーを使用する場合には、プロキシー・サーバーを使用できるように PHP を変更します。
  4. SSL を使用する場合には、SSL 経由で Build Forge を使用できるよう IHS を構成します。
  5. Windows システム: IBM HTTP Server インストール・ディレクトリーにある libeay32.dll を置き換えてください。
  6. AIX システム: 追加のセットアップ

プリコンパイルされた PHP ファイルをセットアップする

このタスクについて

この作業では、提供された PHP ファイルを見つけ、指定の場所にそれらをコピーする方法について説明します。 ファイルは以下のディレクトリーにあります。

  • Windows システム
    <bfinstall>¥ihs_modules
  • UNIX システムおよび Linux システム
    <bfinstall>/Platform/ihs_modules

手順

  1. PHP モジュールをコピーします。 必要に応じて modules ディレクトリーを作成します。
    • Windows システム
      cd <bfinstall>¥ihs_modules¥modules¥
      copy *.dll C:¥Program Files¥IBM¥HTTPServer¥modules
    • UNIX システムおよび Linux システム
      cd <bfinstall>/Platform/ihs_modules/modules
      cp libphp5.so /opt/IBM/HTTPServer/modules
  2. PHP 拡張をコピーします。 必要に応じて extensions ディレクトリーを作成します。
    • Windows システム
      cd <bfinstall>¥ihs_modules¥lib¥php¥extension¥
      copy *.dll C:¥Program Files¥IBM¥HTTPServer¥extensions
    • UNIX システムおよび Linux システム
      cd <bfinstall>/Platform/ihs_modules/lib/php/extensions/no-debug-zts-20090626
      cp *.so /opt/IBM/HTTPServer/extensions
  3. 提供された php.ini ファイルをコピーします。 必要に応じて conf ディレクトリーを作成します。
    • Windows システム
      cd <bfinstall>¥ihs_modules
      copy php.ini C:¥Program Files¥IBM¥HTTPServer¥conf
    • UNIX システムおよび Linux システム
      cd <bfinstall>/Platform/ihs_modules
      cp php.ini /opt/IBM/HTTPServer/conf
  4. conf ディレクトリーにコピーした php.ini ファイルを編集して、extensions ディレクトリーへのポインターを入力します。 次の行を追加するか、または置き換えます。
    • Windows システム
      extension_dir = C:¥Program Files¥IBM¥HTTPServer¥extensions
    • UNIX システムおよび Linux システム
      extension_dir = /opt/IBM/HTTPServer/extensions
  5. php.ini ファイルを編集し、ご使用のシステムの情報で更新します。 Apache HTTP Server 用の php.ini ファイルをガイドとして使用することができます。 このファイルは、次の場所にあります。
    • Windows システム
      <bfinstall>¥Apache¥php¥php.ini
    • UNIX システムおよび Linux システム
      <bfinstall>/server/apache/conf/php.ini
  6. 使用されているすべてのディレクトリーに対する書き込み権限を php.ini に追加します。 UNIX および Linux システムでは、次のコマンドをディレクトリーに対して実行してください。
    chmod -R 777

IBM HTTP Server 構成ファイルの編集

手順

  1. サーバー・インストール済み環境の conf ディレクトリーで、IBM HTTP Server (IHS) 用の httpd.conf ファイルを見つけます。
  2. 以下の例に示すように、Build Forge Web アプリケーションを 指すように DocumentRoot 設定を変更します。この例では、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. PHP 関連項目を追加します。
    • 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 is the location of the php.ini file
      PHPIniDir "C:¥Program Files¥IBM¥HTTPServer¥conf"
    • UNIX システムおよび 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 is the location of the php.ini file
      PHPIniDir "/opt/IBM/HTTPServer/conf"
  4. User および Group ステートメントを、daemon (<bfinstall>/webroot/templates_c のデフォルト・ユーザー) を使用するように変更します。
    User daemon
    Group daemon
  5. 必要に応じて IHS ポート番号を変更します。デフォルト・ポート番号は 80 です。 その他の必要な変更をすべて httpd.conf に加えます。

PHP でのプロキシー・サーバーの識別

このタスクについて

オプション: このステップは、管理コンソールでプロキシー・サーバーを使用してデータベースにアクセスする場合にのみ必要です。

手順

PHP 構成ファイル php.ini を編集します。 このファイルは <php-install>/lib にあります。 例えば /usr/local/php-5.3.6 などです。

次の項目を追加します。

bf_proxyHost=<使用するプロキシー・サーバーのホスト名>
bf_proxyPath=<プロキシーのパス>
bf_symlinkPath=<symlink からプロキシーへのパス>

IHS 用 SSL の構成

このタスクについて

IHS を Build Forge と連携させるには、通常の SSL セットアップ以外に、追加の要件があります。

手順

  1. パスに Build Forge ツール・ディレクトリーを含めます。
    • Windows システム
      • bfinstall¥ibmjdk¥bin
      • bfinstall¥openssl
    • UNIX システムまたは Linux システム
      • bfinstall/server/ibmjdk/bin
  2. ご使用のライブラリー・パスに Build Forge ツール・ディレクトリーを組み込みます。
    • AIX システム (LIBPATH)
      • bfinstall/openssl
    • UNIX システムまたは Linux システム (LD_LIBRARY_PATH)
      • bfinstall/openssl
  3. JAVA_HOME に Build Forge ツール・ディレクトリーを含めます。
    • Windows
      • bfinstall¥ibmjdk
    • UNIX または Linux
      • bfinstall/server/ibmjdk
  4. Build Forge キーを PKCS12 から CMS に変換します。 最新バージョン の GSKIT ツールを使用してください。 gsk7¥bin (Windows) または bin (UNIX または Linux) で、以下のコマンドを実行します (見やすくするために改行が挿入されています)。
    gsk7cmd -keydb 
            -convert 
            -db bfinstall¥keystore¥buildForgeKeyStore.p12 
            -pw buildForgeKeyStore_password 
            -old_format pkcs12 
            -new_format cms
  5. stash ファイルにパスワードを保管します。 IHS はこのファイルを使用して、始動中にパスワードを取得します。ファイルがない場合、IHS はパスワードを求めるプロンプトを出します。最新バージョン の GSKIT ツールを使用してください。 gsk7¥bin (Windows) または bin (UNIX または Linux) で、以下のコマンドを実行します (見やすくするために改行が挿入されています)。
    gsk7cmd -keydb 
            -stashpw 
            -db bfinstall¥keystore¥buildForgeKeyStore.kdb 
            -pw buildForgeKeyStore_password
  6. httpd.conf を変更します。 Windows では、以下の項目を組み込みます。 ユーザーに、https 経由でのみアクセスさせたい場合、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>

    UNIX および Linux では、以下の項目を組み込みます。 ユーザーに、https 経由でのみアクセスさせたい場合、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 は、インストール・ディレクトリーのルートです。上記の UNIX および Linux 用のステップでは、多くの場合、正しいディレクトリーに到達するために /Platformbfinstall の末尾に追加する必要があります。また、ディレクトリー区切りとして、円記号 (¥) ではなくスラッシュ (/) を使用する必要があります。

タスクの結果

詳しくは、SSL のセットアップに関する IHS 資料を参照してください。

Windows: DLL の置換

このタスクについて

バージョン 8.0 よりも古い IBM HTTP Server を使用している場合、DLL を Rational Build Forge に用意されているもので置き換える必要があります。

手順

IBM HTTP Server インストール・ディレクトリーの複数の場所にある既存の libeay32.dll ファイルを見つけ、置き換えます。
  • <bfinstall>/openssl に用意されている libeay32.dll を使用してください。
  • DLL のインスタンスをすべて検索し、それらを置き換えます。 Windows 2003 における場所の例:
    <ihs_install>¥Plugins¥gsk7¥gsk7_32¥icc¥osslib
    <ihs_install>¥gsk7¥icc¥osslib

タスクの結果

DLL を置き換えた後、HTTP サーバーは正常に起動できるようになります。 置き換えないと、HTTP サーバーは起動しません。

AIX システム: 追加のセットアップ

AIX システムでは、セットアップがさらに必要です。

手順


フィードバック