実動データを使用したテスト・ステージング環境のセットアップ

このトピックでは、実際の実動データを使用してステージング環境を準備するための、サーバー名前変更フィーチャーの使用方法について説明します。ステージング環境とは、実稼働環境から切り離されたテスト・サンドボックスです。これを使用すると、実際のデータを使用し、実動データベースに影響を与えずに、新しいフィーチャーまたは機能を試すことができます。

このタスクについて

重要: この手順は、前のリリースからユーザー環境をアップグレードするためには使用 できません。サーバー名前変更はバージョン 4 およびそれより新しいリリースでのみサポートされているため、サーバー名前変更を使用してステージング環境をセットアップするためには、バージョン 4 へのアップグレードが前提条件になります。

サーバー名前変更フィーチャーは、マッピング・ファイルを使用して、名前変更が必要な URL を判別します。初期マッピング・ファイルを自動的に生成するための repotools コマンドが提供されています。このマッピング・ファイルには、Jazz™ Team Server およびすべてのアプリケーションのソースとターゲットのペアのほか、それらのアプリケーションによってコントリビュートされている他のすべての URL が含まれています。マッピング・ファイルの追加情報については、サーバー名前変更によって使用されるマッピング・ファイルの理解を参照してください。サンプルのトポロジー・ダイアグラムおよびマッピング・ファイルについては、テスト・ステージング環境をセットアップするためのトポロジーおよびマッピング・ファイルを参照してください。

ステージング環境を計画する場合は、実動データに影響を及ぼさないように (またはその逆についても) 特に注意する必要があります。これを実現するには、2 つの方法があります。1 つは、ご使用環境で許可されている場合、hosts ファイルに項目を追加する方法です。そしてもう 1 つは、ステージング環境にないサーバーをマスクするためのマッピングを作成する方法です。マッピングには、実動サーバーに接続されている可能性がある追加の CLM サーバーまたは CLM 以外の製品も必ず含めてください。詳細については、ステップ 3.c とステージング環境のためのダミー・マッピングを参照してください。

例えば、ある実動サーバー内に変更管理と構成管理 (CCM) アプリケーションがあり、そこから別の実動サーバー内の CCM へのリンクと、さらに別の実動サーバー内の品質管理 (QM) へのリンクがある場合があります。さらに、Rational® ClearQuest® などの、CLM 以外の製品との統合がある可能性もあります。この場合は、最初に追加の CCM サーバーと QM サーバーの URL をマスクし、さらに Rational ClearQuest の URL もマスクされているか、あるいはステージングされた Rational ClearQuest ゲートウェイ・サーバーにマップされていることを確認する必要があります。

重要: Rational Team Concert クライアントを実動リポジトリーとステージング・リポジトリーの両方に接続しないでください。ステージング・サーバーへの接続には、常にステージング・ワークスペースを使用してください。

以下のダイアグラムには、サーバー名前変更を使用してステージング環境をセットアップするために必要な主要なステップが表示されています。最新バージョンの CLM (バージョン 4) と RRDI (バージョン 2) がインストール済みであることを前提としています。

実動からステージングへのシナリオ

