完全分散エンタープライズ・トポロジーへのアップグレード

このトピックで説明する手順を使用すると、Rational Team Concert™ のインストール済み環境を、新しい分散 CCM および JTS アプリケーションが組み込まれた v3.0.1 へとアップグレードすることができます。

始める前に

重要: すべてのマシンのクロックが Network Time Protocol (NTP) を使用して同期されるようにしてください。時刻は、あるネットワーク・ノード上のイベントを別のネットワーク・ノード上の対応するイベントにマップできるようにするための不可欠な要素です。 問題の発生を防ぐため、NTP サービスを企業全体でデプロイすることで、この課題に対応できます。NTP について詳しくは、http://www.ntp.org/を参照してください。
注: ここに示す例は、Jazz Team Server および変更管理と構成管理用です。品質管理アプリケーションに対しても同じ手順を使用できます。

完全分散の Rational Team Concert 3.0.1 エンタープライズ・トポロジーの例については、完全分散 Rational Team Concert 2.0 から 3.0.1 へのエンタープライズ・トポロジー例のトピックを参照してください。

JTS アプリケーションを別のサーバーに分散する際は、JTS をデプロイする 2 番目のサーバーが同じオペレーティング・システムおよびアプリケーション・サーバーの構成を使用するようにしてください。 同じオペレーティング・システムとアプリケーション・サーバーを使用すると、ファイルのマイグレーションの複雑さが軽減されます。

両方のサーバーで使用されるユーザーの認証方式とユーザー・レルムが同じであることを確認します。

シングル・サインオンでのデプロイを確認して検討します。WebSphere を使用している場合は、これによりマルチサーバー環境での認証が容易になります。

v3.0.1 のインストールの最後の「どのプログラムを開始しますか?」で「なし」を選択します。JTS セットアップ・ウィザードは、ファイルとリポジトリーのマイグレーションが完了してから実行する必要があります。

親トピック: Rational Team Concert のアップグレード

構成ファイルの準備

手順

  1. マシン A (アップグレード対象の RTC 2.x サーバーがインストールされているマシン) に、v3.0.1 の変更管理と構成管理アプリケーションをインストールします。このとき、Jazz Team Server (JTS) および RTC 評価版ライセンスはインストールしません。
    注: コンテキスト・ルート・パネルで、「Rational Team Concert 2.x コンテキスト・ルートを使用」を選択していることを確認します。
  2. マシン B で、共有 JTS となるサーバーに v3.0.1 Jazz Team Server (JTS) アプリケーションと RTC 評価版ライセンスをインストールします。このとき、変更管理と構成管理はインストールしません。
    注: コンテキスト・ルート・パネルで、「Rational Team Concert 2.x コンテキスト・ルートを使用」を選択していることを確認します。
  3. マシン A で、新しいコマンド・ウィンドウを開き、3.0.1_install_dir/server にナビゲートします。
  4. 次のコマンドを実行して、Jazz の構成ファイルと Tomcat の構成ファイルをマージします。
    repotools-jazz -migration_ccm_updateConfigurationFiles oldJazzHome=2.x_install_dir/server/conf
    注: デフォルトでは、-migration_ccm_updateConfigurationFiles コマンドにより、Jazz 構成ファイルと Tomcat 構成ファイルの両方が更新されます。Tomcat がインストールされておらず、Jazz 構成ファイルのみを更新する場合は、updateType=JAZZ パラメーターを指定する必要があります。
    repotools-jazz -migration_ccm_updateConfigurationFiles oldJazzHome=2.x_install_dir/server/conf updateType=JAZZ
  5. マシン A で、3.0.1_install_dir/server/conf/jazz に移動し、RTC の teamserver.properties ファイルの内容を確認します。 データベース接続とパブリック URL の項目に特に注意し、マシン A のホスト名に関して適切であることを確認します。
    注意:
    jazz と JTS の teamserver.properties ファイルの両方のデータベース接続とパブリック URL の項目に特に注意して、マージされたファイルの内容を確認することが重要です。jazz (RTC/CCM) の teamserver.properties はマシン A の 3.0.1_install_dir/server/conf/jazz 内に、編集して移動する JTS の teamserver.properties はマシン A の 3.0.1_install_dir/server/jts-migration/conf/jts 内にあります。

    いずれの teamserver.properties ファイルも、それらが置かれる正しいサーバーのホスト名に合わせて (必要であれば) 編集および更新することが重要です。

    詳細および検証ポイントの例については、『Rational Team Concert のアップグレード』にある『構成ファイルの準備』のステップ 3 から 6 を参照してください。

  6. マシン A で JTS teamserver.properties を編集した後で、マシン B の 3.0.1_install_dir/server/conf/jts にコピーします。 置き換える前に、既存の teamserver.properties ファイルをバックアップします。
  7. Tomcat でデプロイする場合は、マシン A から 3.0.1_install_dir/tomcat/conf/tomcat-users.xml ファイルと 3.0.1_install_dir/tomcat/conf/server.xml ファイルをマシン B の 3.0.1_install_dir/tomcat/conf フォルダーにコピーする必要があります。置き換える前に、既存のファイルのバックアップコピーを作成します。
  8. Tomcat でデプロイして LDAP を使用する場合は、次のタスクを実行して、編集された web.xml ファイルを使用して JTS をデプロイする必要があります。
    1. マシン B で、server.startup を使用して JTS サーバーを開始し、 JTS.war ファイルを抽出します。
    2. マシン B で、server.shutdown コマンドを使用して JTS サーバーを停止します。
    3. マシン B で、3.0.1_install_dir/server/tomcat/webapps/jts/WEB-INF/web.xml をバックアップし、サーバー A からの web.xml に相当するファイルのコピーで置き換えます。

