このトピックでは、IBM Rational® Requirements Composer バージョン 2 からバージョン 3.0.1 へのプロジェクト・コンテンツのオンライン・マイグレーションのためのアップグレード手順を説明します。
始める前に
この手順を開始する前に、アップグレード・スクリプトを使用した 3.0.1 へのオフライン・アップグレードトピックの手順に従って作業してください。オンライン・マイグレーション実行時に適用される条件を以下に示します。
- 非管理者ユーザーは、「要求管理 (RM)」Web アプリケーションへのログインを許可されていません。マイグレーションが進行中でありサーバーはまだ使用できる状態ではないことを通知するエラー・メッセージが表示されます。
- 管理者が Rational Requirements Composer を既存の Jazz™ Team Server デプロイメントに統合する場合、マイグレーションが完了するまでは、この Jazz Team Server を使用するその他のアプリケーションはすべて読み取り専用モードになります。
注: オンライン・マイグレーションが失敗した場合は、オフライン・アップグレードの完了後にバックアップした Jazz Team Server バージョン 3.0.1 のサーバー、データベース、および server/conf ディレクトリーを復元し、オンライン・マイグレーションを再実行してください。
手順
- すべてのバージョン 3.0.1 サーバーを開始します。サーバーのデプロイおよび始動の手順に従ってサーバーが始動済みであることを確認してください。
- ブラウザーを開き、ブラウザーのキャッシュをクリアして、RM Web クライアントにナビゲートします。
次の URL でサーバー名とポートを指定します。https://server:port/rdm/web/projects/migration。
デフォルトのポートは 9443 です。このページで、マイグレーションが進行中であることが検出され、マイグレーション・ウィザードが開始されます。
- Rational Requirements Composer - Analyst クライアント・アクセス・ライセンスを受け入れます。
- 「マイグレーション保守パネルを開く」をクリックし、マイグレーション・ウィザードをクリックして使用し、Rational Requirements Composer のマイグレーションを開始します。
マイグレーション実行中は、どのストレージ域を処理中であるか、いつ索引付けが開始されたかなどについて、マイグレーション Web ページで管理者に対して状況が報告されます。
重要: マイグレーション開始後は、マイグレーションが完了するまでこの操作を取り消すことはできません。
- マイグレーションが完了したら、Rational Requirements Composer データの再索引付けが行われます。
- 再索引付けが完了すると、アプリケーションがマイグレーション・データに対して検証および整合性検査を実行し、管理者にフィードバックを戻します。「マイグレーションが完了しました」というメッセージが表示されます。「次へ」をクリックします。「マイグレーション結果の確認」パネル上のリンクをクリックすると、マイグレーション済みプロジェクトのコンテンツを確認することができます。これを行わない場合は、「次へ」をクリックします。
- この時点で、ご使用のデータベースを参照する任意のプロジェクト・リンクを更新することができます。
注: リンクの更新を後で行う場合は、「閉じる」をクリックしてください。
「管理」メニュー項目から「プロジェクト・リンクの更新」を選択することで、いつでもリンクを更新することができます。
- プロジェクトが更新されると、管理者に状況が報告されます。リモート・サーバーへのログインの詳細情報を求めるプロンプトが出される場合があります。
完了したら、「閉じる」をクリックします。
注: エラーが発生した場合は、「管理」メニュー項目から「プロジェクト・リンクの更新」を選択して、リンクの更新を再度試行することができます。
- マイグレーションの完了後、Jazz Team Server バージョン 3.0.1 をインストール済みでない場合は、Jazz Team Server セットアップ・ウィザードを実行して、データウェアハウス・データベースが新しい Jazz Team Server 用に構成され、RM がライフサイクル・プロジェクト管理アプリケーションに正しく登録されるようにします。詳しくは、セットアップ・ウィザードの実行およびサーバーの構成のトピックを参照してください。
- レポートを更新します。Rational Requirements Composer バージョン 2 で Rational Publishing Engine のカスタム・レポートのテンプレートを使用していた場合、Rational Requirements Composer バージョン
3.0.1 スキーマを使用するには、レポートをマイグレーションする必要があります。詳しくは、https://jazz.net/wiki/bin/view/Main/RRC3MigrationOfRRC2CustomReports を参照してください。
- マイグレーションのファイナライズ後に、構成ファイル内で以下の事項を検証します。
- バージョン 2 アプリケーションの統合から始めて、Rational Requirements Composer と Jazz Team Server のバージョン 3.0.1 へのアップグレードのみを行う際は、バージョン 2 の Rational Team Concert および Rational Quality Manager サーバー上の friendsconfig.rdf ファイルを手動で編集して、それらのアプリケーションでダッシュボードのビューレット (ウィジェット) が正常に機能するようにする必要があります。
注: バージョン 2 の「変更管理と構成管理 (CCM)」アプリケーションおよび「品質管理 (QM)」アプリケーションをバージョン 3.0.1 にアップグレードする場合は、以下の修正が自動的に行われます。
その場合は、以下の編集は必要ありません。
- テキスト・エディターで、バージョン 2 の CCM および QM アプリケーション・サーバー上にある InstallDir/server/conf/jazz/friendsconfig.rdf ファイルを開きます。
- oauthDomain URI を修正して、(バージョン 2 の値 /jazz/rootservices を置換し、) Rational Requirements Composer サーバー上の /jts/rootservices を指すようにします。
<jfs:oauthDomain>http://rrc_hostname:9445/rdm/rootservices,http://jts_hostname:9445/jts/rootservices" />
- friendsconfig.rdf ファイルを保存して閉じ、バージョン 2 のアプリケーション・サーバーを再始動します。
- レポートの PDF を作成する予定がある場合、ユーザーのロケールの Unicode 文字を含むフォントを使用するため (デフォルトのフォントがそれらの Unicode 文字をサポートしない場合)、fronting.properties ファイル内の com.ibm.rdm.fronting.server.publish.PDFFont プロパティーを構成する必要があります。例えば、Microsoft Office に含まれる「Arial Unicode MS」は、PDF レポートを最適に生成するために使用可能なフォントです。Microsoft Windows 以外のオペレーティング・システムでは、必要な文字を含むフォント名を構成する必要があります。