手順

  1. マッピング・ファイルの準備のトピックで説明されているステップに従って、名前変更の準備を行ってください。

    影響を受けるすべての URL のダミー・マッピングをマッピング・ファイルに作成してください。これは、ステージング環境と実稼働環境の間でクロスリンクが発生するのを避けるために行います。詳しくは、ステージング環境のためのダミー・マッピングを参照してください。

    準備フェーズの最終結果として、元のソース Jazz Team Server にマッピング・ファイルが生成されます。マッピング・ファイルを慎重に検討して編集したら、それをステージング環境内のターゲット Jazz Team Server の JazzInstallDir¥server ディレクトリーにコピーします。

  2. バージョン 4 の実稼働環境をバックアップし、テキスト索引とアプリケーション構成ファイルをターゲットのステージング・サーバーにコピーします。

    これらのステップを実行している間は実動サーバーを停止する必要があるため、できればステージング環境をセットアップする直前など、都合のいい時間を選択してバックアップを実行してください。実際の名前変更に進む前に実稼働環境に対して変更を行った場合は、マッピング・ファイルをステージング・サーバーにインポートする前に再生成する必要があります。サーバーが停止している間、ユーザーは、名前変更しようとしている CLM デプロイメントに統合されている外部システムからのリンクを作成したりトラバースしたりすることはできません。

    1. Jazz Team Server と、実稼働環境にある Jazz Team Server に登録されているすべての分散 CLM アプリケーションを停止します。
    2. Jazz Team Server データベース、CCM および QM アプリケーションのデータベース、データウェアハウス・データベース、および RRDI コンテンツ・ストア・データベースを含め、CLM 4.0 の実稼働環境内のすべてのデータベースをバックアップします。CLM データベースの移動のステップに従って、実稼働環境からステージング環境にデータベースをコピーします。
    3. JFS/text 索引をソースのステージング・サーバーからターゲットのサンドボックス・サーバーにコピーします。(分散システムの場合は、該当するサーバーに移動してファイルをコピーします。)

      以下の Linux サーバーの例は、ステージング・コンピューターのドライブがネットワーク・マウントされていることを前提としています。ご使用環境でこれが可能でない場合は、他のファイル転送方法を使用してファイルが確実にコピーされるようにしてください。

      cp -R SourceJazzInstallDir/server/conf/jts/indices TargetJazzInstallDir/server/conf/jts
      cp -R SourceJazzInstallDir/server/conf/ccm/indices TargetJazzInstallDir/server/conf/ccm
      cp -R SourceJazzInstallDir/server/conf/qm/indices TargetJazzInstallDir/server/conf/qm
    4. アプリケーション構成ファイルをソースの実動サーバーからターゲットのステージング・サーバーにコピーします。 (分散システムの場合は、該当するサーバーに移動してファイルをコピーします。)前のステップと同様に、以下の例は Linux サーバー用で、ステージング・コンピューターのドライブがネットワーク・マウントされていることを前提としています。
      cp SourceJazzInstallDir/server/conf/jts/teamserver*.properties  TargetJazzInstallDir/server/conf/jts
      cp SourceJazzInstallDir/server/conf/ccm/teamserver*.properties  TargetJazzInstallDir/server/conf/ccm
      cp SourceJazzInstallDir/server/conf/qm/teamserver*.properties  TargetJazzInstallDir/server/conf/qm
      cp SourceJazzInstallDir/server/conf/admin/admin.properties*  TargetJazzInstallDir/server/conf/admin
      cp SourceJazzInstallDir/server/conf/admin/friends.rdf*  TargetJazzInstallDir/server/conf/admin
      cp SourceJazzInstallDir/server/conf/rm/fronting.properties  TargetJazzInstallDir/server/conf/rm
      cp SourceJazzInstallDir/server/conf/rm/friendsconfig.rdf  TargetJazzInstallDir/server/conf/rm
    5. マッピング・ファイルを、実動サーバーの TargetJazzInstallDir¥server ディレクトリーにコピーします。マッピング・ファイルについて詳しくは、マッピング・ファイルの準備を参照してください。
      注: 次のステップを実行する前に CLM デプロイメントに対して構成変更を行った場合は、マッピング・ファイルの再生成が必要になります。
    6. すべての CLM サーバーを再始動し、ユーザーが実稼働環境の使用を継続できるようにします。残りのステップはすべてステージング・テスト環境に適用されます。
  3. ステージング・テスト環境で以下のステップを実行します。
    1. データベース・バックアップを実稼働環境からステージング環境に復元します。実動データベース・サーバーにストレスを与えないように、ステージング環境では別のデータベース・サーバーを使用することをお勧めします。
    2. テスト環境内のデータベースのステージング・コピーの接続パラメーターを指すように、JazzInstallDir/server/conf/applicationName/teamserver.properties ファイル内のデータベース接続パラメーターを置き換えます。これらには、jts データベース、ccm および qm アプリケーションのデータベース、データウェアハウス・データベース、および更新されたパスワードなどの各項目が含まれます。
    3. マッピング・ファイル内のダミー・マッピングに対する追加の予防措置として、ご使用環境で許可される場合は、実動システムの URL へのアクセスを防止し、実動サーバー内の成果物を誤って編集してしまうことを防止するために、hosts ファイルを更新してください。

      ここでの目標は、ホスト名を、実稼働環境内のどの CLM サーバーにも使用されていない偽の IP アドレスに解決することです。それにより、ステージング環境内のサーバーが実動サーバーへの接続を確立しようとした場合、その接続は失敗します。

      マッピング・ファイルに含まれているすべての別々のホスト名のリストを作成します。これらは、ソース URL または影響を受ける URL の可能性があります。個々のホスト名ごとに、ホスト名を偽の IP アドレスにマップする項目を hosts ファイル内に作成します。サード・パーティー・サーバーおよびクライアント・ワークステーションを含め、ステージング環境内のすべてのサーバーの hosts ファイルを編集する必要があります。以下の host ファイルは、ステージング・サーバーのサンプル項目を示しています。

       # 10.10.10.10 refers to an IP address that does not host a clm application. 
        10.10.10.10   ProductionServerP1
        10.10.10.10   ProductionServerP2
        10.10.10.10   ProductionServerP3
    4. JazzInstallDir¥server ディレクトリーでコマンド・プロンプトを開き、repotools-jts -importURLMappings コマンドを使用してマッピング・ファイルをターゲットの Jazz Team Server にインポートします。
      • オールインワン・デプロイメントの場合は、以下に示すように、repotools-jts -importURLMappings コマンドを使用してマッピング・ファイルをインポートします。

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="opt/mappings.txt"

        名前変更は、サーバーを再始動する前に、Jazz Team Server でオフラインで開始されます。

      • 分散デプロイメントの場合で、ネットワーク・ドライブのマップが許可されている場合は、Jazz Team Server ホストから各アプリケーション・ホストにネットワーク・ドライブをマップします。それから、以下のフォーマットで、デプロイメント内のリモート server/conf ディレクトリーのリストを含むファイル (例えば、serverConfFile.txt) を作成します。
         # Remote CCM server
           x:/JazzTeamServer/server/conf
           # Remote QM server
           y:/JazzTeamServer/server/conf
           # Remote RM server
           z:/JazzTeamServer/server/conf

        最後に、以下に示すように、repotools-jts -importURLMappings コマンドを実行し、serverConfFile= パラメーターを追加します。

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:¥mappings.txt" serverConfFile="C:¥serverConf.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="/opt/mappings.txt" serverConfFile="/opt/serverConf.txt"

      • 分散 CLM デプロイメントの場合で、ネットワーク・ドライブの再マップが許可されていない場合は、以下に示すように、repotools-jts -importURLMappings コマンドを実行してください。

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="opt/mappings.txt"

        それから、server/conf/jts/.mappingEvent ファイルをリモート・アプリケーションの構成ディレクトリー (server/conf/application_name、ここで、application_name は ccm、qm、および rm です) にコピーします。.mappingEvent ファイルを、マッピング・ファイルのインポート後で、かつサーバーの開始前にコピーする必要があります。

        .mappingEvent ファイルには、アプリケーションが新しいロケーションで Jazz Team Server に接続するために必要な情報が含まれています。.mappingEvent ファイルの内容は、Jazz Team Server およびその登録済みアプリケーションで、同じです。

      コンソールの出力と server/repotools-jts_importURLMappings.log ファイルを調べることにより、名前変更が正常に行われたことを確認します。エラーが表示されている場合、またはマッピング・ファイルに間違いがあったことを認識した場合は、サーバー名前変更のトラブルシューティングを参照して、問題を特定して修正してください。

      注: z/OS® で稼働しているサーバーは、サンプル JCL メンバー HLQ.SBLZSAMP(BLZRENAM) を使用して名前変更します。詳細なカスタマイズ手順については、BLZRENAM のコメント・ヘッダーを参照してください。
  4. Jazz Team Server と、Jazz Team Server に登録されているすべての分散 CLM アプリケーションを開始します。

    この時点で CLM アプリケーションは Jazz Team Server と同期して、URL マッピングを適用し、それらのデータウェアハウスのデータを更新します。小さいデータ・セットの場合、これには 5 分ほどかかります。非常に大きいデータ・セットの場合は、30 分以上かかります。

  5. Jazz Team Server ( https://new host:port/jts/serverRenameStatus) にログインして、名前変更の状況を確認します。

    すべてのアプリケーションの名前変更が完了し、サーバーの名前変更のファイナライズ・ステップが完了するまで待ちます。次のメッセージが表示されることを確認します: サーバー名前変更が正常に完了しました。Jazz Team Server およびアプリケーションは完全に操作可能です。サーバーは即時使用開始できます。再始動は必要ありません。

    エラーが表示される場合は、サーバー名前変更のトラブルシューティングを参照して問題を特定して修正してください。

    注: 名前変更が完了する前にいずれかの CLM アプリケーションの Web UI にログインしようとすると、この状況ページにリダイレクトされます。
  6. サーバー名前変更の確認に記載されているサーバー名前変更の検証ステップを実行します。
    注: 実稼働環境を保護するためにダミー・マッピングを導入している場合は、ステージング・サーバーの「アプリケーション診断」ページの「アプリケーションおよびフレンド」セクションに、これらの URL に関するエラーが表示されます。
  7. オプション: 以下のステップを実行して、ステージング環境内に Rational Reporting for Development Intelligence (RRDI) を構成します。
    1. ステージング環境への RRDI の新規インストールのために、以下のデータベースを実稼働環境からバックアップして、新しいデータベース・サーバーに復元します。
      • コンテンツ・ストア・データベース (例えば、RICM)
      • データウェアハウス (例えば、RIDW。これが、まだバックアップされて復元されていない場合)。
    2. Rational Reporting for Development Intelligence バージョン 2.0 をステージング環境にインストールします。詳細については、Installation Manager を使用した Rational Reporting for Development Intelligence のインストールを参照してください。
    3. RRDI セットアップ・アプリケーションを実行してレポート・サーバーを構成します。詳細については、ポストインストール・タスクを参照してください。以下のアクションを忘れずに実行してください。
      • 「コンテンツ・ストア・データベースの構成」ページで、ステップ 7.a で復元したコンテンツ・ストア・データベースの接続プロパティーを指定します (例えば、RICM)。
      • 「データウェアハウスの構成」ページで、ステップ 7.a で復元したデータウェアハウス・データベースの接続プロパティーを指定します (例えば、RIDW)。
    4. Jazz Team Server にログオンし、Jazz Team Server の 「拡張プロパティー」と、CCM および QM の管理ページに保管されているレポート・サーバー URL がステージング RRDI レポート・サーバーを指すように更新します。
      注: このステップは、マッピング・ファイルに RRDI の URL が含まれていない場合にのみ必要です。
    5. 実動 RRDI レポート・サーバーから以前にインポートしたすべてのレポートが引き続き機能することを確認します。
    6. アクションが「最新のレポートの表示」に設定されている Cognos レポートまたはレポート・ビューは、キャッシュされている HTML レポートを更新するために、CLM サーバー名前変更の後に再実行する必要があります。
      1. RRDI レポート・サーバーにログオンします。
      2. キャッシュされている出力バージョンがあるレポートまたはレポート・ビューを探します。
        注: レポートまたはレポート・ビューにキャッシュされた出力バージョンがある場合は、このレポートの「出力バージョンの表示」をクリックすると、キャッシュされたレポートを表示できます。レポートまたはレポート・ビューが CLM サーバー名前変更の前に生成された場合は、レポートまたはレポート・ビューを再実行してそれらを更新する必要があります。そうしないと、それらのレポートまたはレポート・ビューを実行しているユーザーには、古い CLM サーバーを指す失効したリンクが表示されます。
      3. 「オプションを指定して実行」をクリックして、レポートまたはレポート・ビューを再実行します。
      4. レポート・ビューアーで、「このバージョンを保持」 > 「レポートの保存」をクリックして、レポートまたはレポート・ビューに関連付けられた、キャッシュされている出力バージョンを更新します。
    7. ステージング RRDI レポート・サーバーから新規レポートをインポートします。インポートが正常に行われており、インポートされたレポートが問題なく実行されることを確認します。
    8. RRDI で Rational Quality Manager ライブ・レポートを構成している場合は、新規サーバー用の xdc ファイルを生成し、それを 32 ビットの ODBC マネージャーで構成するためのステップに従ってください。詳しくは、ライブ・レポートのセットアップを参照してください。
  8. ステージング環境に、Jazz ビルド・エンジン、Rational Team Concert クライアント、Rational ClearQuest、または Rational ClearCase などの他のコンポーネントを含める場合は、必要な追加ステップを実行してください。詳細情報については、制限および追加情報を参照してください。

フィードバック