Rational Engineering Lifecycle Manager のための WebSphere Application Server のセットアップ

Jazz™ Team Server をデプロイして始動するには、まず、Jazz Team Server とそのアプリケーションをホストするアプリケーション・サーバーを選択します。 Rational® Engineering Lifecycle Manager アプリケーション war ファイルをデプロイするには、その前に WebSphere® Application Server をセットアップする必要があります。

始める前に

必ず以下のタスクが完了していることを確認してください。

Jazz Web インターフェースでは、アプリケーションの許可や個人情報設定を実行するために、認証が構成されている必要があります。

注:
  • Rational Engineering Lifecycle Manager v1.x では、1 つのアプリケーション・サーバーをライフサイクル照会エンジンと共有する必要があります。
  • Rational Engineering Lifecycle Manager v4.x は、1 つのアプリケーション・サーバーをライフサイクル照会エンジンと共有することも、別のアプリケーション・サーバーにデプロイすることもできます。ただし、 両方のアプリケーションが同じ Jazz Team Server に登録されている必要があります。

このタスクについて

本書では、WebSphere 認証または SSL の構成については、複雑なトピックになるので詳細は説明していません。 各種認証および暗号化オプションの詳細情報については、WebSphere Application Server インフォメーション・センターで説明されています。 詳しくは 、 WebSphere インフォメーション・センターにアクセスして、「アプリケーションとその環境の保護」というフレーズを検索で使用してください。

