ClearQuest Synchronizer のアップグレード

このトピックでは、ClearQuest® Synchronizer を以前のリリースから最新リリースにアップグレードするために必要なステップについて説明します。

手順

  1. 外部リポジトリー接続の発信同期を使用不可に設定します。Rational Team Concert™ Client for Eclipse IDE で、「同期規則」ビューを表示します。外部リポジトリー接続ノードを展開します。外部リポジトリー接続をダブルクリックして開きます。「自動発信同期を使用不可にする」を選択してください。「OK」をクリックします。
  2. Jazz™ Team Server の発信同期を使用不可に設定します。 Web クライアントの管理ページで、「拡張プロパティー」をクリックします。「項目相互協調処理」コンポーネントまでスクロールします。 「com.ibm.team.interop.service.internal.InteropService」で、「編集」をクリックします。「発信同期使用可能」のドロップダウン・リストから「false」を選択してください。「保存」をクリックします。
  3. ClearQuest Gateway を停止します。
  4. Jazz Team Server を停止します。
  5. サーバーをアップグレードします。バージョン 2 からのアップグレード (2 ステップ・プロセス)またはバージョン 4.0 へのアップグレードを参照してください。
  6. サーバーを始動し、以下の点を検証してください。
    • ClearQuest Connector が使用する Jazz ユーザー・アカウントでログインが可能で、プロジェクト・エリアに接続できる。
    • 外部リポジトリー接続が存在する。「同期規則」ビューを参照してください。
    • 同期規則が存在する。「同期規則」ビューを参照してください。
    • 以前に作成し、ClearQuest レコードと同期化したワークアイテムが存在する。
    • Jazz Team Server は、発信同期を使用不可に設定したままである。
  7. ClearQuest Synchronizer の新しいバージョンをインストールします。 IBM Installation Manager の使用による Rational Team Concert ClearQuest Synchronizer のインストールを参照してください。
    注: バージョン 3.X からアップグレードしている場合は、Installation Manager の「更新」オプションを使用できます。バージョン 2.X からアップグレードしている場合は、「インストール」オプションを選択してから、2.X バージョンをアンインストールする必要があります (ステップ 17 を参照)。バージョン 3.0 で開始した場合は、デフォルトのインストール・ディレクトリーは、「ClearQuest Connector」ではなく「ClearQuest Synchronizer」となっています。
  8. install-directory/ClearQuest Synchronizer/gateway ディレクトリーにナビゲートし、ClearQuest Gateway を始動します。
  9. ClearQuest Gateway を停止します。 ClearQuest Gateway を始動して停止すると、install-directory/ClearQuest Synchronizer/gateway/tomcat/webapps/cqconnector ディレクトリーが作成されます。
  10. バージョン 2.X からアップグレードしている場合は、変更を加えたユーザー構成可能ファイルをすべて ClearQuest Connector 2.0.0.2x のインストール・ディレクトリーから ClearQuest Synchronizer のインストール・ディレクトリーにコピーします。具体的には、以下のファイルをコピーします。
    • cqconnector.properties を install-directory/ClearQuestConnector/gateway から install-directory/ClearQuestSynchronizer/gateway にコピー。
    • log4j.properties を install-directory/ClearQuestConnector/gateway から install-directory/ClearQuestSynchronizer/gateway にコピー。
    • tomcat-users.xml を install-directory/ClearQuestConnector/gateway/tomcat/conf から install-directory/ClearQuestSynchronizer/gateway/tomcat/conf にコピー。
    • web.xml を install-directory/ClearQuestConnector/gateway/tomcat/webapps/cqconnector/WEB-INF から install-directory/ClearQuestSynchronizer/gateway/tomcat/webapps/cqconnector/WEB-INF にコピー。
    バージョン 3.X からアップグレードしており、Installation Manager で「更新」オプションを選択した場合は、変更された構成ファイルはバックアップ・ディレクトリーに保存されます。変更された構成ファイルをバックアップ・ディレクトリーから新しいインストール・ディレクトリーにコピーします。
    注:

    4.0 より前のリリースで使用された server.xml ファイルは 4.0 とは非互換です。したがって、このファイルを install-directory/ClearQuestConnector/gateway/tomcat/conf またはバックアップ・ディレクトリーから install-directory/ClearQuestSynchronizer/gateway/tomcat/conf にコピーすることはできません。 代わりに、前のバージョンで行った変更が含まれるように、新規インストール・ディレクトリー (install-directory/ClearQuestSynchronizer/gateway/tomcat/conf) 内の 4.0 server.xml ファイルを編集してください。

  11. オプション。JazzInterop パッケージの最新バージョンを ClearQuest スキーマに適用し、ClearQuest ユーザー・データベースを新しいスキーマ・バージョンでアップグレードします。詳しくは、新しいバージョンの JazzInterop パッケージを使用したユーザー・データベースのアップグレードを参照してください。
  12. ClearQuest Gateway を始動します。
  13. http://host-name.example.com:8081/cqconnector/gateway にある状況ページにアクセスし、Gateway の状況を確認します。 このページには、Gateway がすべての要求を受け入れる状況にあることが表示されるはずです。
  14. 外部リポジトリー接続の発信同期を使用可能に設定します。
  15. サーバーの発信同期を使用可能に設定します。
  16. 以下のステップを実行し、同期が機能しているかどうか検証します。
    • ClearQuest ユーザー・データベース内にレコードをいくつか作成します。Rational Team Concert プロジェクト・エリアに、対応するワークアイテムが作成されることを確認してください。
    • プロジェクト・エリアにワークアイテムをいくつか作成します。ClearQuest ユーザー・データベースに対応するレコードが作成されることを確認してください。
    • 以前のリリースで同期化されたワークアイテムをいくつか編集します。行われた変更が対応する ClearQuest レコードに伝搬されることを確認してください。
    • 以前のリリースで同期化された ClearQuest レコードをいくつか編集します。行われた変更が対応するワークアイテムに伝搬されることを確認してください。
  17. バージョン 2.X からアップグレードしている場合、または Installation Manager で「更新」オプションを選択しなかった場合は、以前のリリースの ClearQuest Connector をアンインストールします。 アンインストールの操作により、「backup-config-timestamp」という名前のディレクトリーが install-directory/ClearQuestConnector ディレクトリー内に作成されます。 このディレクトリーに以下のディレクトリーおよびファイルが含まれていることを確認してください。
    • gateway/cqconnector.properties
    • gateway/log4j.properties
    • gateway/tomcat/conf (このディレクトリーにはいくつかのファイルと 1 つの Catalina ディレクトリーが含まれています)
    • gateway/tomcat/webapps/cqconnector/WEB-INF/web.xml

フィードバック