このトピックでは、rm_upgrade スクリプトを使用して IBM® Rational® Requirements Composer バージョン
2 からバージョン 3.0.1 へアップグレードする方法について説明します。
始める前に
アップグレードを開始する前に、Network Time Protocol (NTP) を使用してすべてのマシンのクロックが同期されるようにしてください。
時刻は、あるネットワーク・ノード上のイベントを別のネットワーク・ノード上の対応するイベントにマップできるようにするための不可欠な要素です。
問題の発生を防ぐため、NTP サービスを企業全体でデプロイすることで、この課題に対応できます。NTP について詳しくは、http://www.ntp.org/ を参照してください。また、すべてのサーバーで使用されるユーザーの認証方式が同一でなければなりません。
複数の製品をアップグレードする場合は、アップグレードの順序を参照してどの製品を先にアップグレードするか決めてください。
重要: Jazz™ Team Server とは別に「要求管理 (RM)」アプリケーションをインストールする分散環境でアップグレード・スクリプトを使用する場合、RM がインストールされるドライブまたはファイル・システムにアップグレード・スクリプトがアクセスできなければなりません。例えば Windows では、マウントは mounted
drive letter:¥server¥conf という形式でなければなりません。¥¥<machine name>¥JTS301InstallDir¥server¥conf のような絶対パスでは機能しません。マウントされたドライブは、管理者アカウント用の読み取り、書き込み、および実行の特権で構成する必要があります。
単一のサーバー・デプロイメントを使用しているか、分散デプロイメントを使用していて Jazz Team Server および「要求管理」からドライブをマウントできる場合、アップグレード・スクリプトを使用するためのこれらのアップグレード手順に従うことができます。
分散ネットワーク・デプロイメントを使用していて、ドライブをマウントすることを許可されていないか、もしくはユーザーが上級管理者で各ステップを手動で実行する予定である場合は、手動による 3.0.1 へのオフライン・アップグレードの手順に従うことができます。手動のステップでは、各スクリプトの実行内容について詳述しています。
IBM WebSphere® Application Server 環境では、インストール・パスを、C:¥IBM¥JazzTeamServer のようなスペースを含まないものに変更してください。しかし、ファイル名またはファイル・パスのパラメーターにスペースが含まれている場合、そのパラメーターを二重引用符で囲む必要があります (例: "C:¥Program
Files¥IBM")。
手順
- トピックデプロイメントおよびアップグレード・プロセスについての理解を確認します。
また、必要に応じてデプロイメントおよびアップグレードの計画のセクションのトピックも確認してください。
重要: - 元の RM バージョン 2 のコンテキスト・ルート (/rdm) と、すべての RM 成果物の URI が保持されます。
Jazz Team Server のコンテキスト・ルートは、/jazz から /jts に変更されます。
- バージョン 2 インストール済み環境でパブリック URI が設定されていた場合、バージョン 3.0.1 でも同じパブリック URI を使用する必要があります。
- ご使用のハードウェアおよびソフトウェアがアプリケーションの最小要件を満たしているか、それを上回ることを確認します。システム要件を参照してください。現行のバージョン 2 の teamserver.properties ファイル内にある以下の情報を確認します。
- パブリック URI のプロパティー - 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 で同じパブリック URI を使用する必要があります。パブリック URI が未設定である場合は、アップグレード前にバージョン 2 管理 Web インターフェース (「拡張プロパティー」) を使用して、修飾ホスト名 URI (https://hostname.example.com:port) を設定してください。
teamserver.properties ファイル内のパブリック URI の行は、次のようになります。
com.ibm.team.repository.server.webapp.url=https¥://hostname.example.com¥:9443/jazz
- Jazz.net 上の適切なプロジェクト・ページから、IBM Rational Requirements Composer ソフトウェアおよび Rational solution
for Collaborative Lifecycle Management (CLM) に含まれるインストール予定の他のアプリケーションをダウンロードします。
説明については、製品インストール・メディアのダウンロードを参照してください。
- IBM Rational Requirements Composer バージョン 2 のサーバーを停止します。
- IBM Rational Requirements Composer バージョン 2 のデータベースと teamserver.properties ファイルを一時 (tmp) ロケーションにバックアップします。teamserver.properties ファイルには、各アプリケーションがデータベースに接続するときに必要となるデータベース・ロケーションが記述されています。バージョン 2 では、このファイルはデフォルトで InstallDir¥server¥conf¥jazz¥teamserver.properties ファイル内にあります。バックアップの手順については、以下のトピックを参照してください。
- 既存の IBM Rational Requirements Composer バージョン 2 データベースからデータをエクスポートします。
- IBM Rational Requirements Composer バージョン 2 の RRC2InstallDir¥server ディレクトリーに移動します。
- 次のバージョン 2.0.1 の例に示すように、repotools -export Windows コマンドあるいは ./repotools.sh
- export AIX® または Linux システム・コマンドを実行し、IBM Rational Requirements Composer ディレクトリー構造の外側にファイルを保存します。
Windows: repotools
-export toFile=c:¥tmp¥rrcdata.tar
AIX または Linux: repotools -export toFile=/tmp/rrcdata.tar
この toFile 変数は、データベースのエクスポート先 .tar ファイルの名前を指定します。
- Jazz Team Server バージョン 3.0.1 をインストール済みである場合は、Jazz Team Server およびその他の CLM アプリケーションを含むすべてのバージョン 3.0.1 のサーバーを停止し、Jazz Team Server バージョン 3.0.1 のデータベースと環境をバックアップします。ステップ 10 に進みます。
- Jazz Team Server バージョン 3.0.1 がまだインストールされていなければ、Jazz Team Server をインストールします。
セットアップ・ウィザードは実行しないでください。
- Jazz Team Server バージョン
3.0.1 をまだインストールしていなくて、デフォルトの Derby データベース以外のデータベースを使用している場合は、Jazz Team Server データベースを作成する必要があります。
Jazz Team Server
およびデータウェアハウスには、データベースが必要です。「要求管理」アプリケーションではデータ・ストレージとして Jazz Team Server データベースが使用されるため、このアプリケーション用にデータベースを作成する必要はありません。各データベースについて詳しくは、データベースのセットアップを参照してください。
- 「要求管理」アプリケーションを別のマシンにインストールします。説明については、IBM Installation Manager を使用したインストールを参照してください。
インストール時に、「Rational Requirements Composer 2.x コンテキスト・ルートを使用」を選択します。この選択によって、RM 成果物へのリンクを保持するために必要な RM のバージョン 2 コンテキスト・ルート /rdm を保持する必須選択オプションが指定された状態で、RM アプリケーションがインストールされます。このオプションを選択しないと、アップグレードが失敗します。詳しくは、デプロイメントおよびアップグレード・プロセスについての理解を参照してください。
- インストール終了時に、「どのプログラムを開始しますか?」で「なし」を選択し、「終了」をクリックして、次に「終了」をクリックします。
- WebSphere Application Server にデプロイする場合は、バージョン 2 の .war ファイル (converter.war、jazz.war、rrc-help.war、および rdm.war) を停止してアンインストールします。詳しくは、バージョン 3 アップグレードのための WebSphere Application Server のセットアップを参照してください。
- オフライン・アップグレード・スクリプトを実行します。Jazz Team Server バージョン 3.0.1 をインストールしたロケーションから新規コマンド・ウィンドウを開いて、JTS301InstallDir¥server にナビゲートし、Windows の場合は upgrade¥rm_upgrade.bat アップグレード・スクリプトを、AIX または Linux システムの場合は upgrade/rm_upgrade.sh アップグレード・スクリプトを実行します。
このスクリプトは、実行時にコンピューター・ロケールの言語設定を使用します。
注: このスクリプトは、コマンド行ですべての引数を指定して実行することができます。別の方法として、アップグレード・スクリプトを複数回再実行する場合は、スクリプトのパラメーター・ファイルを編集して簡略化されたコマンド行を実行することもできます。パラメーター・ファイルに関する説明については、ステップ
14 を参照してください。
重要: - このスクリプト・ファイルはアップグレード・ディレクトリー内にありますが、サーバー・ディレクトリーから実行する必要があります。また、パスにスペースが含まれている場合は、パス名を二重引用符で囲んでください。
- Rational Requirements Composer バージョン 2 でフローティング・ライセンスを使用していた場合、IBM Rational Requirements Composer バージョン 2 のデータベースからデータをインポートする前に、アップグレード・スクリプトを停止し、Jazz Team
Server を開始して、バージョン 3.0.1 フローティング・ライセンスをインストールする必要が生じる場合がある、という既知の問題があります。この方法の詳細については、https://jazz.net/library/article/659を参照してください。
バージョン 3.0.1 の Jazz Team Server を RM アプリケーションと共にインストールした場合で、かつ、このアップグレードが最初の、あるいは唯一のアップグレード対象アプリケーションに対するものである場合、コマンド構文は以下のようになります。
Windows:
upgrade¥rm_upgrade.bat -oldApplicationHome RRC2InstallDir¥server¥conf -importFromFile c:¥tmp¥export.tar -createJTSTables
AIX または Linux:
./upgrade/rm_upgrade.sh -oldApplicationHome RRC2InstallDir/server/conf -importFromFile /tmp/export.tar -createJTSTables
注: -createJTSTables パラメーターは、Jazz Team Server バージョン 3.0.1 およびいずれかの Collaborative Lifecycle Management 製品を初めてインストールするインストール済み環境に適用されます。RM アプリケーションを単独でインストールする場合は、Jazz Team Server バージョン 3.0.1 が別の場所に存在するため、このパラメーターをコマンドに組み込む必要はありません。createTables パラメーターにより、Jazz Team Server データベースが作成され、.tar ファイルの内容がインポートされます。既存の Jazz Team Server データベースが既にある場合は、コマンド行に createTables パラメーターを含めないでください。含めると、既存のデータベースを上書きします。
例えば分散デプロイメントなどで、Jazz Team Server バージョン 3.0.1 を RM アプリケーションとは別にインストールした場合、RM アプリケーションの場所を指定して、Jazz Team Server バージョン 3.0.1 のインストール・ディレクトリーからスクリプトを実行する必要があります。この場合は、-newApplicationHome 引数を組み込んでください。
Windows:
JTS301InstallDir¥server upgrade¥rm_upgrade.bat -oldApplicationHome RRCS2InstallDir¥server¥conf -importFromFile c:¥tmp¥export.tar -newApplicationHome RRC301InstallDir¥server¥conf -jtsURL https://fully qualified domain name:port/jts
AIX または Linux:
JTS301InstallDir/server ./upgrade/rm_upgrade.sh -oldApplicationHome RRCS2InstallDir/server/conf -importFromFile /tmp/export.tar -newApplicationHome RRC301InstallDir/server/conf -jtsURL https://fully qualified domain name:port/jts
注: - 分散デプロイメントを使用しており、Jazz Team Server バージョン 3.0.1 の構成をまだ行っていなければ、-createJTSTables パラメーターを前述のコマンド行の例に追加することができます。
- -jtsURL パラメーターは、Jazz Team Server のパブリック URI です。
デフォルトで、Jazz Team Server のパブリック URI はアプリケーションのパブリック URI から派生します。Jazz Team Server が RM アプリケーションとは異なるサーバー・インスタンスで稼働する分散デプロイメントでは、このパラメーターを指定する必要があります。
コマンド行のオプションについて詳しくは、以下のいずれかのコマンドを入力してください。
Windows: upgrade¥rm_upgrade.bat -help
AIX または Linux: ./upgrade/rm_upgrade.sh
-help
マイグレーション対象の情報量のため、オフライン・マイグレーションは、完了までに時間がかかることがあります。
重要: オフライン・マイグレーション中に、マージされたファイルの内容 (特に teamserver.properties ファイルに指定されたデータベース接続) を表示するプロンプトを確認し、必要に応じてマージされたファイルを編集する必要があります。
このスクリプトにより実行されるタスクを以下に示します。
- バージョン 3.0.1 構成ファイルが以下のように更新されます。
- repotools-jts -import Windows コマンドあるいは ./repotools-jts.sh -import AIX または Linux システム・コマンドを使用して、.tar ファイルからエクスポートされた RM バージョン 2 のデータを Jazz Team Server バージョン 3.0.1 のデータベースにインポートします。
注: - バージョン 3.0.1 の「要求管理」アプリケーションの大きなリポジトリーをインポートすると、OutOfMemoryException エラーが発生する可能性があります。多数のプロジェクトと成果物を扱う場合、repotools-jts.bat スクリプトまたは repotools-jts.sh スクリプトの -Xmx パラメーターをデフォルト値の 1500M からより高い値に変更する必要があります。マシンに十分なメモリーが搭載されている場合、最適な結果を得るには、4096M を使用してください。
- Rational Requirements Composer の構成ファイルの変更に関する詳細なリストを表示するには、Rational Requirements Composer に関する変更を参照してください。
- オプション: 前述のステップとは別の方法として、スクリプトのパラメーター・ファイルを開いてデフォルト値を変更し、簡略化された形式のコマンド行を実行することもできます。これらの値について詳しくは、rm_upgradeを参照してください。
英語版および翻訳版のパラメーター・ファイルは、Windows の場合は JazzInstallDir¥server¥upgrade¥params¥rm_params.bat ディレクトリーに、AIX または Linux システムの場合は ./params/rm_params.sh ディレクトリーにあります。
- ご使用の言語のパラメーター・ファイルの正確な名前を取得するには、JazzInstallDir¥server¥upgrade ディレクトリーから、Windows の場合は locale.bat -rm -showParamFileName コマンドを、AIX または Linux システムの場合は ./locale.sh -rm -showParamFileName コマンドを実行します。
- rm_params ファイル、またはその翻訳版のファイルを編集用に開いて、各パラメーターの値を指定します。
設定が必要なパラメーターの 1 つは、OLD_APPLICATION_HOME ディレクトリーへのパスです。
このパスにはスペースを含めないようにしてください。しかし、ファイル名またはファイル・パスのパラメーターにスペースが含まれている場合、そのパラメーターを二重引用符で囲む必要があります。例えば、
OLD_APPLICATION_HOME="C:¥Program Files¥IBM¥RRCS2002¥server¥conf" と設定します。
各パラメーターに関する情報については、JazzInstallDir¥server¥upgrade¥doc¥rm_help.txt ファイルを参照してください。
- リポジトリー・データと構成ファイルが更新済みであるか検証します。詳しくは、アップグレード中に構成ファイルを検証する (Verifying the configuration files
during the upgrade) および -migration_rm_updateConfigurationFiles を参照してください。
- オフライン・マイグレーションが終了したら、バージョン 2 のデータベースをバックアップした場所とは別の場所に、Jazz Team Server バージョン 3.0.1 のデータベースおよびサーバーのディレクトリー全体をバックアップします。
バックアップは、オンライン・マイグレーションに進む前に行ってください。バージョン 2 のデータベース・バックアップを上書きしないようにしてください。
- 以前のリリースで使用する目的でセキュリティー証明書を作成した場合は、この証明書をコピーするか、または新規に証明書を作成します。詳細は、セキュリティー証明書の構成を参照してください。
- Tomcat アプリケーション・サーバーを Windows サービスとして実行している場合は、このサービスを削除してから再インストールする必要があります。コマンド構文についてはWindows サービス (32 ビット) としての Apache Tomcat での実行を参照してください。
- IBM WebSphere Application Server にデプロイする場合は、3.0 WAR ファイルをデプロイし、セキュリティー・ロールをユーザーまたはグループにマップします。
詳しくは、バージョン 3 アップグレードのための WebSphere Application Server のセットアップを参照してください。
- バックアップが完了したら、オンライン・マイグレーションのステップに進みます。オンライン・マイグレーション・アップグレード手順を参照してください。