WebSphere Application Server および DB2 for z/OS を使用する場合の 3.0.1.x からのサーバーのアップグレード

このトピックでは、WebSphere® Application Server および DB2® for z/OS® を使用するセットアップで、バージョン 3.0.1.x の Rational® solution for Collaborative Lifecycle Management (CLM) アプリケーションのサーバーをバージョン 4 にアップグレードするために必要なステップについて説明します。

始める前に

必要な場合に元のファイルを確認できるように、BLZSAMP メンバーのコピーを作成します。ジョブの実行依頼後、サンプルのジョブ・ログを確認します。予想される戻りコードは 0 です。

このタスクについて

以下のステップを実行すると、バージョン 3.0.1.x の構成がバージョン 4.0 の構成にマイグレーションされます。

手順

  1. SMP/E インストールを使用して、CLM バージョン 4 のパッケージをインストールします。バージョン 4 の構成のロケーションは、バージョン 3.0.1.x の構成のロケーションとは異なっている必要があります。 SMP/E パッケージをインストールすると、アップグレードに使用される新しいデータベース・バックアップ・ツールが提供されます。詳しくは、SMP/E インストール・プロセスの概要を参照してください。
    注: バージョン 4 の FMID は変更されているため、バージョン 3.0.1.x からバージョン 4 にアップグレードするための PTF はありません。
  2. サーバーを停止し、提供されている DB2 for z/OS の UNLOAD ユーティリティーと LOAD ユーティリティーを使用して 3.0.1.x のリポジトリーをバックアップします。 詳しくは、バックアップのための DB2 アンロード・プロセスおよびロード・プロセスの使用を参照してください。 他のツールがテストされて検証されている場合は、それらのツールを使用してバックアップ・コピーを作成することができます。
    重要: アップグレード・プロセスでは、ロールバックできないリポジトリー・モデルの変更が行われるため、アップグレードに進む前にリポジトリーのバックアップ・コピーを作成する必要があります。
    1. バックアップ手順とリストア手順を確認するには、新しいデータベースと新しいスキーマ接頭部への UNLOAD と LOAD のステップを完了してください。
    2. バージョン 3.0.1.x の BLZCREDB サンプル・ジョブを使用して、新しいデータベースに表を作成します。
    3. データベースのバックアップ手順とリストア手順を完全にテストするには、各リポジトリーの追加データベースを作成します。新しく作成されたデータベースは、既存のデータベースと同じアクセス権を持っている必要があります。
    4. 2 つのデータウェアハウスが 1 つのサブシステムに存在することはできないため、データウェアハウスのコピーをリストアする場合は、別の DB2 z/OS サブシステムにリストアする必要があります。
    5. 各データベースに別々の UNIX System Services ディレクトリー (ussWorkDir) を作成します。
    6. 同じ文字数を持つ、リポジトリーのスキーマ接頭部を使用します。
    7. アップグレード・ステップを続行する前に、新しい 3.0.1.x リポジトリーが正常に作成されたことを確認します。
  3. バージョン 4 の SBLZSAMP サンプル・メンバー BLZCPJTS を変更および実行依頼して、ライフサイクル・プロジェクト管理アプリケーションを含め、サーバー構成構造および作業ディレクトリーをセットアップすることにより、Jazz™ Team Server (JTS) を構成します。
    注: アップグレード・ユーティリティーによって 2 つのバージョンがマージできるように、バージョン 4 用に作成する構成 (JAZZ_HOME) ディレクトリーと作業ディレクトリーは、バージョン 3.0.1.x のディレクトリーとは異なっている必要があります。例えば、バージョン 3.0.1.x のデフォルト構成ディレクトリーは /etc/jazz なので、バージョン 4 には /etc/jazz40 を使用します。同様に、作業ディレクトリーには /u/jazz40 を使用します。
    サンプル・メンバーの指示に従うか、Jazz Team Server および Rational solution for Collaborative Lifecycle Management アプリケーションの追加ディレクトリーの作成を参照してください。
  4. バージョン 4 の SBLZSAMP サンプル・メンバー BLZCPCCM を変更および実行依頼して、CCM 定義を使用した新しいサーバー構成および作業ディレクトリー構造をセットアップすることにより、「変更管理と構成管理 (CCM)」サーバーを構成します。 サンプル・メンバーの指示に従うか、Jazz Team Server および Rational solution for Collaborative Lifecycle Management アプリケーションの追加ディレクトリーの作成を参照してください。
  5. バージョン 4 の SBLZSAMP サンプル・メンバー BLZCPQM を変更および実行依頼して、QM 定義を使用した新しいサーバー構成および作業ディレクトリー構造をセットアップすることにより、「品質管理 (QM)」サーバーを構成します。 サンプル・メンバーの手順に従ってください。
  6. バージョン 4 の SBLZSAMP サンプル・メンバー BLZCPRM を変更および実行依頼して、RM 定義を使用した新しいサーバー構成および作業ディレクトリー構造をセットアップすることにより、要求管理 (RM) サーバーを構成します。 サンプル・メンバーの手順に従ってください。
  7. 以下のステップを実行して、3.0.1.x アプリケーションを WebSphere Application Server からアンインストールします。
    1. WebSphere Application Server Integrated Solutions Console (https://example.com:9043/ibm/console/logon.jsp) にログオンします。
    2. 「アプリケーション」 > 「アプリケーション・タイプ」 > 「WebSphere エンタープライズ・アプリケーション」をクリックします。
    3. バージョン 4 のアプリケーション用に再作成できるように、以下のバージョン 3.0.1.x アプリケーションのセキュリティー・ロールのマッピングをメモしてください。
      • jts_war
      • ccm_war
      • qm_war
    4. 以下の 3.0.1.x アプリケーションを停止してアンインストールします。
      • jts_war
      • ccm_war
      • qm_war
      • rm_war
      • clmhelp_war
      • admin_war
    5. プロンプトが表示されたら、変更内容をマスター構成に保存します。
  8. 以下のステップを実行して、JAZZ_HOME と log4j.configuration のカスタム・プロパティーを更新します。
    1. WebSphere Application Server Integrated Solutions Console (https://example.com:9043/ibm/console/logon.jsp) にログオンします。
    2. 「サーバー」 > 「サーバー・タイプ」 > 「WebSphere Application Server」をクリックします。
    3. サーバー名をクリックして開きます。デフォルトのサーバー名は「server1」です。
    4. 「サーバー・インフラストラクチャー」セクションで、「Java およびプロセス管理」> 「プロセス定義」を選択します。
    5. 「追加プロパティー」の下で、「Java 仮想マシン」を選択します。
    6. 「追加プロパティー」で「カスタム・プロパティー」を選択します。
    7. JAZZ_HOME を選択し、その値を file:///<4.0_configuration_dir> になるように更新します。 例えば、file:///etc/jazz40。
    8. log4j.configuration を選択し、その値を file:///<4.0_configuration_dir>/startup_log4j.properties になるように更新します。 例えば、file:///etc/jazz40/startup_log4j.properties。
    9. プロンプトが表示されたら、変更内容をマスター構成に保存します。
    詳しくは、WebSphere Application Server のセットアップを参照してください。
  9. WebSphere Application Server を停止します。
  10. 以下のステップを実行して、WebSphere の一時ファイルとディレクトリーを削除し、キャッシュをクリアします。
    1. WebSphere Application Server プロファイルの下にある一時ディレクトリー (通常、<WAS_profile_root>/temp/<node_name>/<server_name> など) に移動し、<application>_war ディレクトリーをすべて削除します。
    2. <WAS_profile_root>/temp/wscache に移動し、<application>_war がある場合、それを削除します。
  11. JTS サーバー構成をマイグレーションします。リポジトリー・ツールを使用して、バージョン 4 の SBLZSAMP サンプル・メンバー BLZJTSU を変更することにより、JTS 用のバージョン 3.0.1.x の構成ファイルの設定をバージョン 4 の構成ファイルにマージします。BLZJTSU ジョブを実行依頼する前に、以下のステップを完了してください。
    1. 以下のパラメーターを含む行を削除します。
      oldTomcatHome
      newTomcatHome 
    2. 以下の行を updateTomcatFiles=yes から updateTomcatFiles=no に変更します。
    3. @pathPrefix@ 変数を、バージョン 4 のバイナリー・ファイルのパス接頭部を指すように置換します。
      注: このサンプル・メンバーによって使用される migration_jts_updateConfigurationFiles リポジトリー・ツール・コマンドは、バージョン 3.0.1 で追加されました。@pathPrefix@ が前のバージョンを指している場合、リポジトリー・ツール・コマンドはバージョン 4 の更新コマンドを使用しません。
    4. サンプル BLZJTSU ジョブの手順を完了します。
    BLZJTSU ジョブを実行依頼し、ジョブ出力と更新されたプロパティー・ファイルを確認します。
    注: Derby データウェアハウスを指すデータウェアハウスのプロパティーはこのマージの一部として保持されますが、後のステップで対処されます。
  12. CCM サーバー構成をマイグレーションします。リポジトリー・ツールを使用して、バージョン 4 の SBLZSAMP サンプル・メンバー BLZCCMU を変更することにより、CCM 用のバージョン 3.0.1.x の構成ファイルの設定をバージョン 4 の構成ファイルにマージします。BLZCCMU ジョブを実行依頼する前に、以下のステップを完了してください。
    1. 以下のパラメーターを含む行を削除します。
      oldTomcatHome
      newJTSTomcatHome 
      newApplicationTomcatHome
    2. 以下の行を updateTomcatFiles=yes から updateTomcatFiles=no に変更します。
    3. 以下の行を applicationContextRoot=jazz から applicationContextRoot=ccm に変更します。 バージョン 3.0.1.x のサーバーがバージョン 2.x からマイグレーションされたのでない限り、アプリケーション・コンテキストは /ccm になります。
    4. @pathPrefix@ 変数を、バージョン 4 のバイナリー・ファイルのパス接頭部を指すように置換します。
      注: このサンプル・メンバーによって使用される migration_ccm_updateConfigurationFiles リポジトリー・ツール・コマンドはバージョン 3.0.1.x で追加されました。@pathPrefix@ が前のバージョンを指している場合、リポジトリー・ツール・コマンドはバージョン 4 の更新コマンドを使用しません。
    5. サンプル BLZCCMU ジョブの手順を完了します。
    BLZCCMU ジョブを実行依頼し、ジョブ出力と更新されたプロパティー・ファイルを確認します。
    注: Derby データウェアハウスを指すデータウェアハウスのプロパティーはこのマージの一部として保持されますが、後のステップで対処されます。
  13. QM サーバー構成をマイグレーションします。リポジトリー・ツールを使用して、バージョン 4 の SBLZSAMP サンプル・メンバー BLZQMU を変更することにより、QM 用のバージョン 3.0.1.x の構成ファイルの設定をバージョン 4 の構成ファイルにマージします。BLZQMU ジョブを実行依頼する前に、以下のステップを完了してください。
    1. 以下のパラメーターを含む行を削除します。
      oldTomcatHome
      newJTSTomcatHome 
      newApplicationTomcatHome
    2. 以下の行を updateTomcatFiles=yes から updateTomcatFiles=no に変更します。
    3. @pathPrefix@ 変数を、バージョン 4 のバイナリー・ファイルのパス接頭部を指すように置換します。
      注: このサンプル・メンバーによって使用される migration_qm_updateConfigurationFiles リポジトリー・ツール・コマンドはバージョン 3.0.1.x で追加されました。@pathPrefix@ が前のバージョンを指している場合、リポジトリー・ツール・コマンドはバージョン 4 の更新コマンドを使用しません。
    4. サンプル BLZQMU ジョブの手順を完了します。
    BLZQMU ジョブを実行依頼し、ジョブ出力と更新されたプロパティー・ファイルを確認します。
    注: Derby データウェアハウスを指すデータウェアハウスのプロパティーはこのマージの一部として保持されますが、後のステップで対処されます。
  14. RM サーバー構成をマイグレーションします。リポジトリー・ツールを使用して、バージョン 4 の SBLZSAMP サンプル・メンバー BLZRMU を変更することにより、RM 用のバージョン 3.0.1.x の構成ファイルの設定をバージョン 4 の構成ファイルにマージします。BLZRMU ジョブを実行依頼する前に、以下のステップを完了してください。
    1. 以下のパラメーターを含む行を削除します。
      oldTomcatHome
      newJTSTomcatHome 
      newApplicationTomcatHome
    2. 以下の行を updateTomcatFiles=yes から updateTomcatFiles=no に変更します。
    3. @pathPrefix@ 変数を、バージョン 4 のバイナリー・ファイルのパス接頭部を指すように置換します。
      注: このサンプル・メンバーによって使用される migration_rm_updateConfigurationFiles リポジトリー・ツール・コマンドはバージョン 3.0.1.x で追加されました。@pathPrefix@ が前のバージョンを指している場合、リポジトリー・ツール・コマンドはバージョン 4 の更新コマンドを使用しません。
    4. サンプル BLZRMU ジョブの手順を完了します。
    BLZRMU ジョブを実行依頼し、ジョブ出力と更新されたプロパティー・ファイルを確認します。
    注: Derby データウェアハウスを指すデータウェアハウスのプロパティーはこのマージの一部として保持されますが、後のステップで対処されます。
  15. 以下のステップを完了して、索引ファイルをコピーします。
    1. バージョン 3.0.1.x からバージョン 4 に JFS/text 索引をコピーします。分散システムの場合は、該当するサーバーに移動してこれらのファイルをコピーします。
      • コマンド・プロンプトを開き、以下のコマンドを入力して、デフォルトの 4.0 索引ディレクトリーをクリアします。
        rm -rf <4.0_configuration_dir>/jts/indices
        rm -rf <4.0_configuration_dir>/ccm/indices
        rm -rf <4.0_configuration_dir>/qm/indices
      • コマンド・プロンプトを開き、以下のコマンドを入力して、バージョン 3.0.1.x からバージョン 4 に索引をコピーします。
        cp -R <3.0.1.x_configuration_dir>/jts/indices <4.0_configuration_dir>/jts/indices
        cp -R <3.0.1.x_configuration_dir>/ccm/indices <4.0_configuration_dir>/ccm/indices
        cp -R <3.0.1.x_configuration_dir>/qm/indices <4.0_configuration_dir>/qm/indices
      com.ibm.team.fulltext.indexLocation および com.ibm.team.jfs.index.root.directory のロケーション情報が正しくなるように、JTS、CCM、および QM の teamserver.properties ファイルを編集します。
  16. JTS データベースをアップグレードします。リポジトリー・ツールを使用し、バージョン 4 の SBLZSAMP サンプル・メンバー BLZADDTB のコピーを変更および実行依頼して、4.0 のデータベース表を JTS リポジトリーに追加します。アプリケーション変数 @appl@ は jts に設定する必要があります。サンプル・メンバーに含まれている手順に従って、ジョブの出力を注意深く確認します。
  17. CCM データベースをアップグレードします。CCM アプリケーションを構成した場合は、リポジトリー・ツールを使用し、バージョン 4 の SBLZSAMP サンプル・メンバー BLZADDTB のコピーを変更および実行依頼して、CCM リポジトリーに 4.0 のデータベース表を追加します。アプリケーション変数 @appl@ は ccm に設定する必要があります。サンプル・メンバーに含まれている手順に従って、ジョブの出力を注意深く確認します。
  18. QM データベースをアップグレードします。QM アプリケーションを構成した場合は、リポジトリー・ツールを使用して、バージョン 4 の SBLZSAMP サンプル・メンバー BLZADDTB のコピーを変更および実行依頼することにより、QM リポジトリーに 4.0 のデータベース表を追加します。アプリケーション変数 @appl@ は qm に設定する必要があります。サンプル・メンバーに含まれている手順に従って、ジョブの出力を注意深く確認します。
  19. オプション: データウェアハウスを構成します。データウェアハウス・リポジトリーの設定を含めるように、JTS、CCM および QM の teamserver.properties ファイルを編集します。同じ設定が、3 つのファイルすべてに適用されます。
    重要: 今スタンドアロンのデータウェアハウスを実装しない場合は、このステップをスキップすることができます。ただし、このステップをスキップした場合は、Jazz Team Server セットアップ・ウィザードを使用する際にデータウェアハウス構成ステップをスキップする必要があります。
    今データウェアハウスを構成する場合は、db2z データウェアハウスのパラメーターを組み込み、既存の Derby データウェアハウスのプロパティーをすべて除去するように、JTS、CCM、および QM の 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 
  20. データウェアハウスをアップグレードします。データウェアハウスを構成した場合は、リポジトリー・ツールを使用して、バージョン 4 の SBLZSAMP サンプル・メンバー BLZDWHUP のコピーを変更および実行依頼することにより、データウェアハウスのリポジトリーをアップグレードします。サンプル・メンバーに含まれている手順に従って、ジョブの出力を注意深く確認します。
  21. WebSphere Application Server を開始します。
  22. 以下のステップを実行して、WebSphere Application Server にバージョン 4 の war ファイルをデプロイします。
    1. WebSphere Application Server Integrated Solutions Console (https://example.com:9043/ibm/console/logon.jsp) にログオンします。
    2. 「アプリケーション」 > 「アプリケーション・タイプ」 > 「WebSphere エンタープライズ・アプリケーション」を選択して、「エンタープライズ・アプリケーション」ページを開きます。
    3. 以下のバージョン 4 の .war ファイルをインストールします。
      • jts.war
      • ccm.war
      • qm.war
      • rm.war
      • clmhelp.war
      • admin.war
    4. 以下のバージョン 4 のアプリケーションのセキュリティー・ロールを、前のステップでアンインストールした際に書き留めたメモに従ってマップします。
      • jts_war
      • ccm_war
      • qm_war
  23. WebSphere Application Server Integrated Solutions Console からアプリケーションを開始します。
    • jts_war
    • ccm_war
    • qm_war
    • rm_war
    • clmhelp_war
    • admin_war
  24. ブラウザーを開き、以下の URL を貼り付けて、サーバーをリセットします。
    https://jts_server.mydomain.com:9443/jts/admin#action=com.ibm.team.repository.admin.serverReset
    https://ccm_server.mydomain.com:9443/ccm/admin#action=com.ibm.team.repository.admin.serverReset
    https://qm_server.mydomain.com:9443/qm/admin#action=com.ibm.team.repository.admin.serverReset
    注: サーバーのリセットを有効にするには、サーバーを再始動する必要があります。
  25. 以下のステップを完了してライセンスをアクティブにします。
    1. 4.0 Jazz Team Server に管理者としてログインします。
    2. 「サーバー管理」> 「ライセンス・キーの管理」ページにナビゲートして、ライセンスをアクティブにします。
      注: 4.0 システムではすべてが既にセットアップ済みのため、セットアップを実行する必要はありません。
    ライセンスに関する注意:
    • マイルストーンのリリースでは、マイルストーンに同梱されている早期アクセス・ライセンスをアクティブにする必要があります。
    • バージョン 4.0 の最終リリースでは、新規ライセンスを購入する必要があります。バージョン 4 のライセンスはバージョン 3 のアプリケーションと互換性がありますが、バージョン 4 のアプリケーションはバージョン 3 のライセンスでは動作しません。詳しくは、ライセンスの管理を参照してください。
  26. Rational Requirements Composer (RRC) をマイグレーションします。RM アプリケーションを構成している場合は、以下のステップを完了して、RM オンライン・マイグレーション・ユーティリティーを実行する必要があります。
    1. ブラウザーを開き、ブラウザーのキャッシュをクリアして、RM Web クライアントにナビゲートします。 次の URL でサーバー名とポート番号を指定します: https://server_name:port/rdm/web/projects/migration。 デフォルトのポートは 9443 です。マイグレーションが進行中であることがこのページによって検出され、マイグレーション・ウィザードが開始されます。
    2. Rational Requirements Composer - Analyst Client Access のライセンスを受諾します。
    3. 「マイグレーション保守パネルを開く」をクリックし、マイグレーション・ウィザードを選択して Rational Requirements Composer のマイグレーションを開始します。 マイグレーションの進行中は、どのストレージ域が処理中か、およびいつ索引付けが開始されるかに関する状況が、マイグレーション Web ページで管理者に報告されます。
      重要: マイグレーション開始後は、マイグレーションが完了するまでこの操作を取り消すことはできません。
      マイグレーションが完了したら、Rational Requirements Composer データの再索引付けが行われます。
    4. 再索引付けが完了すると、アプリケーションがマイグレーション・データに対して検証および整合性検査を実行し、管理者にフィードバックを戻します。
    5. マイグレーションが完了したことを示すメッセージが表示されたら、「閉じる」をクリックします。それにより、RRC アプリケーションにリダイレクトされます。
    詳しくは、『オンライン・マイグレーション・アップグレード手順』を参照してください。

フィードバック