このトピックでは、WebSphere® Application
Server と連動するように Jazz™ Team Server をセットアップする方法について説明します。
このセットアップでは、Websphere Application Server と同じマシンに Jazz Team Server をインストールしていることを前提とします。
始める前に
これらのステップを実行する前に、以下の作業が完了している必要があります。
- WebSphere Application サーバーが既にインストールされている。
- データベースを作成し、データベース設定で teamserver.properties ファイルを更新する。
- 大/小文字を区別しないログインの使用可能化 (オプション): アプリケーション・サーバーの認証方式で
大/小文字を区別しないログインを許可する場合、Jazz アプリケーションでも受け入れるようにすることができます。
大/小文字を区別しないログインの許可は、管理 Web UI の「拡張プロパティー」ページにある
「大/小文字を区別しないユーザー ID マッチングの使用」プロパティーによって有効にできます。
デフォルトは変更されていません。管理者は、大/小文字を区別しないログインを可能にするように、
明示的にこのプロパティーをオーバーライドする必要があります。
- Java™ 2 セキュリティー・オプションはオフにする必要があります。WebSphere Application Server でこのオプションがオンになっていると、Jazz Team Server .war を開始できません。
- 必ず、WAS のセキュリティー設定「無保護の URI にアクセスがあったときは、使用可能な認証データを使用する (Use available authentication data when an unprotected URI is accessed)」にチェック・マークを付けます。
WAS Integrated Solutions Console を使用している場合は、以下のようにしてこの設定を行います。
- 「セキュリティー」->「管理、アプリケーション、およびインフラストラクチャーの保護 (Secure administration, applications, and infrastructure)」->「Web セキュリティー - 一般設定 (Web Security - General Settings)」とナビゲートします。
- 「無保護の URI にアクセスがあったときは、使用可能な認証データを使用する (Use available authentication data when an unprotected URI is accessed)」のチェック・ボックスを選択します。
- Jazz Team Server には、完全な Apache Tomcat ベース・サーバーを実行するために必要なファイルが含まれています。WebSphere のインストールでは、Jazz Team Server ファイルのサブセットのみが必要であり、これらのファイルを WebSphere サーバー・マシン上のディレクトリーに入れる必要があります。詳細な手順では、これを Jazz Team Server インストール・ディレクトリー、または略して JazzInstallDir と呼びます。このディレクトリーから、以下の項目を使用します。
- ファイル JazzInstallDir/server/tomcat/webapps/jazz.war。
- ディレクトリー JazzInstallDir/server/update-site。
- ディレクトリー JazzInstallDir/server/conf。
- JazzInstallDir/repositoryDB 内のデフォルトのリポジトリー・データベース。
- JazzInstallDir/repotools 内のリポジトリー・ツール。
- ディレクトリー JazzInstallDirserver/license-update-site。
- ディレクトリー JazzInstallDir/server/nl1-update-site。
- ディレクトリー JazzInstallDir/server/nl2-update-site。
ヒント: IBM® Installation Manager を使用する場合は、Jazz Team Server ファイルを Web アプリケーション・ディレクトリーにインストールできます。インストール・プロセス中に、組み込みの Apache Tomcat アプリケーション・サーバーをインストールすることはできません。これによって、Installation Manager は、Web アプリケーション・ディレクトリーを入力するよう要求し、WebSphere に必要なファイルのみをインストールします。 デフォルト・ディレクトリーは、Windows® では C:¥Program Files¥IBM¥JazzTeamServer で、Linux® では /opt/IBM/JazzTeamServer です。
インストール・ディレクトリーは、この手順では JazzInstallDir と呼ばれます。IBM Installation Manager を使用してファイルを WebSphere Application Server Web アプリケーション・ディレクトリーにインストールする場合は、上述したようにファイルを手動で移動する必要はありません。
このタスクについて
注: この資料では、複雑なトピックである WebSphere 認証または SSL の構成については説明しません。WebSphere のさまざまな認証と暗号化オプションの詳細については、WebSphere インフォメーション・センターで説明されています。詳細については、
WebSphere インフォメーション・センターにアクセスして、
アプリケーションとその環境の保護を検索してください。Jazz Web UI では、許可を実行してアプリケーションを個別設定するためには、認証が構成されている必要があります。
- teamserver.properties ファイル内のデータベースの場所を確認して更新します。
com.ibm.team.repository.db.vendor = DB2
com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin
注: これは DB2 のサンプル構成です。
teamserver.properties は、データベース・ベンダーに応じて更新してください (Oracle/MS-SQL)。
- WebSphere Application Server レベルを確認または更新します。
Jazz Team Server には、IBM Java SDK 1.5 SR5 以降の累積フィックスが適用された WebSphere Application Server バージョン 6.1、または少なくとも 7.0.0.3 がインストールされた WebSphere Application Server バージョン 7.0 が必要です。
IBM Java SDK 1.5 SR6 SDK の更新は、http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492 から入手可能です。 WebSphere 6.1 と GA IBM Java SDK を使用して、Jazz
は、いくつかの操作後に「プロキシー・エラー」の報告を開始します。
IBM Rational Team Concert™ 2.0 が正常に稼働するために必要な IBM Java SDK 1.5 SR9 または IBM Java SDK 1.6 SR4 に対するフィックスに対応した WebSphere Application Server の暫定修正を入手する必要があります。
そうしないと、サーバーの一部のサービスが正常に開始されない可能性があります。
暫定修正は、それらに対応する WebSphere Application Server の APAR の中で入手可能です。
IBM Java SDK 1.5/WebSphere Application Server 6.1 の場合、APAR は PK85942 です。ファイルは、ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/からダウンロードできます。
JRE の暫定修正をインストールする前に、少なくとも WebSphere Application Server 6.1 フィックスパック 19 をインストールしてください。
IBM Java SDK 1.6/WebSphere Application Server 7.0 の場合、APAR は PK 86771 です。ファイルは、ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/からダウンロードできます。
- JVM 引数を更新します。
Jazz Team Server では、実行される Java 仮想マシンで固有の設定を行う必要があります。
まず、いくつかの構成ファイルがある場所を認識させる必要があります。
これは、システム・プロパティー JAZZ_HOME を設定することで行います。
このプロパティーには単なるパスではなく、URL を使用します。したがって、値は file:// スタイルの URL として指定する必要があります。
Jazz JVM で必要な 2 番目のプロパティーでは、-Xmx 設定を使用してデフォルトの最大メモリー割り振りを超えるメモリーを提供します。これは、サーバーでサポートされるチームのサイズ、およびJazz Team Server が実行されているサーバーのメモリー容量に基づいて設定する必要があります。標準の中規模チームでは、値 -Xmx1536M を使用して、
Jazz Team Server プロセスに 1536 MB のヒープ・メモリーを提供できます。
Oracle データベースまたは SQL Server データベースに接続する場合は、「ORACLE_JDBC」または「SQLSERVER_JDBC」という名前のプロパティーを追加する必要があります。
プロパティーを、該当する JDBC ドライバーの絶対ファイル・パス (URL ではありません) に設定します。
サーバーの動作を制御するために設定する必要があるその他のシステム・プロパティーがいくつかあります。そのようなプロパティーは以下に記載されています。以下に、WebSphere 管理コンソールにおけるこれらの JVM プロパティーの固有の詳細を示します。JazzInstallDir はご使用の Jazz Team Server インストール・ディレクトリーに置き換えてください。
- をクリックします。
- 「server1」をクリックします。
- をクリックします。
- 「Java 仮想マシン (Java Virtual Machine)」をクリックします。
- 値 100 を「初期ヒープ」に追加します。
- 値 1000 を「最大ヒープ・サイズ (Maximum Heap Size)」に追加します。
- 「適用」をクリックします。
- 「ロギングおよびトレース」をクリックします。 「ログ詳細レベルの変更」をクリックします。 Jazz Team Server は、Birt レポート・エンジンを使用します。BIRT 通知項目が WebSphere ログ・ファイルに書き込まれるないようにするために、org.eclipse.birt.* パッケージに対して、ロギング・レベルを 「重大」に設定します。
「適用」をクリックします。
- 「カスタム・プロパティー (Custom Properties)」をクリックします。
- 次のプロパティーを追加します。 「新規」をクリックして、次のように「名前」と「値」に入力してから、「OK」をクリックします。
- 名前: java.awt.headless 値: true
- 名前: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin 値:
true
- 名前: JAZZ_HOME 値: file:///JazzInstallDir/server/conf
- 「保存」をクリックして、マスター構成に直接保存します。
- Websphere を再始動して、Jazz アプリケーションをインストールします。
次のコマンド行の例では、
WASInstallDir は、WebSphere Application Server がインストールされているサーバー上の場所を表しています。
- WebSphere Application Server の管理コンソールを開きます。
- をクリックします。
- 「新規アプリケーションへのパス (Path to new Application)」の下にある「ローカル・ファイル・システム (Local file system)」をクリックします。
- 「絶対パス (Full path)」に次のように入力します。
JazzInstallDir/server/jazz.war
- 「コンテキスト・ルート (Context Root)」を /jazz に設定します。
- 「次へ」をクリックして、「新規アプリケーションのインストール (Install New Application)」の残りのステップを続行します。
- 「終了」をクリックします。
- 「保存」をクリックして、マスター構成に直接保存します。
- をクリックします。
- jazz_war の横にあるボックスを選択して、「開始」をクリックします。
アプリケーションが正常に開始されたことを示す緑の矢印が表示されます。