手順

  1. Rational Engineering Lifecycle Manager は、自身が稼働する Java 仮想マシン上に固有の設定をいくつか必要とします。 これらのプロパティーを設定するには、WebSphere Integrated Solutions Console で、「サーバー」 > 「サーバー・タイプ」 > 「WebSphere Application Server」 > 「Server1」をクリックします。
  2. 「サーバー・インフラストラクチャー」の下で、「Java およびプロセス管理 (Java and Process Management)」 > 「プロセス定義」をクリックします。
  3. 「追加プロパティー」の下で、「Java 仮想マシン」をクリックします。
  4. 4096「初期ヒープ」に追加します。
  5. 24576「最大ヒープ・サイズ」に加えます。
    ヒント: ここに示す数値は単なる提案です。ご使用環境に合わせて値を設定してください。 標準的な中規模のチームでは、64 ビットのコンピューターで Rational Engineering Lifecycle Manager のプロセスのヒープ・メモリーが 4 GB であるとすると、4096 MB の値を使用できます。 「最大ヒープ・サイズ」の値が小さすぎると、Lifecycle Query Engine に対する Rational Engineering Lifecycle Manager のデータ・ソースは、 既存のバックログ、および製品を作成、修正、または削除するすべての新たな変更の処理を停止する場合があります。

    また、ページングやスワッピングを避けるために、マシン上のすべてのプロセスを同時に実行した場合に必要なメモリー量より多くの物理メモリー量を用意することも重要です。 ページングはシステムのパフォーマンスを低下させ、Java メモリー管理システムのパフォーマンスに影響を与えます。

    Java ヒープ・サイズを増やす際は、その増加分をカバーするのに十分な未使用の物理メモリーがマシン上にあることを確認してください。 使用可能な物理メモリーが十分ない場合は、追加のメモリーをインストールするか、全体的なパフォーマンスに対する影響を考慮してください。

  6. 「汎用 JVM 引数」フィールドに、以下の行を入力します。
    Windows:
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Linux:
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    ヒント: ヒープ・サイズの増加が必要な場合は、以下の設定を使用できます。その場合、{N} は、使用するメモリー量に、{N/8} は総メモリー量の 1/8 に置き換えてください。例えば、-Xmx を 8g に設定した場合は、-Xmn を 1g に設定します。
    -Xgcpolicy:gencon -Xmx{N} -Xms{N} -Xmn{N/8}
    -Xcompressedrefs  -Xgc:preferredHeapBase=0x100000000
  7. 「適用」をクリックして、「マスター構成に直接保管」をクリックします。
  8. 追加する必要があるカスタム・プロパティーの 1 つに JAZZ_HOME があり、これは特定の構成ファイルが検出される場所を指定するシステム・プロパティーです。このプロパティーは、シンプル・パスではなく URL を使用します。したがって、この値はファイル・スタイルの URL (file:///file path) として指定する必要があります。「Java 仮想マシン」 > 「追加プロパティー」で、「カスタム・プロパティー」をクリックします。
    要確認: file: の後に 3 つのスラッシュ (///) を使用する必要があります。
    重要: 分散環境では、Web アプリケーションごとに別々のアプリケーション・サーバーを使用しているときは、WebSphere Application Server のインスタンスごとにこれらのカスタム・プロパティーを追加する必要があります。
  9. 「新規」をクリックし、「名前」フィールドに JAZZ_HOME と入力し、「値」フィールドに file:///JazzInstallDir/server/conf と入力します。JazzInstallDir を Jazz Team Server のインストール・ディレクトリーで置き換えます。例えば、Windows では file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf と入力し、Linux システムでは file:///opt/IBM/JazzTeamServer/server/conf と入力します。
    注: 問題を避けるために、ファイル・パスの中にスペースは使用しないでください。Program Files ディレクトリーには、PROGRA~1 を使用できます。Program Files (x86) ディレクトリーには、PROGRA~2 を使用できます。
  10. 「OK」をクリックします。
  11. ステップ 10 を繰り返し、以下のカスタム・プロパティーを追加します。
    • 名前: java.awt.headless : true
    • 名前: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin : true
    • Oracle データベースに接続する場合、名前: ORACLE_JDBC_DRIVER_FILE : Absolute path to the JDBC driver/ojdbc6.jar
      注: JDBC ドライバーのパスは、絶対パスである必要があります。 URL パス (file:///) は使用しないでください。 Oracle の Java Database Connectivity (JDBC) 接続について詳しくは、Rational Engineering Lifecycle Manager およびライフサイクル照会エンジンのための Oracle データベースのセットアップを参照してください。
    • 名前: log4j.configuration : file:///JazzInstallDir/server/conf/startup_log4j.properties
      注: startup_log4j.properties ファイルに含まれる設定は、開始プロセスの初期段階で、メッセージを WebSphere Application Server SystemOut.log ファイルに受け渡すのに使用されます。初期段階の後、それぞれの Jazz アプリケーションは、JazzInstallDir/server/conf/app context/log4j.properties ファイルにあるアプリケーション固有の設定を使用するように切り替わります。
  12. 「マスター構成に直接保管」をクリックします。
  13. 複数のユーザーに対応できるように、デフォルト・スレッド・プールを増やします。「サーバー」 > 「サーバー・タイプ」 > 「WebSphere Application Servers」 > 「Server1」をクリックします。
  14. 「追加プロパティー」で「スレッド・プール」をクリックします。
  15. 「WebContainer」をクリックし、デフォルトの最大サイズを 50 スレッドから 200 スレッドに増やします。
  16. 「マスター構成に直接保管」をクリックします。
  17. 「サーバー」 > 「サーバー・タイプ」 > 「アプリケーション・サーバー」 > 「Server1」 > 「セッション管理」 > 「カスタム・プロパティー」をクリックします。「カスタム・プロパティー」ページで、「新規」をクリックします。
  18. 「構成」ページで、「名前」フィールドに InvalidateOnUnauthorizedSessionRequestException を入力し、「値」 フィールドに true を入力します。このセッション管理カスタム・プロパティーのデフォルト値は false です。 「OK」または「適用」をクリックします。
  19. コンソール・タスクバーの「保存」をクリックして、構成の変更を保存します。
  20. 変更を有効にするために、アプリケーション・サーバーを再始動します。

次のタスク

サーバーを構成したら、アプリケーション・ファイルをそこにデプロイする必要があります。

  1. WebSphere Application Server 管理コンソールから「アプリケーション」>「新規アプリケーションのインストール」(または「アプリケーション」>「新規アプリケーション」>「新規エンタープライズ・アプリケーション」) を選択します。
  2. 「新規アプリケーションへのパス (Path to new Application)」の下にある「ローカル・ファイル・システム」を選択します。
  3. 「絶対パス」で、[relm_install_dir]/server/webapps/relm.war を入力します。
  4. コンテキスト・ルートを /relm に設定します。
  5. 「次へ」をクリックして、エディターによってプロンプト表示される「新規アプリケーションのインストール (Install New Application)」の残りのステップを引き続き実行します。 「終了」をクリックします。
  6. 上記と同じ手順で「構成管理」アプリケーション (vvc.war) をインストールします。パスを [relm_install_dir]/server/webapps/vvc.war で置き換え、コンテキスト・ルートとして /vvc を使用します。
  7. 上記と同じ手順で SPARQL ゲートウェイ・コンポーネント・アプリケーション SPARQL_Gateway.war をインストールします。 パスに [relm_install_dir]/server/webapps/SPARQL_Gateway.war で置き換え、コンテキスト・ルートとして /SPARQL_Gateway を使用します。
  8. 資料をオンラインで表示するのではなくサーバーにあるものを使用する場合は、relmhelp.war アプリケーションをデプロイすることもできます。
  9. 「マスター構成に直接保管」を選択します。
  10. SPARQL ゲートウェイでは、デフォルトのクラス・ロード順序を変更する必要があります。
    1. 「アプリケーション」>「アプリケーション・タイプ」>「WebSphere エンタープライズ・アプリケーション」を選択し、アプリケーション・リストから SPARQL_Gateway_war を選択します。
    2. 「クラス・ロードおよび更新の検出」をクリックします。
    3. 「クラス・ローダー順序」セクションで、 「最初にローカル・クラス・ローダーをロードしたクラス (親は最後)」を選択します。
    4. 「OK」をクリックして、「マスター構成に保存」をクリックします。
    5. 「モジュールの管理」を選択します。 「SPARQL_Gateway」モジュールを選択します。
    6. 「クラス・ローダー順序」フィールドを見つけ、「最初にローカル・クラス・ローダーをロードしたクラス (親は最後)」を選択します。
    7. 「OK」をクリックして、「マスター構成に保存」をクリックします。
  11. 「エンタープライズ・アプリケーション」ページで、WebSphere Application Server にデプロイしたばかりのアプリケーションを選択し、「開始」を選択します。
注: 本書では、WebSphere 認証または SSL の構成については、複雑なトピックになるので詳細は説明していません。 各種認証および暗号化オプションの詳細情報については、WebSphere Application Server インフォメーション・センターで説明されています。 詳しくは 、WebSphere インフォメーション・センターにアクセスして、「アプリケーションとその環境の保護」というフレーズを検索で使用してください。

フィードバック