このトピックでは、Tomcat アプリケーション・サーバーおよび DB2® for z/OS® を使用するセットアップで、Rational® Team Concert (RTC) バージョン 3.0 から Rational solution for Collaborative Lifecycle Management (CLM) バージョン 4 のアプリケーションにサーバーをアップグレードするために必要なステップについて説明します。
始める前に
必要な場合に元のファイルを確認できるように、BLZSAMP メンバーのコピーを作成します。ジョブの実行依頼後、サンプルのジョブ・ログを確認します。予想される戻りコードは 0 です。
このタスクについて
以下のステップを実行すると、RTC バージョン 3.0 の構成が CLM バージョン 4.0 の構成にマイグレーションされます。
手順
- SMP/E インストールを使用して、CLM バージョン 4 のパッケージをインストールします。バージョン 4 の構成のロケーションは、バージョン 3.0 の構成のロケーションとは異なっている必要があります。 SMP/E パッケージをインストールすると、アップグレードに使用される新しいデータベース・バックアップ・ツールが提供されます。詳細については、SMP/E インストール・プロセスの概要を参照してください。
注: バージョン 4 の FMID は変更されているため、バージョン 3.0 からバージョン 4 にアップグレードするための PTF はありません。
- 提供されている DB2 for z/OS の UNLOAD ユーティリティーと LOAD ユーティリティーを使用して 3.0 リポジトリーをバックアップします。 詳しくは、バックアップのための DB2 アンロード・プロセスおよびロード・プロセスの使用を参照してください。他のツールがテストされて検証されている場合は、それらのツールを使用してバックアップ・コピーを作成することができます。
重要: アップグレード・プロセスでは、ロールバックできないリポジトリー・モデルの変更が行われるため、アップグレードに進む前にリポジトリーのバックアップ・コピーを作成する必要があります。
- バックアップ手順とリストア手順を確認するには、新しいデータベースと新しいスキーマ接頭部への UNLOAD と LOAD のステップを完了してください。
- バージョン 3.0 の BLZCREDB サンプル・ジョブを使用して、新しいデータベースに表を作成します。
- データベースのバックアップ手順とリストア手順を完全にテストするには、各リポジトリーの追加データベースを作成します。新しく作成されたデータベースは、既存のデータベースと同じアクセス権を持っている必要があります。
- 各データベースに別々の UNIX System Services ディレクトリー (ussWorkDir) を作成します。
- 同じ文字数を持つ、リポジトリーのスキーマ接頭部を使用します。
- アップグレード・ステップを続行する前に、新しい 3.0 リポジトリーが正常に作成されたことを確認します。
- バージョン 4 の SBLZSAMP サンプル・メンバー BLZCPJTS を変更および実行依頼して、ライフサイクル・プロジェクト管理アプリケーションを含め、サーバー構成構造および作業ディレクトリーをセットアップすることにより、Jazz™ Team Server (JTS) を構成します。
注: アップグレード・ユーティリティーによって 2 つのバージョンがマージできるように、バージョン 4 用に作成する構成 (JAZZ_HOME) ディレクトリーと作業ディレクトリーは、バージョン 3.0 のディレクトリーとは異なっている必要があります。例えば、バージョン 3.0 のデフォルト構成ディレクトリーは /etc/jazz なので、バージョン 4 には /etc/jazz40 を使用します。同様に、作業ディレクトリーには /u/jazz40 を使用します。
サンプル・メンバーの指示に従うか、Jazz Team Server および Rational solution for Collaborative Lifecycle Management アプリケーションの追加ディレクトリーの作成を参照してください。
- バージョン 4 の SBLZSAMP サンプル・メンバー BLZCPCCM を変更および実行依頼して、CCM 定義を使用した新しいサーバー構成および作業ディレクトリー構造をセットアップすることにより、「変更管理と構成管理 (CCM)」サーバーを構成します。 サンプル・メンバーの指示に従うか、Jazz Team Server および Rational solution for Collaborative Lifecycle Management アプリケーションの追加ディレクトリーの作成を参照してください。
- データウェアハウスとして使用する RIDW と呼ばれる新しい DB2 for z/OS データベースを作成し、アクセス権を付与します。 詳細については、Jazz Team Server とともに使用するための DB2 for z/OS のセットアップを参照してください。
- バージョン 4 の Tomcat サーバーを開始および停止してアプリケーションをデプロイします (または、ccm.war ファイルと jts.war ファイルをデプロイします)。
注: バージョン 3.0 のアプリケーションの web.xml ファイルが (例えば、LDAP レジストリーをサポートするために) カスタマイズされている場合は、残りのステップによって、それらのカスタマイズされたファイルがバージョン 4 のアプリケーションにマイグレーションされ、各アプリケーションの web.xml ファイルが変更されます。ただし、.war ファイルは署名されているため、.war ファイルのデプロイされたバージョンにのみ変更を行うことができます。マイグレーション後にアプリケーションが再デプロイされた場合は、バージョン 3.0 のファイルを再度手動でカスタマイズする必要があります。
- JTS サーバー構成をマイグレーションします。リポジトリー・ツールを使用して、バージョン 4 の SBLZSAMP サンプル・メンバー BLZJTSU を変更することにより、JTS 用のバージョン 3.0 の構成ファイルの設定をバージョン 4 の構成ファイルにマージします。BLZJTSU ジョブを実行依頼する前に、以下のステップを完了してください。
- @pathPrefix@ 変数を、バージョン 4 のバイナリー・ファイルのパス接頭部を指すように置換します。
注: このサンプル・メンバーによって使用される migration_jts_updateConfigurationFiles リポジトリー・ツール・コマンドは、バージョン 3.0.1 で追加されました。@pathPrefix@ が前のバージョンを指している場合、リポジトリー・ツール・コマンドはバージョン 4 の更新コマンドを使用しません。
- サンプル BLZJTSU ジョブの手順を完了します。
BLZJTSU ジョブを実行依頼し、ジョブ出力と更新されたプロパティー・ファイルを確認します。
注: Derby データウェアハウスを指すデータウェアハウスのプロパティーはこのマージの一部として保持されますが、後のステップで対処されます。
- CCM サーバー構成をマイグレーションします。リポジトリー・ツールを使用して、バージョン 4 の SBLZSAMP サンプル・メンバー BLZCCMU を変更することにより、CCM 用のバージョン 3.0.1.x の構成ファイルの設定をバージョン 4 の構成ファイルにマージします。BLZCCMU ジョブを実行依頼する前に、以下のステップを完了してください。
- 以下の行を applicationContextRoot=jazz から applicationContextRoot=ccm に変更します。
バージョン 3 のサーバーがバージョン 2.x からマイグレーションされたのでない限り、アプリケーション・コンテキストは /ccm になります。
- @pathPrefix@ 変数を、バージョン 4 のバイナリー・ファイルのパス接頭部を指すように置換します。
注: このサンプル・メンバーによって使用される migration_ccm_updateConfigurationFiles リポジトリー・ツール・コマンドはバージョン 3 で追加されました。@pathPrefix@ が前のバージョンを指している場合、リポジトリー・ツール・コマンドはバージョン 4 の更新コマンドを使用しません。
- サンプル BLZCCMU ジョブの手順を完了します。
BLZCCMU ジョブを実行依頼し、ジョブ出力と更新されたプロパティー・ファイルを確認します。
注: Derby データウェアハウスを指すデータウェアハウスのプロパティーはこのマージの一部として保持されますが、後のステップで対処されます。
- RTC バージョン 3 の Tomcat サーバーを停止します。
- 以下のステップを完了して、索引ファイルをコピーします。
- バージョン 3 からバージョン 4 に JFS/text 索引をコピーします。分散システムの場合は、該当するサーバーに移動してファイルをコピーします。
- コマンド・プロンプトを開き、以下のコマンドを入力して、デフォルトの 4.0 索引ディレクトリーをクリアします。
rm -rf <4.0_configuration_dir>/jts/indices
rm -rf <4.0_configuration_dir>/ccm/indices
コマンド・プロンプトを開き、以下のコマンドを入力して、バージョン 3 からバージョン 4 に索引をコピーします。cp -R <3.0_configuration_dir>/jts/indices <4.0_configuration_dir>/jts/indices
cp -R <3.0_configuration_dir>/ccm/indices <4.0_configuration_dir>/ccm/indices
com.ibm.team.fulltext.indexLocation と com.ibm.team.jfs.index.root.directory のロケーション情報が正しくなるように、JTS および CCM の teamserver.properties ファイルを編集します。
- JTS データベースをアップグレードします。リポジトリー・ツールを使用し、バージョン 4 の SBLZSAMP サンプル・メンバー BLZADDTB のコピーを変更および実行依頼して、4.0 のデータベース表を JTS リポジトリーに追加します。アプリケーション変数 @appl@ は jts に設定する必要があります。サンプル・メンバーに含まれている手順に従って、ジョブの出力を注意深く確認します。
- CCM データベースをアップグレードします。CCM アプリケーションを構成した場合は、リポジトリー・ツールを使用し、バージョン 4 の SBLZSAMP サンプル・メンバー BLZADDTB のコピーを変更および実行依頼して、CCM リポジトリーに 4.0 のデータベース表を追加します。アプリケーション変数 @appl@ は ccm に設定する必要があります。サンプル・メンバーに含まれている手順に従って、ジョブの出力を注意深く確認します。
- オプション: データウェアハウスを構成します。データウェアハウス・リポジトリーの設定を含めるように、JTS および CCM の teamserver.properties ファイルを編集します。同じ設定が、3 つのファイルすべてに適用されます。
重要: 今スタンドアロンのデータウェアハウスを実装しない場合は、このステップをスキップすることができます。ただし、このステップをスキップした場合は、Jazz Team Server セットアップ・ウィザードを使用する際にデータウェアハウス構成ステップをスキップする必要があります。
今データウェアハウスを構成する場合は、db2z データウェアハウスのパラメーターを組み込み、既存の Derby データウェアハウスのプロパティーをすべて除去するように、JTS および CCM の teamserver.properties ファイルを更新する必要があります。具体的には、以下の例のように、# を使用してコメント化します。
#com.ibm.team.datawarehouse.db.net.port
#com.ibm.team.datawarehouse.db.vendor=DERBY (or derby_net)
#com.ibm.team.datawarehouse.db.jdbc.location=/directoryInYourWorkdirectory or
#com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527// ...
以下の情報を追加します。com.ibm.team.datawarehouse.db.vendor = db2z
com.ibm.team.datawarehouse.db.jdbc.location=//ipAddress:ipPort/location:user=jazzDBuser;password={password};
com.ibm.team.datawarehouse.db.jdbc.password=jazzDBpswd
# The database user for whom proper permissions will be granted
com.ibm.team.datawarehouse.report.user = RPTUSER
com.ibm.team.datawarehouse.db.db2.dsn.dbname=RIDW
- データウェアハウスの teamserver.properties ファイルを更新している場合は、データウェアハウス表を作成するためにバージョン 4 の SBLZSAMP サンプル・メンバー BLZCREDB を変更および実行依頼して、データウェアハウス・リポジトリーを作成します。アプリケーション変数 @appl@ は jts に設定します。リポジトリー・ツール・コマンド @repotoolsCommand@ は -createWarehouse です。
- バージョン 4 の SBLZSAMP サンプル・メンバー BLZSRVD を変更および実行依頼して、バージョン 4 の Tomcat サーバーを開始します。構成ディレクトリーの @confPath@ 変数と作業ディレクトリーの @workPath@ 変数が新しいバージョン 4 ディレクトリーの値に設定されていることを確認してください。
- 以下のステップを完了してライセンスをアクティブにします。
- 4.0 Jazz Team Server に管理者としてログインします。
- 「サーバー管理」> 「ライセンス・キーの管理」ページにナビゲートして、ライセンスをアクティブにします。
注: 4.0 システムではすべてが既にセットアップ済みのため、セットアップを実行する必要はありません。
ライセンスに関する注意: - マイルストーンのリリースでは、マイルストーンに同梱されている早期アクセス・ライセンスをアクティブにする必要があります。
- バージョン 4.0 の最終リリースでは、新規ライセンスを購入する必要があります。バージョン 4 のライセンスはバージョン 3 のアプリケーションと互換性がありますが、バージョン 4 のアプリケーションはバージョン 3 のライセンスでは動作しません。詳しくは、ライセンスの管理を参照してください。
- 「品質管理 (QM)」または「要求管理 (RM)」アプリケーションを追加する場合は、新規インストールの手順に従ってください。詳しくは、z/OS での Jazz Team Server および Rational solution for Collaborative Lifecycle Management アプリケーションのインストールおよび構成を参照してください。