このトピックでは、IBM® Rational® Requirements Composer バージョン 2 からバージョン 3.0.1 へのサーバーのオフライン・マイグレーションのための、手動によるアップグレード手順を説明します。
始める前に
アップグレードを開始する前に、Network Time Protocol (NTP) を使用してすべてのマシンのクロックが同期されるようにしてください。
時刻は、あるネットワーク・ノード上のイベントを別のネットワーク・ノード上の対応するイベントにマップできるようにするための不可欠な要素です。NTP サービスを企業全体でデプロイすることで、この課題に対応できます。NTP について詳しくは、http://www.ntp.org/ を参照してください。また、すべてのサーバーで使用されるユーザーの認証方式が同一でなければなりません。
複数の製品をアップグレードする場合は、アップグレードの順序を参照してどの製品を先にアップグレードするか決めてください。
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
- IBM Rational Requirements Composer ソフトウェアおよび Rational solution for Collaborative Lifecycle
Management (CLM) に含まれるインストール予定の他のアプリケーションを、Jazz.net からダウンロードします。説明については、製品インストール・メディアのダウンロードを参照してください。
- 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 にナビゲートし、次のコマンドを使用してバージョン 2 の構成ファイルをバージョン 3.0.1 の該当ファイルとマージします。repotools-jts -migration_rm_updateConfigurationFiles
oldApplicationHome=RRCS20InstallDir/server/conf
例えば分散デプロイメントなどで、Jazz Team Server バージョン 3.0.1 を RM アプリケーションとは別にインストールした場合、RM アプリケーションの場所を指定して、Jazz Team Server バージョン 3.0.1 のインストール・ディレクトリーからスクリプトを実行する必要があります。この場合、newApplicationHome 引数を組み込んでください。
repotools-jts -migration_rm_updateConfigurationFiles
oldApplicationHome=RRC2InstallDir/server/conf newApplicationHome=<JTS301_install_dir>/server/conf -jtsURL https://<fully qualified domain name>:<port>/jts
注: -jtsURL パラメーターは、Jazz Team Server のパブリック URI です。
デフォルトで、Jazz Team Server のパブリック URI はアプリケーションのパブリック URI から派生します。Jazz Team Server が RM アプリケーションとは異なるサーバー・インスタンスで稼働する分散デプロイメントでは、このパラメーターを指定する必要があります。
このコマンドにより実行されるタスクを以下に示します。
- バージョン 2 の Jazz JazzInstallDir/server/conf/jazz/teamserver.properties ファイルの情報に基づき、バージョン 3 の JazzInstallDir/server/conf/app/teamserver.properties ファイルが更新されます。
このとき、ユーザーが Jazz Team Server データベース・ロケーション・プロパティーなどの値 (スクリプトがバージョン 2 から取得できない情報) を編集できます。
注: Jazz Team Server バージョン 3.0.1 をまだインストールおよび構成していない場合、この時点で、前にステップ
9 で作成した
Jazz Team Server の新規データベースのデータベース・ロケーション・プロパティーを入力する必要があります。
- バージョン 2 の Tomcat ユーザーの .xml ファイルをコピーします。
- バージョン 2 の friendsconfig.rdf ファイル (リポジトリー間統合のためにセットアップされたサーバーのリストが記述されているファイル) がバージョン 3.0.1 にマージされます。
- バージョン 2 の server.xml および web.xml (LDAP 設定) ファイルの内容がバージョン 3.0.1 にマージされます。
詳しくは、構成ファイルのマージおよび-migration_updateConfigurationFilesを参照してください。
- 次の例に示すように、repotools-jts -importapplicationdata コマンドを使用して、エクスポートしたバージョン 2 リポジトリーの Rational Requirements Composer データを、新しいバージョン 3 の「要求管理 (RM)」リポジトリーにインポートします。
repotools-jts migration_importapplicationdata fromFile=c:¥export.tar
この fromFile 変数は、リポジトリーのインポート元 .tar ファイルの名前を指定します。
注: - これが Jazz Team Server およびいずれかの Collaborative Lifecycle Management 製品の新規インストールであるなら、ユーザー・データを Jazz Team Server に初めてインポートする場合に、createTables パラメーターをコマンド・リンクに含めることができます。createTables パラメーターにより、Jazz Team Server データベースが作成され、.tar ファイルの内容がインポートされます。既存の Jazz Team Server データベースが既にある場合は、コマンド行に createTables パラメーターを含めないでください。含めると、既存のデータベースを上書きします。
- IBM Rational Requirements Composer バージョン 2 でフローティング・ライセンスを使用していた場合、IBM Rational Requirements Composer バージョン 2 のデータベースからデータをインポートする前に、アップグレード・スクリプトを停止し、Jazz Team Server を開始して、バージョン 3.0.1 フローティング・ライセンスをインストールする必要が生じる場合がある、という既知の問題があります。この方法の詳細については、https://jazz.net/library/article/659を参照してください。
- 「要求管理」バージョン 3.0.1 の大きなリポジトリーをインポートすると、OutOfMemoryException エラーが発生する可能性があります。多数のプロジェクトと成果物を扱う場合、repotools-jts.bat スクリプトまたは repotools-jts.sh スクリプトの -Xmx パラメーターをデフォルト値の 1500M からより高い値に変更する必要があります。マシンに十分なメモリーが搭載されている場合、最適な結果を得るには、4096M を使用してください。
- Rational Requirements Composer の構成ファイルに対する変更の詳細なリストを表示するには、Rational Requirements Composer に関する変更を参照してください。
- リポジトリー・データと構成ファイルを検証します。詳しくは、アップグレード中に構成ファイルを検証する (Verifying the configuration files
during the upgrade) を参照してください。
- オフライン・マイグレーションが終了したら、バージョン 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 のセットアップおよび WebSphere Application Server での CLM アプリケーションのデプロイを参照してください。
- バックアップが完了したら、オンライン・マイグレーションのステップに進みます。オンライン・マイグレーション・アップグレード手順を参照してください。