Build Forge アプリケーションを実行するように Websphere Application Server を構成

サービス・アプリケーションとヘルプ・アプリケーションを実行するよう、WebSphere Application Server を構成します。

このタスクについて

WebSphere 管理コンソールで、以下の手順に従ってください。
WebSphere バージョン 8.0 以降、WebSphere 管理コンソールのユーザー・インターフェースに少しだけ変更が加えられました。 以下の説明は、バージョン 7 以前に対応しています。 この手順に影響する、バージョン 8.0 における違い:
  • アプリケーションにアクセスするには、「アプリケーション」 > 「アプリケーション・タイプ」 > 「エンタープライズ・アプリケーション」を使用してください。
  • コンテキスト・ルートを設定する手順は、アプリケーションを選択した後に移動しました。
  • 「リソース用の MBean の作成」のチェック・ボックスは表示されません。

手順

  1. WebSphere 管理コンソールを開きます。 コンソールの URL:
    • http://<was_host>:<was_port>/ibm/console。 デフォルト・ポートは 9060 です。
    • https://<was_host>:<was_port>/ibm/console。デフォルト・ポートは 9043 です。 WebSphere 管理セキュリティーが有効である場合はこの URL を使用します。
  2. ご使用の JDBC ドライバーのサポートを構成します。
    1. 新規変数 RBF_JDBC_DRIVER_PATH を作成します。 変数は、「環境変数」 > 「WebSphere 環境変数 (WebSphere Variables)」で作成します。 そのスコープは、WAS ノードおよびサーバーです。 使用するデータベース・ドライバーの JAR ファイルが入っているディレクトリーに値を設定します。
    2. マスター構成に加えた変更を保存します。
    3. WebSphere サーバーを停止および再始動して、新規変数を有効にします。
    4. 新規共用ライブラリー RBF_JDBC_LIBRARY を作成します。

      ライブラリーは、「環境変数」>「共用ライブラリー (Shared Libraries)」で作成します。 作成した RBF_JDBC_DRIVER_PATH を使用して、JDBC デバイス・ドライバーの JAR ファイル名を追加します。 リストする JAR ファイルが複数ある場合は、各 JAR ファイルをそれぞれの行に追加します (DB2 の場合と同様)。

      以下は、MySQL データベース・ドライバーの場合の例です。

      ${RBF_JDBC_DRIVER_PATH}¥mysql-connector-java-5.0.5-bin.jar

      次は、DB2 の場合の例です。

      ${RBF_JDBC_DRIVER_PATH}¥db2jcc.jar
      ${RBF_JDBC_DRIVER_PATH}¥db2jcc_license_cu.jar

      この例では、UNIX または Linux の場合、円記号 (¥) の代わりに順方向スラッシュ (/) を使用します。

    5. マスター構成に加えた変更を保存します。
  3. Build Forge アプリケーションの WAR ファイルをインストールします。
    1. 「アプリケーション」 > 「エンタープライズ・アプリケーション (Enterprise Applications)」を開きます。
    2. 「インストール (Install)」をクリックします。
    3. rbf-services.war ファイルを参照します。 rbf-services をコンテキスト・ルートとして使用します。
      • Windows システム
        <bfinstall>¥PrepForExternal¥rbf-services.war
      • UNIX システムおよび Linux システム
        <bfinstall>/Platform/PrepForExternal/rbf-services.war
    4. 「次へ」をクリックし、以下のチェック・ボックスが選択されている場合はクリアします。
      • 「リソース用の MBean の作成」
    5. 「完了」ボタンが表示されるまで「次へ」をクリックし、 「完了」をクリックします。
    6. インストール・テキストの下部で、「保存」をクリックします。
  4. Build Forge Help WAR ファイルをインストールします。
    1. 「アプリケーション」>「エンタープライズ・アプリケーション (Enterprise Applications)」を開きます。
    2. 「インストール (Install)」をクリックします。
    3. Build Forge インストール・ディレクトリー内の BuildForgeHelp.war ファイルを参照します。 /BuildForgeHelp をコンテキスト・ルートとして使用します。
    4. 「次へ」をクリックし、以下のチェック・ボックスが選択されている場合はクリアします。
      • 「リソース用の MBean の作成」
    5. 「完了」ボタンが表示されるまで「次へ」をクリックし、 「完了」をクリックします。
    6. インストール・テキストの下部で、「保存」をクリックします。
  5. 共用ライブラリーの参照として RBF_JDBC_LIBRARY を設定します。
    1. 「アプリケーション」>「エンタープライズ・アプリケーション (Enterprise Applications)」を開きます。
    2. 「rbf-services.war」リンクをクリックします。
    3. 「共用ライブラリーの参照 (Shared library references)」をクリックします。
    4. 「サービス層ログイン・サーブレット (A Services Layer Login Servlet)」ボックスを選択します。
    5. 「参照共用ライブラリー (Reference Shared Libraries)」をクリックします。
    6. リストに RBF_JDBC_LIBRARY を追加します。
  6. クラス・ローダー順序を設定します。 「モジュールの管理 (Manage Modules)」の下で、 「サービス層ログイン・サーブレット (A Services Layer Login Servlet)」を選択し、 ドロップダウン・ボックスで「クラス・ローダーの順序 (Class loader order)」を見つけます。 値を「ローカル・クラス・ローダーによってロードされたクラスから先に (親が最後) (Classes loaded with local class loader first (parent last))」に変更します。
  7. マスター構成に加えた変更を保存します。
  8. Build Forge 構成ファイルを調べます。 ファイル内の services_url エントリーが正しい URL を指していることを確認します。 WAS を使用している場合、buildforge.conf におけるこのプロパティーの値は、https://<hostname>:9443/rbf-serviceshttps://<hostname>:9080/rbf-services のようになります。 buildforge.conf ファイルは、以下の場所にあります。
    • Windows システム
      <bfinstall
    • UNIX システムおよび Linux システム
      <bfinstall>/Platform/
  9. bin ディレクトリー内のファイルすべてに対する、rbf-services の実行アクセス権を追加します (UNIX および Linux システム)。 この例では、プロファイル AppSrv01 が使用されています。 AppSrv01 ではない場合、ご使用のプロファイル名を使用してください。
    chmod -R 755 <WAS-install>/AppServer/profiles/AppSrv01/installedApps/<node>/rbf-services_war.ear/rbf-services.war/bin
  10. PATH 変数を更新して、トークン・ライブラリー・ディレクトリーを組み込みます。
    • Windows システム
      <bfinstall>¥token_libs
    • UNIX システムおよび Linux システム
      <bfinstall>/Platform/token_libs
  11. 64 ビットの Linux または WAS が使用されている場合は、所定の 64 ビット・ライブラリーをコピーする必要があります。
    1. 32 ビット・ライブラリー・ファイルの名前を変更します。
      • Windows システム: <bfinstall>¥token_libs¥rcl_rational.dll<bfinstall>¥token_libs¥rcl_rational.dll.old に名前変更します。
      • UNIX システムおよび Linux システム: <bfinstall>/Platform/token_libs/librcl_rational.so<bfinstall>/Platform/token_libs/librcl_rational.so.old に名前変更します。
    2. 64 ビット・ライブラリー・ファイルを token_libs_64 から token_libs にコピーします。 コマンドの途中で改行しないでください。 ここでは、読みやすくなるように改行を使用しています。
      • Windows システム
        copy <bfinstall>¥token_libs_64¥rcl_rational.dll 
             <bfinstall>¥token_libs¥rcl_rational.dll
      • UNIX システムおよび Linux システム
        cp <bfinstall>/Platform/token_libs_64/librcl_rational.so 
           <bfinstall>/Platform/token_libs/librcl_rational.so

フィードバック