バージョン 2 から 3.0.1 への手動アップグレード

このトピックでは、Rational Team Concert™ をバージョン 2 からバージョン 3.0.1 に手動でアップグレードするプロセスについて説明します。

始める前に

サーバーをアップグレードする前に、Rational Team Concert V2 リポジトリー・データベースの、最新の 有効なバックアップがあることを確認してください。

Network Time Protocol (NTP) を使用してすべてのサーバーのクロックが同期されていることを確認してください。時刻は、あるネットワーク・ノード上のイベントを別のネットワーク・ノード上の対応するイベントにマップできるようにするための不可欠な要素です。問題の発生を防ぐため、NTP サービスを企業全体でデプロイすることで、この課題に対応できます。NTP について詳しくは、http://www.ntp.org/ を参照してください。また、すべてのサーバーで使用されるユーザーの認証方式が同一でなければなりません。

Rational Team Concert v2 サーバー用に Derby を使用している場合、リポジトリー・データベースが RTC2.X_install_dir/server/repositoryDB ディレクトリーから 3.0.1CCM_install_dir/server/conf/jazz/derby ディレクトリーにコピーされている。

複数の製品をアップグレードする場合は、アップグレードの順序を参照してどの製品を先にアップグレードするか決めてください。

手順

  1. 必要に応じて、デプロイメントおよびアップグレードの計画のセクションのトピックをご確認ください。
  2. 既存のバージョン 2 の teamserver.properties ファイルでパブリック URL プロパティー com.ibm.team.repository.server.webapp.url を調べます。

    バージョン 3.0.1 では同一のパブリック URL を使用する必要があります。パブリック URL が未設定である場合は、アップグレード前にバージョン 2 管理 Web インターフェース (「拡張プロパティー」) を使用して、修飾ホスト名 URL (https://hostname.example.com:port) を設定してください。

    teamserver.properties のパブリック URL 行は、次のようなものになります。
    com.ibm.team.repository.server.webapp.url=https¥://<hostname.example.com>¥:9443/jazz
  3. バージョン 2 サーバーをシャットダウンします。
  4. Jazz™ Team Server および「変更管理と構成管理 (CCM)」アプリケーションがまだインストールされていなければ、これらを新規の場所にインストールします。Jazz Team Server がインストール済みである場合は、「変更管理と構成管理」アプリケーションをインストールします。
  5. /jazz コンテキスト・ルートを保持するため、インストール時に 「Rational Team Concert 2.x コンテキスト・ルートを使用」を選択します。
  6. インストール終了時に、「どのプログラムを開始しますか?」で「なし」を選択します。
  7. Jazz Team Server に、V2 データベースと同じパラメーターを使用して V2 データベースと異なる名前の別のデータベースを作成します。 データベースの作成について詳しくは、データベースのセットアップを参照してください。
    注: CCM データベースとは別の Jazz Team Server データベースが必要です。 新規 Jazz Team Server データベースをまだ作成していない場合は、作成してください。
    重要: バージョン 2 およびバージョン 3 の repotools コマンドを実行するため、個別のコマンド行ウィンドウを開いてください。 バージョン 2 のコマンドとバージョン 3 のコマンドが使用する環境変数の間に矛盾がないようにするために、個別のコマンド行ウィンドウを使用します。
  8. <3.0.1CCM_install_dir>/server にナビゲートし、次のコマンドを実行して、Jazz と Tomcat の構成ファイル (フレンドも含めて) をマージします。
    repotools-jazz -migration_ccm_updateConfigurationFiles oldApplicationHome=<2.x_install_dir>/server/conf
    デフォルトでは、-migration_ccm_updateConfigurationFiles コマンドにより、Jazz 構成ファイルと Tomcat 構成ファイルの両方が更新されます。Tomcat がインストールされておらず、Jazz 構成ファイルのみを更新する場合は、updateTomcatFiles=false パラメーターを指定する必要があります。
    -migration_ccm_updateConfigurationFiles コマンドにより、次のタスクが完了します。
    • Jazz 構成ファイル:
      • teamserver.properties (1 つの Rational Team Concert ファイルを、チーム・サーバー用とアプリケーション用の 2 つの ファイルにマージ)
      • friendsconfig.rdf (1 つの Rational Team Concert ファイルを、1 つのアプリケーション・ファイルにコピー)
    • Tomcat ファイル:
      • tomcat-users.xml (コピー)
        要確認: Tomcat ユーザー・データベースの場合のみ。tomcat-users.xml ファイルはコピーされます (既存のファイルにマージされません)。共通の JTS と共に複数の CLM アプリケーションをアップグレードしている場合は、ユーザーおよびグループの情報を tomcat-users.xml ファイルに手動でマージする必要があります。ユーザーが異なるアプリケーションの異なるグループに属している場合、ユーザーおよびグループの情報は異なります。例えば、userA が CCM では JazzAdmins 役割を持ち、QM では JazzUsers 役割を持つことがあります。さらに、一方のアプリケーションでは何人かのユーザーが存在し、もう一方のアプリケーションには存在しない場合 (あるいはその逆)、それらのユーザーを手動で tomcat-users.xml ファイルに追加する必要があります。
      • server.xml (マージ)
      • 内部アプリケーション WAR ファイルを含む web.xml ファイル (1 つの Rational Team Concert ファイルを、チーム・サーバー用とアプリケーション用の 2 つの ファイルにマージ)
    重要: Rational Team Concert バージョン 2 の中の他のファイル (log4j.properties ファイルなど) を変更した可能性があります。これらのファイルは、手動でマージする必要があります。

    repotools コマンドについて詳しくは、-migration_ccm_updateConfigurationFiles を参照してください。

    要確認: 次の例では、teamserver.properties の場所は、 デフォルトのインストールに基づきます。デプロイメントでファイルのレイアウトを変更した場合は、 正しい場所を使用していることを確認してください。また、次のステップでは、デプロイメントは 1 つのサーバーで行われたものと想定しています。デフォルトで、newJTSHome パラメーター値は、newApplicationHome から派生します。CCM と Jazz Team Server 用に別々のサーバーを使用している場合は、newJTSHome パラメーターを指定して、Jazz Team Server の場所を指す必要があります。これにより、LDAP、E メール、およびデータベース・ロケーションのプロパティーが Rational Team Concert バージョン 2 の teamserver.properties ファイルからマージされます。 また、tomcat 構成ファイルが Jazz Team Server の場所にコピーされます。
  9. 更新されたプロパティー・ファイルに以下の情報が含まれていることを確認してください。
    • プロパティーのコピー元はバージョン 2 の teamserver.properties ファイルです。
    • 有効なデータベース・ベンダー・エントリー (/conf/jts/teamserver.properties に指定されたデータベースが存在することを確認します) 詳しくは、アップグレード中の構成ファイルの確認を参照してください。
    • friendsconfig.rdf が <RTC2.X_install_dir>/server/conf/jazz から<3.0.1CCM_install_dir>/server/conf/jazz にコピーされていることを確認します。
    • tomcat-users.xml がコピーされたことを確認します。
    • バージョン 3 の server.xml ファイルを開き、バージョン 2 からの情報 (ポート番号、LDAP 設定、およびその他の変更) が含まれていることを確認します。
    • バージョン 3 の web.xml ファイルを開き、バージョン 2 からの情報 (LDAP 設定およびその他の変更) が含まれていることを確認します。
    • 有効な別個のパブリック URL com.ibm.team.repository.server.webapp.url が teamserver.properties ファイルに存在することを確認します。(CCM アプリケーションの URL は、Rational Team Concert バージョン 2 で使用された URL と同じでなければなりません。)
  10. コマンド・ウィンドウを開き、<3.0.1CCM_install_dir>/server ディレクトリーに移動します。
  11. 以下のコマンドを実行して、データベースに表を追加します。
    repotools-jazz -addTables
  12. 次のコマンドを実行して、Rational Team Concert データベースからユーザー情報をエクスポートします。
    repotools-jazz -migration_exportJTSData toFile=jtsData.tar
    注: この処理を複数回行う場合は、2 番目の tar ファイルにはエクスポートした対応するファイル名を使用します。例えば、jtsData2.tar を使用します。
  13. Jazz Team Server がインストールされているマシンで、以下のコマンドを実行して、Jazz Team Server データベースにユーザー情報をインポートします。
    注: デフォルトの Derby データベースを使用していない場合は 、conf/jts/teamserver.properties ファイルで参照される Jazz Team Server データベースが新規のデータベースであり、 これが存在することを確認してください。
    repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=rtc-mapping.txt createTables
    注: この処理を複数回行う場合は、2 番目の tar ファイルにはエクスポートした対応するファイル名を使用します。例えば、jtsData2.tar を使用します。
    重要: Jazz Team Server データを CCM アプリケーションの 2 番目のインストールからインポートする場合、createTables パラメーターを使用しないでください。 CLM アプリケーションが既に Jazz Team Server にインストールされているときに createTables パラメーターを使用すると、サーバーのユーザー・データが失われます。
  14. 次のコマンドを実行して、Jazz Team Server ユーザー情報を Rational Team Concert データベースにインポートします。
    repotools-jazz -migration_importUserMapping fromMappingFile=rtc-mapping.txt 
  15. 次のコマンドを実行して、テキスト索引を再ビルドします。
    repotools-jazz -rebuildTextIndices
  16. 以下のコマンドを実行して、Lucene 索引と RDF 索引を再ビルドします。
    repotools-jazz -reindex
  17. バージョン 2 製品にデフォルト以外の索引ロケーションがあり、引き続き、カスタマイズしたロケーションを索引用に使用する場合は、バージョン 3.0.1 の teamserver.properties ファイルを変更して、索引ロケーションを追加する必要があります。
    1. com.ibm.team.fulltext.indexLocation=conf/jts/indices/workitemindex の値を、全文検索索引の絶対パス・ロケーションに変更します。例えば、com.ibm.team.fulltext.indexLocation=c:/indices/workitemindex。
    2. com.ibm.team.jfs.index.root.directory=indices の値を、JFS 索引ルート・ディレクトリーの絶対パス・ロケーションに変更します。例えば、com.ibm.team.jfs.index.root.directory=c:/indices。
  18. 以下のことを確認してください。
    • Jazz Team Server データベース・ロケーションがアプリケーション・データベース・ロケーションと異なることを確認します。
    • 索引またはその他のファイルに関連するプロパティーが、アプリケーションと Jazz Team Server の間で共有されていないことを確認します。
    • friendconfig.rdf ファイルが friendconfig.rdf.saved に名前変更済みであることを確認します。
  19. Apache Tomcat を使用している場合は、Apache Tomcat のセットアップを参照してください。
  20. WebSphere Application Server を使用している場合は、以前にインストールした Web アプリケーションをアンインストールし、3.0.1 インストールで提供される jts.war、ccm.war、および clmhelp.war を再デプロイします。 詳しくは、バージョン 3 アップグレードのための WebSphere Application Server のセットアップを参照してください。
  21. インストールしたサーバーおよび CLM アプリケーションを構成します。

    Jazz Team Server を「変更管理と構成管理」アプリケーションまたは他のいずれかの CLM アプリケーションと共にアップグレードする場合は、サーバー・セットアップ・ウィザードを実行してください。(セットアップ・ウィザードの実行を参照してください。) 設定済みの Jazz Team Server に「変更管理と構成管理」アプリケーションを追加する場合は、管理 Web インターフェースを使用してください。(Jazz Team Server へのアプリケーションの登録を参照してください。)

    注: Rational Team Concert のアップグレードに関する jazz.net ライブラリーの最新のエントリー
親トピック: Rational Team Concert のアップグレード
関連概念:
データベースのセットアップ
関連タスク:
アップグレード中の構成ファイルの確認

フィードバック