タスクの結果

これで、構成ファイルのマイグレーションが完了しました。

リポジトリー・データベースのマイグレーション

このセクションでは、分散 JTS アプリケーションに対してリポジトリー・データベースのマイグレーションを行うために必要な手順について説明します。

始める前に

リポジトリー・データベースのマイグレーションを進める前に、以下のタスクが完了していることを確認してください。
  • 既存の RTC 2.x データベースの完全なオフライン・バックアップが作成されている。
  • 構成ファイルがマイグレーション済みで所定の場所にある (teamserver.properties、friendsconfig.rdf、tomcat-users.xml、server.xml、web.xml)。 詳しくは、アップグレード中の構成ファイルの確認を参照してください。
  • JTS リポジトリー・データベースが作成されている。詳しくは、データベースのセットアップを参照してください。
  • Rational Team Concert v2.x サーバーがシャットダウンされている。
  • Rational Team Concert v2.x サーバーに Derby を使用している場合は、リポジトリー DB が 2.x_install_dir/server/repositoryDB から 3.0.1_install_dir/server ディレクトリーにコピーされていることを確認する。
  • WebSphere Application Server のマイグレーションの場合:
    • RTC 2.x サーバーがシャットダウンされていることを確認します。
    • jazz.war アプリケーションを停止して、アンインストールします。
    • 新しいインストール・パス (3.0.1_install_dir/server/conf) に一致するように JAZZ_HOME プロパティーを変更します。
    • 必要であれば、Oracle または SQL Server の JDBC ドライバー・プロパティーを変更します。 WebSphere Application Server のセットアップを参照してください。
    • 必要であれば、オプションでメモリー設定を調整します。WebSphere Application Server のセットアップを参照してください。
    • WebSphere Application Server を停止して再始動します。

手順

  1. マシン A で、コマンド・ウィンドウを開き、3.0.1_install_dir/server ディレクトリーに移動します。
  2. 以下のコマンドを実行して、データベースに表を追加します。
    repotools-jazz -addTables
  3. 次のコマンドを実行して、RTC データベースからユーザー情報をエクスポートします。
    repotools-jazz -migration_exportJTSData toFile=jtsData.tar
  4. マシン A で、今作成した jtsData.jar ファイルをコピーして、マシン B の 3.0.1_install_dir/server ディレクトリーに置きます。
  5. マシン B で、次のコマンドを実行して、ユーザー情報を JTS データベースにインポートします。
    重要: デフォルトの Derby データベースを使用していない場合は、必ず conf/jts/teamserver.properties で参照される JTS データベースが作成済みで、存在していることを確認してください。
    repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=rtc-mapping.txt createTables
  6. マシン B で、今作成した rtc-mapping.txt ファイルをコピーして、マシン A の RTC3.0.1_install_dir/server ディレクトリーに置きます。
  7. マシン A で、次のコマンドを実行して、JTS のユーザー情報を RTC データベースにインポートします。
    repotools-jazz -migration_importUserMapping fromMappingFile=rtc-mapping.txt

事後マイグレーション・リポジトリー・ツール・コマンド

手順

マシン A で、次のコマンドを実行して、索引を再ビルドします。

repotools-jazz -rebuildTextIndices

repotools-jazz -reindex

タスクの結果

これで、リポジトリー・データベースのマイグレーションが完了しました。

事後マイグレーション・セットアップ

このタスクについて

RTC サーバーのマイグレーションと JTS アプリケーションの配布の事後マイグレーションの手順は、単一サーバー環境でのマイグレーションについて説明した手順と同じですが、次のタスクも行う必要があります。

手順

Jazz Team Server のセットアップ・ウィザードの起動中に、CCM アプリケーションは、分散環境が原因で自動的に認識および事前入力されません。CCM アプリケーションが Jazz Team Server のセットアップ中に自動的に認識されない場合は、セットアップ・ウィザードの実行の手順 9c を参照してください。

フィードバック