このトピックでは、Rational® Quality Manager をバージョン 2 からバージョン 3 に手動でアップグレードする手順を説明します。
始める前に
アップグレードを開始する前に、Network Time Protocol (NTP) を使用してすべてのマシンのクロックが同期されるようにしてください。
時刻は、あるネットワーク・ノード上のイベントを別のネットワーク・ノード上の対応するイベントにマップできるようにするための不可欠な要素です。問題の発生を防ぐため、NTP サービスを企業全体でデプロイすることで、この課題に対応できます。NTP について詳しくは、http://www.ntp.org/ を参照してください。また、すべてのサーバーで使用されるユーザーの認証方式が同一でなければなりません。
複数の製品をアップグレードする場合は、アップグレードの順序を参照してどの製品を先にアップグレードするか決めてください。
WebSphere® Application Server 環境では、インストール・パスを、C:¥IBM¥JazzTeamServer のようなスペースを含まないものに変更することをお勧めします。ファイル名またはファイル・パスのパラメーターにスペースが含まれている場合、そのパラメーターを二重引用符で囲む必要があります。
バージョン 2.0.1 iFix02 以降からアップグレードする場合は、バージョン 2.0.1.1 以降にアップグレードしてからデータをエクスポートしてください。さらに、エクスポート/インポート・プロセスで発生する可能性のあるエラーを防ぐため、バージョン 2 のサーバー上で以下の repotools コマンドを実行します。
Windows: repotools
-repairRequests
Unix/Linux: ./repotools.sh
-clean -repairRequests
2.0.1 iFix02 より前のバージョンのユーザーは、このステップを無視して構いません。
手順
- 必要に応じて、デプロイメントおよびアップグレードの計画のセクションのトピックをご確認ください。
- 既存のバージョン 2 の teamserver.properties ファイルで、パブリック URL プロパティー (com.ibm.team.repository.server.webapp.url)、およびデータベース・サーバーへの接続情報 (通常、com.ibm.team.repository.db.vendor、com.ibm.team.repository.db.jdbc.location、および com.ibm.team.repository.db.jdbc.password) を調べます。
バージョン 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
- Jazz.net 上の適切なプロジェクト・ページから、Rational Quality Manager ソフトウェアをダウンロードします。説明については、製品インストール・メディアのダウンロードを参照してください。
- バージョン 2 のサーバーを停止します。
注: 分散環境で作業を行っていて、
Jazz™ Team Server 3.0.1 をインストール済みの場合、
Jazz Team Server および他のアプリケーションのダウン時間を最小化するために、オプションとして、バージョン 2 のデータをバージョン 3 の「品質管理」(QM) データベースにインポートし終えるまでサーバーを稼働したままにすることができます。このとき、
Jazz Team Server は停止しなければなりません。
ユーザー・データおよびライセンス・データの
Jazz Team Server へのインポートを完了した後、これを再始動することができます (
14)。
- バージョン 2 のデータベースと teamserver.properties ファイルを一時ロケーションにバックアップします。バージョン 2 では、teamserver.properties ファイルはデフォルトで InstallDir¥server¥conf¥jazz¥teamserver.properties にあります。バックアップの手順については、以下のトピックを参照してください。
- 次のバージョン 2.0.1 の例に示すように、repotools -export コマンドを使用して既存のバージョン 2 リポジトリーからデータをエクスポートし、Rational Quality Manager ディレクトリー構造の外部にファイルを保存します。
repotools -export toFile=c:¥export.tar teamserver.properties=c:¥Program%20Files¥IBM¥RQM201¥server¥conf¥jazz¥teamserver.properties
この toFile には、リポジトリーをエクスポートする TAR ファイルの名前を指定し、teamserver.properties には teamserver.properties ファイルのパスを指定します。
- Jazz Team Server がまだインストールされていなければ、Jazz Team Server、「品質管理」アプリケーション、および必須ベース・ライセンス・キーをディスク上の新規の場所にインストールします。Jazz Team Server がインストール済みである場合は、「品質管理」アプリケーションをインストールします。説明については、IBM Installation Manager を使用したインストールを参照してください。
重要: バージョン 2 とは異なり、要求、障害、およびその他のワークアイテムは「品質管理」アプリケーションでは作成されなくなりました。これらの機能を利用したいテスト・チームは、「要求管理」と「変更管理と構成管理」もインストールする必要があります。分散環境では、これらのアプリケーションを別々にインストールすることができます。
インストール時に、「Rational Quality Manager 2.x のコンテキスト・ルートを使用する (Use Rational Quality Manager 2.x context root)」を選択します。これにより、QM アプリケーションはコンテキスト・ルート /qm ではなく /jazz にインストールされます。QM 成果物へのリンクを保持するには、このオプションが必要です。このオプションを選択しないと、アップグレードが失敗します。詳しくは、デプロイメントおよびアップグレード・プロセスについての理解を参照してください。
- インストール終了時に、「どのプログラムを開始しますか?」で「なし」を選択します。
- デフォルトの Derby データベース以外のデータベースを使用する場合は、バージョン 3 データベースを作成します。
Jazz Team Server、「品質管理」、「変更管理と構成管理」、およびデータウェアハウスには、データベースが必要です。「要求管理」ではデータ・ストレージとして Jazz Team Server データベースが使用されるため、「要求管理」用にデータベースを作成する必要はありません。各データベースについて詳しくは、データベースのセットアップを参照してください。
- バージョン 3.0.1 (RQM301InstallDir/server) で新規コマンド・ウィンドウを開き、repotools-jazz -migration_qm_updateConfigurationFiles
oldApplicationHome=RQM2InstallDir/server/conf と入力してバージョン 2 の Jazz 構成ファイルをバージョン 3 の該当ファイルと統合します。
例えば分散デプロイメントなどで、バージョン 3.0.1 の Jazz Team Server を QM アプリケーションとは別にインストールした場合、以下を行います。
- Jazz Team Server がインストールされているドライブまたはファイル・システムをマウントします。
- -migration_qm_updateConfigurationFiles コマンド行に -newJTSHome 引数を組み込むことで、3.0.1 Jazz Team Server の場所を指定します。
このコマンドにより実行されるタスクを以下に示します。
- バージョン 2 の Jazz teamserver.properties ファイルの情報に基づき、アプリケーションと JTS のバージョン 3 の teamserver.properties ファイルが更新されます。
- Tomcat ユーザーの xml ファイルの内容をコピーします。
- friendsconfig.rdf ファイル (リポジトリー間統合のためにセットアップされたサーバーのリストが記述されているファイル) がバージョン 3 にマージされます。
- バージョン 2 の server.xml および web.xml (LDAP
設定) ファイルの内容がバージョン 3 にマージされます。
- 構成ファイルを検証します。詳しくは、アップグレード中に構成ファイルを検証する (Verifying the configuration files
during the upgrade) および -migration_qm_updateConfigurationFiles を参照してください。
- WebSphere Application Server にデプロイする場合は、バージョン 2 の jazz.war アプリケーションおよび help.war アプリケーションを停止してアンインストールします。
- 次の例に示すように、repotools-jazz -import コマンドを使用して、エクスポートしたバージョン 2 リポジトリーの Rational Quality Manager データを、新しいバージョン 3 の「品質管理 (QM)」のデータベースにインポートします。
repotools-jazz -import fromFile=c:¥export.tar
この fromFile は、リポジトリーのインポート元 TAR ファイルの名前を指定します。
注: 「品質管理」3.0.1 の大きなリポジトリーをインポートすると、OutOfMemoryException エラーが発生する可能性があります。多数のプロジェクトと成果物を扱うお客様は、repotools-jazz.bat スクリプトまたは repotools-jazz.sh スクリプトの -Xmx パラメーターをデフォルトの 1500M からより高い値に変更する必要があります。マシンに十分なメモリーが搭載されており、64 ビットの OS を稼働している場合、4096M を推奨します。
- 新規 Jazz Team Server (JTS) データベースを作成し、「品質管理」データベースのユーザー・データとライセンス・データを移動します。
- 次の repotools-jazz コマンドを使用して、「品質管理」アプリケーションからユーザー・データをエクスポートします。
repotools-jazz -migration_exportJTSData toFile=jtsData.tar
- 次の repotools-jts コマンドを使用して、ユーザー・データとライセンス・データを Jazz Team Server データベースにインポートします。
重要: これが Jazz Team Server といずれかの Collaborative Lifecycle Management 製品の新規インストールである場合は、repotools-jts コマンドに createTables パラメーターを含めて、新しい JTS データベースを作成できます。既存の JTS データベースが既にある場合は、コマンド行に createTables パラメーターを含めないでください。含めると、既存のデータベースを上書きします。
repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=mapping-qm.txt createTables
- 次の repotools-jazz コマンドを使用して、ユーザー・マッピング・データを QM データベースにインポートします。このマッピングは、QM アプリケーションが JTS データベースと通信するために使用します。
repotools-jazz -migration_importUserMapping fromMappingFile=mapping-qm.txt
- 以前のリリースで使用する目的でセキュリティー証明書を作成した場合は、以前のリリースからこの証明書をコピーするか、または証明書を新規に作成します。詳細は、セキュリティー証明書の構成を参照してください。
- Tomcat アプリケーション・サーバーを Windows サービスとして実行している場合は、このサービスを削除してから再インストールする必要があります。コマンド構文についてはWindows サービス (32 ビット、Rational Quality Manager) としての Apache Tomcat での実行を参照してください。
- WebSphere Application Server にデプロイする場合は、3.0 WAR ファイルをデプロイし、セキュリティー・ロールをユーザーまたはグループにマップします。
詳しくは、バージョン 3 アップグレードのための WebSphere Application Server のセットアップおよび WebSphere Application Server での CLM アプリケーションのデプロイを参照してください。
- アプリケーション・サーバー (Jazz Team Server バージョン 3 または WebSphere Application Server) を始動します。
- インストールしたサーバーおよび CLM アプリケーションを構成します。
Jazz Team Server を「品質管理」アプリケーションまたはいずれかの CLM アプリケーションと共にアップグレードする場合は、サーバー・セットアップ・ウィザードを実行してください (セットアップ・ウィザードの実行を参照)。設定済みの Jazz Team Server に「品質管理」を追加する場合は、管理 Web インターフェースをご使用ください (Jazz Team Server へのアプリケーションの登録を参照)。
- jazz/admin に移動し、エラーがないことを確認します。
- バージョン 2 の要求を「要求管理 (RM)」アプリケーションにマイグレーションします。詳しくは、『ワークアイテム・ベースの要求をマイグレーションする』を参照してください。
注: バージョン 2 の要求を Rational Quality Manager 内部で保持する場合にこのステップを実行する必要があります。
外部要求プロバイダーを使用している場合、このステップは不要です。
- ブラウザーを開き、ブラウザーのキャッシュをクリアして、プロジェクトに再接続します。
- ライセンスをアップグレードします。概要については、ライセンス交付の理解を参照してください。
次に、ライセンス・キーのインストールと管理の手順に従ってください。
注: バージョン 2 の Quality Manager ライセンスおよび Lab Manager ライセンスは、バージョン 3 では Quality Professional ライセンスと呼ばれるようになりました。個別の Lab Manager ライセンスはなくなりました。
バージョン 2 の Connector ライセンスはそのまま Connector ライセンスと呼ばれていますが、バージョン 2 の Viewer ライセンスは、Contributor ライセンスと呼ばれるようになりました。
- ヘルプ・アプリケーション (clmhelp.war) が現行アプリケーションと異なるサーバー上にある場合は、ヘルプのロケーションを構成します。詳しくは、分散環境でのヘルプのロケーションの構成を参照してください。
- ダッシュボードをアップグレードする
管理ユーザーとしてアプリケーションにログインし、ダッシュボードのある任意のページにナビゲートします。次に、「マイグレーション」をクリックして、すべてのダッシュボードをアップグレードします。
- レポートを更新します。
- まず、バージョン 2 のデータウェアハウスをマイグレーションします。詳しくは、レポート・データをバージョン 2 からマイグレーションするを参照してください。
- 次に、Rational Team Concert クライアントを開始して、最新のレポート・テンプレートに更新します。詳しくは、『事前に定義されたレポート・テンプレートの更新』を参照してください。
- バージョン 2 で Rational Common Reporting を使用していた場合、レポートを Rational Reporting for Development Intelligence にマイグレーションする必要があります。
詳しくは、Rational Reporting for Development Intelligence へのマイグレーションを参照してください。
- アップグレードが完了していることを確認します。詳しくは、アップグレードの検証を参照してください。
次のタスク
アップグレードが完了したら、
アップグレード後の Jazz Team Server および最初のアプリケーションの構成に進みます。
注: Rational Common Reporting からマイグレーションする場合は、サーバーを構成する前に、既存の Rational Common Reporting データウェアハウスのデータベースをバックアップしてください。バックアップの手順については、データウェアハウスをホストするリレーショナル・データベース管理システムの資料を参照してください。