このトピックでは、以前のバージョンの IBM® Rational® Quality Manager からワークアイテム・ベースの要求をマイグレーションするために実行する必要がある手順を説明します。Rational Quality Manager バージョン 3.0.1 より前のリリースでは、要求は Rational Quality Manager 内でローカルに管理されていたか、または外部要求プロバイダー (IBM Rational RequisitePro®、IBM Rational DOORS®、または IBM Rational Requirements Composer など) で管理されていました。
バージョン 3.0.1 では、要求はローカルに管理されません。
バージョン 2 からアップグレードする場合は、ローカルのワークアイテム・ベースの要求を、「要求管理」アプリケーション (バージョン 3.0.1 と共にインストールできるアプリケーション) に意図的にマイグレーションする必要があります。
始める前に
ワークアイテム・ベースの要求をマイグレーションするには、要求をマイグレーションするユーザーが以下の前提条件を満たしている必要があります。
- ユーザーに有効な Quality Professional ライセンスが必要です。このライセンスは、「品質管理」と「要求管理」のプロジェクト・エリアへの読み取り/書き込みアクセス権をユーザーに付与します。
- ワークアイテム要求タイプがカスタム属性を使用して変更されている場合、ユーザーには「要求管理」の有効な Analyst ライセンスも必要です。ストリング・タイプのカスタム属性のみをマイグレーションできます。ユーザー定義のストリング・タイプのカスタム属性をマイグレーションできるようにするには、ユーザーが次のステップを実行する必要があります。
- 「品質管理」の「拡張プロパティー」で「カスタム属性の作成を使用可能にする」を「true」に設定します。
- ユーザーが「要求管理」プロジェクト・エリアのメンバーであり、成果物のタイプと属性を保存し、変更する権限のある役割を割り当てられていることを確認します。
- ユーザーに JazzAdmins リポジトリー・グループ・アクセス権が付与されている必要があります。
- 「要求管理」プロジェクト・エリアで要求を作成、更新、および削除する権限がある役割にユーザーを割り当てる必要があります。
- 「品質管理」プロジェクト・エリアでワークアイテムを変更できる権限がある役割にユーザーを割り当てる必要があります。
- ワークアイテム・ベースの要求内のコメントをマイグレーションする予定がある場合は、「要求管理」プロジェクト・エリアでコメントを作成、更新、および削除する権限がある役割にユーザーを割り当てる必要があります。
- 「要求管理」アプリケーションのすべてのユーザー ID が、「品質管理」アプリケーションのユーザー ID と一致している必要があります。この前提条件が設定されているのは、Rational Quality Manager バージョン 2 の要求には所有者フィールドと作成者フィールドがあり、これらのフィールドにユーザー ID が格納されるためです。これらの要求をマイグレーションする場合、「要求管理」アプリケーションでこのユーザー ID が認識できる必要があります。デフォルトでは、この ID の照合は Jazz™ Team Server によって処理されます。これは、サーバーおよびそのサーバーに登録されているすべてのアプリケーションが共有する単一のユーザー・データベースを備えています。
要求のマイグレーション元である「品質管理」の各プロジェクト・エリアは、「要求管理」プロジェクト・エリアに対して「使用と要求」のアソシエーションを持つ必要があります。「品質管理」の複数のプロジェクト・エリアを「要求管理」の 1 つのプロジェクト・エリアに関連付けることができます。
また、「品質管理」アプリケーションと「要求管理」アプリケーションの統合には、「要求管理」アプリケーションで定義される 2 つの成果物タイプ (要求タイプとテスト計画コレクション・タイプ) が必要となります。マイグレーション・プロセスでは、これらのタイプが変更されます。これらのタイプを手動で更新すると、マイグレーション・プロセスとそれ以降の統合が失敗する可能性があります。成果物タイプに関する作業について詳しくは、成果物タイプを参照してください。
このタスクについて
マイグレーションでサポート対象のものとサポート対象外のものを、以下の表にリストします。
表 1. | バージョン 3 のマイグレーションでサポート対象 |
バージョン 3 のマイグレーションでサポート対象外 |
| Rational Quality Manager バージョン
2 の要求タイプで定義された属性 |
リンクと添付ファイル |
| ストリング・タイプのカスタム属性 |
ストリング・タイプ以外のカスタム属性 |
| コメント |
レビュー (承認者、レビューアーなど) |
| テスト・ケースと要求の関係 |
サブスクライバー |
| テスト計画と要求の関係 (注記を参照。) |
ヒストリー |
注: マイグレーションされた要求は、「要求管理」アプリケーションのテスト計画コレクションの一部になります。テスト計画コレクションはテスト計画にリンクされます。下記の手順で、テスト計画コレクションとテスト計画を作成してください。
手順
- バージョン 3 をインストールし、アップグレード・スクリプトを使用した Rational Quality Manager の 3.0.1 へのアップグレードの説明に従ってバージョン 2 のデータをマイグレーションします。
- Jazz Team Server セットアップ・ウィザードを実行してアプリケーションを登録します。詳しくは、『アップグレード後の Jazz Team Server および最初のアプリケーションの構成』を参照してください。
- 必要に応じ、要求プロジェクトの作成の説明に従って、基本プロジェクト・テンプレートを使用して要求管理クライアントから要求プロジェクトを作成します。
- 「品質管理」プロジェクト・エリアを「要求管理」プロジェクト・エリアにリンクします。
プロジェクト・エリア間のリンクを設定するには、次のようにします。
- 2 つのプロジェクト・エリア間のフレンド関係を設定します。詳しくは、フレンド関係の確立を参照してください。
- 2 つのプロジェクト・エリア間のアソシエーションを追加します。プロジェクト・エリアの作成を参照してください。
- 「要求管理」アプリケーションをインポート・モードに設定するため、<JazzInstallDir>/server/conf/rm/fronting.properties ファイルの以下のプロパティーを true に設定します。
com.ibm.rdm.fronting.server.import.mode=true
このステップを実行した後、「要求管理」サーバーを再始動してください。
- 「品質管理」アプリケーションと「要求管理」アプリケーションの両方が実行されている状態で、repotools-jazz -refactorRequirements コマンドを実行して要求をマイグレーションします。
重要: バージョン 2 およびバージョン 3 の repotools コマンドを実行するため、個別のコマンド行ウィンドウを開いてください。
個別のコマンド行ウィンドウを使用することで、バージョン 2 のコマンドとバージョン 3 のコマンドが使用する環境変数の間に矛盾がないようにすることができます。
次のコマンドは、「品質管理」プロジェクト・エリアと「要求管理」プロジェクト・エリアのペアを一度に 1 つずつ処理します。
-refactorRequirements コマンドには数多くの必須引数があります。コマンドのサンプルを以下に示します。
repotools-jazz -refactorRequirements adminUserId=admin adminPassword=admin_password projectArea=qm_project_name rmProvider=rm_project_name rmUserId=rm_admin rmPassword=rm_admin_password
コマンド構文の詳細については、-refactorRequirementsを参照してください。
- マイグレーションが完了したら、「要求管理」サーバーを再始動して、ステップ 5 を元に戻しインポート・モードをオフにするため、<JazzInstallDir>/server/conf/rm/fronting.properties ファイルで以下のプロパティーを false に設定します。
com.ibm.rdm.fronting.server.import.mode=false