このトピックでは、qm_upgrade スクリプトを使用して Rational® Quality Manager バージョン
2 からバージョン 3 へアップグレードする方法について説明します。
始める前に
アップグレードを開始する前に、Network Time Protocol (NTP) を使用してすべてのマシンのクロックが同期されるようにしてください。
時刻は、あるネットワーク・ノード上のイベントを別のネットワーク・ノード上の対応するイベントにマップできるようにするための不可欠な要素です。
問題の発生を防ぐため、NTP サービスを企業全体でデプロイすることで、この課題に対応できます。NTP について詳しくは、http://www.ntp.org/ を参照してください。また、すべてのサーバーで使用されるユーザーの認証方式が同一でなければなりません。
複数の製品をアップグレードする場合は、アップグレードの順序を参照してどの製品を先にアップグレードするか決めてください。
重要: Jazz™ Team Server とは別に「品質管理」をインストールする分散環境でアップグレード・スクリプトを使用する場合、Jazz Team Server がインストールされているドライブまたはファイル・システムにアップグレード・スクリプトがアクセスできなければなりません。 例えば Windows では、マッピングは mapped
drive letter:¥server¥conf という形式でなければなりません。絶対パス (¥¥machine
name¥installdir¥server¥conf) では機能しません。マウントされたドライブは、管理者アカウント用の読み取り、書き込み、および実行の特権で構成する必要があります。
WebSphere® Application Server 環境では、インストール・パスを、C:¥IBM¥JazzTeamServer のようなスペースを含まないものに変更することをお勧めします。ファイル名またはファイル・パスのパラメーターにスペースが含まれている場合、そのパラメーターを二重引用符で囲む必要があります。
バージョン 2.0.1 iFix02 以降からアップグレードする場合は、バージョン 2.0.1.1 以降にアップグレードしてからデータをエクスポートしてください。さらに、エクスポート/インポート・プロセスで発生する可能性のあるエラーを防ぐため、以下の 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 へのインポートを完了した後、これを再始動することができます。
- データベースと teamserver.properties ファイルを一時ロケーションにバックアップします。バージョン 2 では、teamserver.properties ファイルはデフォルトで InstallDir¥server¥conf¥jazz¥teamserver.properties にあります。バックアップの手順については、以下のトピックを参照してください。
- 既存のバージョン 2 リポジトリーからデータをエクスポートします。
- バージョン 2 の RQM2InstallDir¥server ディレクトリーに移動します。
- 次のバージョン 2.0.1 の例に示すように、repotools -export コマンドを実行し、Rational Quality Manager ディレクトリー構造の外部にファイルを保存します。
Windows: repotools -export toFile=c:¥tmp¥export.tar
Unix/Linux: ./repotools.sh
-export toFile=/tmp/export.tar
この toFile には、リポジトリーのエクスポート先 TAR ファイルの名前を指定します。
- 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 成果物へのリンクを保持するには、このオプションが必要です。このオプションを選択しないと、アップグレードが失敗します。詳しくは、『デプロイメントおよびアップグレード・プロセスについての理解』を参照してください。
- インストール終了時に、「どのプログラムを開始しますか?」で「なし」を選択します。
- WebSphere Application Server にデプロイする場合は、バージョン 2 の jazz.war アプリケーションおよび help.war アプリケーションを停止してアンインストールします。
- デフォルトの Derby データベース以外のデータベースを使用する場合は、バージョン 3 データベースを作成します。
Jazz Team Server、「品質管理」、「変更管理と構成管理」、およびデータウェアハウスには、データベースが必要です。「要求管理」ではデータ・ストレージとして Jazz Team Server データベースが使用されるため、「要求管理」用にデータベースを作成する必要はありません。各データベースについて詳しくは、データベースのセットアップを参照してください。
- バージョン 3 のインストール済み環境で、新規コマンド・ウィンドウを開き、JazzInstallDir¥server にナビゲートして upgrade¥qm_upgrade.bat スクリプト (Windows の場合) または upgrade/qm_upgrade.sh スクリプト (UNIX システムの場合) を実行します。
注: このスクリプトは、コマンド行ですべての引数を指定して実行することができます。別の方法として、アップグレード・スクリプトを複数回再実行する場合は、スクリプトのパラメーター・ファイルを編集して簡略化されたコマンド行を実行することもできます。パラメーター・ファイルに関する説明については、
12 を参照してください。
重要: このスクリプト・ファイルはアップグレード・ディレクトリー内にありますが、サーバー・ディレクトリーから実行する必要があります。また、パスにスペースが含まれている場合は、必ず二重引用符で囲んでください。
バージョン 3.0.1 の Jazz Team Server を QM アプリケーションと共にインストールした場合で、かつ、これが最初の、あるいは唯一のアップグレード対象アプリケーションである場合、コマンド構文は以下のようになります。
Windows:
upgrade¥qm_upgrade.bat -oldApplicationHome RQM201InstallDir¥server¥conf -importFromFile c:¥tmp¥export.tar -createJTSTables
Unix/Linux:
./upgrade/qm_upgrade.sh -oldApplicationHome RQM201InstallDir/server/conf -importFromFile /tmp/export.tar -createJTSTables
注: -createJTSTables パラメーターは、Jazz Team Server 3.0.1 を初めてインストールするインストール済み環境に適用されます。
例えば分散デプロイメントなどで、バージョン 3.0.1 の Jazz Team Server を QM アプリケーションとは別にインストールした場合、3.0.1 Jazz Team Server の場所を指定して、QM 3.0.1 のインストール・ディレクトリーからスクリプトを実行する必要があります。この場合は、-newJTSHome 引数を組み込んでください。
Windows:
upgrade¥qm_upgrade.bat -oldApplicationHome RQM201InstallDir¥server¥conf -importFromFile c:¥tmp¥export.tar -newJTSHome JTS301InstallDir¥server¥conf
Unix/Linux:
./upgrade/qm_upgrade.sh -oldApplicationHome RQM201InstallDir/server/conf -importFromFile /tmp/export.tar -newJTSHome JTS301InstallDir¥server¥conf
注: - 分散デプロイメントを持っていて、Jazz Team Server バージョン 3.0.1 の構成をまだ行っていなければ、-createJTSTables パラメーターを上記のコマンド行の例に追加することができます。
- -jtsURL パラメーターは、Jazz Team Server のパブリック URI です。
デフォルトで、Jazz Team Server のパブリック URI はアプリケーションのパブリック URI から派生します。Jazz Team Server が QM アプリケーションとは異なるサーバー・インスタンスで稼働する分散デプロイメントでは、このパラメーターを指定する必要があります。
- Jazz Team Server 3.0.1 がまだ稼働中であれば、スクリプトがユーザー情報とライセンス情報のマイグレーション・プロセスを開始する前にこれを停止する必要があります。Jazz Team Server およびそれに依存するすべてのアプリケーションがオフラインになります。
コマンド行のオプションについてより詳細な情報が必要な場合は、以下のコマンドを入力してください。
Windows: upgrade¥qm_upgrade.bat -help
Unix/Linux: ./upgrade/qm_upgrade.sh
-help
このスクリプトにより実行されるタスクを以下に示します。
- バージョン 3 構成ファイルが以下のように更新されます。
- repotools-jazz
-import コマンドを使用して、TAR ファイルからエクスポートされたバージョン 2 のデータを、バージョン 3 の「品質管理 (QM)」のデータベースにインポートします。
注: 「品質管理」3.0.1 の大きなリポジトリーをインポートすると、OutOfMemoryException エラーが発生する可能性があります。多数のプロジェクトと成果物を扱うお客様は、repotools-jazz.bat スクリプトまたは repotools-jazz.sh スクリプトの -Xmx パラメーターをデフォルトの 1500M からより高い値に変更する必要があります。マシンに十分なメモリーが搭載されており、64 ビットの OS を稼働している場合、4096M を推奨します。
- 「品質管理 (QM)」のデータベースのユーザー・データおよびライセンス・データをエクスポートします。
- QM のユーザー・データおよびライセンス・データを Jazz Team Server にインポートします。
- QM データベースにユーザー・マッピング・データをインポートします。
このマッピングは QM アプリケーションが Jazz Team Server データベースと通信するために使用します。
- オプション: 前述のステップとは別の方法として、スクリプトのパラメーター・ファイルを開いてデフォルト値を変更し、簡略化された形式のコマンド行を実行することもできます。
英語版および翻訳版のパラメーター・ファイルは、Windows の場合は JazzInstallDir¥server¥upgrade¥params¥qm_params.bat ディレクトリーに、UNIX システムの場合は ./params/qm_params.sh ディレクトリーにあります。
- ご使用の言語のパラメーター・ファイルの正確な名前を取得するには、JazzInstallDir¥server¥upgrade ディレクトリーから、Windows の場合は locale.bat -qm -showParamFileName を、UNIX システムの場合は ./locale.sh -qm -showParamFileName を実行します。
- qm_params もしくはその翻訳版のファイルを開いて、各パラメーターの値を編集および指定します。設定が必要なパラメーターの 1 つは、OLD_APPLICATION_HOME ディレクトリーへのパスです。パスにスペースが含まれている場合は、二重引用符で囲んでください。各パラメーターに関する情報については、JazzInstallDir¥server¥upgrade¥doc¥qm_help.txt を参照してください。
- 構成ファイルを検証します。詳しくは、アップグレード中に構成ファイルを検証する (Verifying the configuration files
during the upgrade) および -migration_qm_updateConfigurationFiles を参照してください。
- 以前のリリースで使用する目的でセキュリティー証明書を作成した場合は、以前のリリースからこの証明書をコピーするか、または証明書を新規に作成します。詳細は、セキュリティー証明書の構成を参照してください。
- Tomcat アプリケーション・サーバーを Windows サービスとして実行している場合は、このサービスを削除してから再インストールする必要があります。コマンド構文についてはWindows サービス (32 ビット) としての Apache Tomcat での実行を参照してください。
- WebSphere Application Server にデプロイする場合は、3.0 WAR ファイルをデプロイし、セキュリティー・ロールをユーザーまたはグループにマップします。
詳しくは、バージョン 3 アップグレードのための WebSphere Application Server のセットアップおよび WebSphere Application Server での CLM アプリケーションのデプロイを参照してください。
- アプリケーション・サーバー (Jazz Team Server バージョン 3 または WebSphere Application Server) を始動します。
注: QM アプリケーションが別にインストールされている場合は、CLM アプリケーションも開始する必要があります。
- インストールしたサーバーおよび CLM アプリケーションを構成します。
Jazz Team Server を「品質管理」アプリケーションまたはいずれかの CLM アプリケーションと共にアップグレードする場合は、サーバー・セットアップ・ウィザードを実行してください (セットアップ・ウィザードの実行を参照)。設定済みの Jazz Team Server に「品質管理」を追加する場合は、管理 Web インターフェースをご使用ください (Jazz Team Server へのアプリケーションの登録を参照)。
- バージョン 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 および最初のアプリケーションの構成および
Jazz Team Server への追加のアプリケーションの登録に進みます。
注: Rational Common Reporting からマイグレーションする場合は、サーバーを構成する前に、既存の Rational Common Reporting データウェアハウスのデータベースをバックアップしてください。バックアップの手順については、データウェアハウスをホストするリレーショナル・データベース管理システムの資料を参照してください。