3.0 から 3.0.1 への手動アップグレード

このトピックでは、リポジトリー・ツールを使用して Rational Team Concert をバージョン 3.0 からバージョン 3.0.1 に手動でアップグレードする手順を説明します。

始める前に

サーバーをアップグレードする前に、Rational Team Concert および Jazz Team Server v3.0 のリポジトリー・データベースの完全に最新の有効なバックアップが作成されていることを確認してください。

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

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

Derby データベースを使用している場合は、JTS および CCM データベースを 3.0 から 3.0.1 にコピーします。詳しくは、Derby データベースのバックアップおよびリストアを参照してください。
注: 同一のデータベースを使用している場合は、データ・マイグレーションは不要です。ただし、アップグレード中にデータベースを切り替える場合は、以前のデータベースからデータをエクスポートして、それを新規データベースにインポートする必要があります。

Jazz Team Server (JTS) のアップグレード

  1. 必要に応じて、デプロイメントおよびアップグレードの計画のセクションのトピックをご確認ください。
  2. JTS 3.0 サーバーをシャットダウンします。
  3. CLM インストールの一環として Jazz Team Server がまだインストールされていなければ、Jazz Team Server をディスク上の新規のロケーションにインストールします。Jazz Team Server が既にインストール済みで、バージョン 3.0.1 にアップグレード済みであり、「変更管理と構成管理」アプリケーションをインストールしてアップグレードする場合は、変更管理と構成管理 (CCM) のアップグレードに進んでください。
  4. インストール時に、「デフォルト 3.x アプリケーション・コンテキスト・ルートを使用する (Use default 3.x application context roots)」を選択します。
  5. インストール終了時に、「どのプログラムを開始しますか?」で「なし」を選択します。
  6. <3.0.1JTS_install_dir>/server にナビゲートして以下のコマンドを実行します。

    WebSphere Application Server を使用している場合は、コマンドに updateTomcatFiles=no パラメーターを指定します。このコマンドに使用できるすべてのパラメーターについては、-migration_jts_updateConfigurationFilesを参照してください。

    repotools-jts -migration_jts_updateConfigurationFiles oldJTSHome=<3.0JTS_install_dir>/server/conf 

    コマンドにより実行されるタスクを以下に示します。

    • V3.0 ファイルの情報に基づいて、V3.0.1 teamserver.properties ファイルを更新します。
    • Tomcat ユーザーの xml ファイルの内容をコピーします。
      要確認: Tomcat ユーザー・データベースの場合のみ。tomcat-users.xml ファイルはコピーされます (既存のファイルにマージされません)。共通の JTS と共に複数の CLM アプリケーションをアップグレードしている場合は、ユーザーおよびグループの情報を tomcat-users.xml ファイルに手動でマージする必要があります。ユーザーが異なるアプリケーションの異なるグループに属している場合、ユーザーおよびグループの情報は異なります。例えば、userA が CCM では JazzAdmins 役割を持ち、QM では JazzUsers 役割を持つことがあります。 さらに、一方のアプリケーションでは何人かのユーザーが存在し、もう一方のアプリケーションには存在しない場合 (あるいはその逆)、それらのユーザーを手動で tomcat-users.xml ファイルに追加する必要があります。
    • V3.0 の server.xml ファイルと web.xml ファイルの内容を、バージョン 3.0.1 とマージします。
  7. <3.0.1JTS_install_dir>/server にナビゲートし、次のコマンドを実行して JTS のデータベース表を作成してください。
    repotools-jts -addTables
  8. Apache Tomcat を使用している場合は、Apache Tomcat のセットアップを参照してください。
  9. WebSphere Application Server を使用している場合は、以前にインストールした Web アプリケーションをアンインストールし、3.0.1 インストールで提供される jts.war、admin.war、および clmhelp.war を再デプロイします。 詳しくは、バージョン 3 アップグレードのための WebSphere Application Server のセットアップを参照してください。
  10. JTS サーバーを開始します。
  11. セットアップ・ウィザードの実行を継続して、サーバーを構成します。

変更管理と構成管理 (CCM) のアップグレード

  1. 必要に応じて、デプロイメントおよびアップグレードの計画のセクションのトピックをご確認ください。
  2. CCM 3.0 サーバーをシャットダウンします。
  3. CCM アプリケーションをディスク上の新規の場所にインストールします。
  4. インストール時に、「デフォルト 3.x アプリケーション・コンテキスト・ルートを使用する (Use default 3.x application context roots)」を選択します。
    重要: Rational Team Concert をバージョン 2 からバージョン 3.0 にアップグレードした場合は、/jazz コンテキスト・ルートを維持するため、「Rational Team Concert 2.x コンテキスト・ルートを使用」を選択します。
  5. インストール終了時に、「どのプログラムを開始しますか?」で「なし」を選択します。
  6. <3.0.1CCM_install_dir>/server にナビゲートして以下のコマンドを実行します。

    WebSphere Application Server を使用している場合は、コマンドに updateTomcatFiles=no パラメーターを指定します。このコマンドに使用できるすべてのパラメーターについては、-migration_ccm_updateConfigurationFilesを参照してください。

    注: デフォルトの applicationContextRoot は jazz です。 バージョン 3 からアップグレードしている場合は、applicationContextRoot パラメーターを指定し、それを ccm に設定します。
    repotools-ccm -migration_ccm_updateConfigurationFiles oldApplicationHome=<3.0CCM_install_dir>/server/conf applicationContextRoot=ccm

    コマンドにより実行されるタスクを以下に示します。

    • v3.0 ファイルの情報に基づいて、v3.0.1 アプリケーションの teamserver.properties ファイルを更新します。
    • tomcat-users.xml ファイルの内容をコピーします。
      要確認: Tomcat ユーザー・データベースの場合のみ。tomcat-users.xml ファイルはコピーされます (既存のファイルにマージされません)。 共通の JTS と共に複数の CLM アプリケーションをアップグレードしている場合は、ユーザーおよびグループの情報を tomcat-users.xml ファイルに手動でマージする必要があります。ユーザーが異なるアプリケーションの異なるグループに属している場合、ユーザーおよびグループの情報は異なります。例えば、userA が CCM では JazzAdmins 役割を持ち、QM では JazzUsers 役割を持つことがあります。 さらに、一方のアプリケーションでは何人かのユーザーが存在し、もう一方のアプリケーションには存在しない場合 (あるいはその逆)、それらのユーザーを手動で tomcat-users.xml ファイルに追加する必要があります。
    • v3.0 の server.xml ファイルと web.xml ファイルの内容を、バージョン 3.0.1 とマージします。
  7. <3.0.1CCM_install_dir>/server にナビゲートし、次のコマンドを実行して CCM のデータベース表を作成します。
    repotools-ccm -addTables 
  8. Apache Tomcat を使用している場合は、Apache Tomcat のセットアップを参照してください。
  9. IBM WebSphere Application Server を使用している場合は、以前にインストールした Web アプリケーションをアンインストールし、3.0.1 インストールで提供される ccm.war を再デプロイします。 詳しくは、バージョン 3 アップグレードのための WebSphere Application Server のセットアップを参照してください。
  10. CCM サーバーを開始します。
  11. 設定済みの Jazz Team Server に「変更管理と構成管理」を追加する場合は、管理 Web インターフェースをご使用ください。Jazz Team Server へのアプリケーションの登録を参照してください。
注: Rational Team Concert のアップグレードに関する jazz.net ライブラリーの最新のエントリー
親トピック: Rational Team Concert のアップグレード

フィードバック