サーバー名前変更を使用した、パイロット・デプロイメントから実動への移動

このトピックでは、小規模のパイロット CLM デプロイメントから実動に移動するときにサーバー URL を変更するために必要なステップについて説明します。

始める前に

名前変更を実行する前に、ご使用環境が、パイロットから実動へのシナリオの基準を満たしていることを確認してください。詳しくは、サポートされるシナリオを参照してください。

重要: サーバーの名前変更を実行するには、Jazz™ Team Server およびすべての CLM アプリケーションがバージョン 4 以降である必要があります。

以下のダイアグラムは、名前変更の一般的な流れを示したものです。

パイロットから実動へのシナリオ

このタスクについて

この手順の一部として、パイロット・サーバーから実動サーバーにデータ・ファイルと構成ファイルをコピーします。データベースは移動するのであってコピーするのではないため、実稼働環境が汚染されるのを避けるために、パイロット環境は永久にサービスを停止する必要があります。

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

手順

  1. 実際の名前変更を行う前に、サーバーがまだオンラインの間に、マッピング・ファイルの準備のトピックに記載されているステップに従ってマッピング・ファイルを準備して検討します。

    デプロイメントを新しいコンピューターに移動する場合は、新しいコンピューターでインストールを実行します。同じコンピューターで URL を変更する場合は、既存のインストール済み環境とは別のディレクトリーでインストールを実行します。さらにコンテキスト・ルートも変更する場合は、コンテキスト・ルートの変更を参照してください。

    準備段階の最終結果として、パイロット Jazz Team Server にマッピング・ファイルが生成されます。このマッピング・ファイルには、Jazz Team Server およびすべてのアプリケーションのソースとターゲットのペアのほか、それらのアプリケーションによってコントリビュートされている他のすべての URL が含まれています。

  2. バージョン 4 のパイロット環境をバックアップして、テキスト索引およびアプリケーション構成ファイルを新しいインストール済み環境にコピーします。
    1. Jazz Team Server と、Jazz Team Server に登録されているすべての分散 CLM アプリケーションを停止します。

      さらに、サーバー名前変更の影響を受ける他のすべてのアプリケーション (Jazz ビルド・エンジンなど)、または影響を受ける、サポートされているすべての統合 (Rational Reporting for Development Intelligence (RRDI)、Rational® ClearCase®、または Rational ClearQuest® など) を停止します。

      注: サーバーが停止している間、ユーザーは、名前変更しようとしている CLM デプロイメントに統合されている外部システムからのリンクを作成したりトラバースしたりすることはできません。
    2. Jazz Team Server データベース、CCM および QM アプリケーションのデータベース、データウェアハウス・データベース、および RRDI を使用している場合は 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 ディレクトリーにコピーします。マッピング・ファイルについて詳しくは、マッピング・ファイルの準備を参照してください。
  3. repotools-jts -importURLMappings コマンドを使用して、マッピング・ファイルをターゲットの実動 Jazz Team Server にインポートすることにより、サーバー名前変更のオフライン部分を実行します。
    1. オールインワン・デプロイメントの場合は、以下に示すように、repotools-jts -importURLMappings コマンドを使用してマッピング・ファイルをインポートします。
      • For Windows operating system repotools-jts.bat -importURLMappings fromFile=".¥mappings.txt"
      • For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="./mappings.txt"

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

    2. 分散デプロイメントの場合で、ネットワーク・ドライブのマップが許可されている場合は、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=".¥mappings.txt" serverConfFile=".¥serverConf.txt"
      • For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="./mappings.txt" serverConfFile="./serverConf.txt"
    3. 分散 CLM デプロイメントの場合で、ネットワーク・ドライブの再マップが許可されていない場合は、repotools-jts -importURLMappings コマンドを実行してください (serverConfFile= パラメーターは使用しない)。 それから、server/conf/jts/.mappingEvent ファイルをリモート・アプリケーションの構成ディレクトリー (server/conf/application_name、ここで、application_name は ccm、qm、および rm です) にコピーします。マッピングをインポートすると、イベント・ファイルが生成されます。.mappingEvent ファイルを、マッピング・ファイルのインポート後で、かつサーバーの開始前にコピーする必要があります。

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

    注: z/OS® で稼働しているサーバーは、サンプル JCL メンバー HLQ.SBLZSAMP(BLZRENAM) を使用して名前変更します。詳細なカスタマイズ手順については、BLZRENAM のコメント・ヘッダーを参照してください。

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

  4. Jazz Team Server と、インストールされているすべての分散 CLM アプリケーションを開始します。

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

  5. https://hostname:port/jts/serverRenameStatus (例えば、https://clmhost.production.example.org:9443/jts/serverRenameStatus) で Jazz Team Server にログインし、名前変更の進行状況をトラッキングします。このページは、名前変更が完了するまで自動的に最新表示されます。

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

    注: 名前変更が完了する前にいずれかの CLM アプリケーションの Web UI にログインしようとすると、この状況ページにリダイレクトされます。
  6. サーバー名前変更の確認に記載されているサーバー名前変更の検証ステップを実行します。
  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 レポート・サーバーを指していることを確認します。実動システムを指していない場合は、それらを指すように更新してください。
      注: マッピング・ファイルにレポート・サーバー 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 Reporting、Rational Team Concert クライアント、Rational ClearQuest、または Rational ClearCase などの他のコンポーネントおよび製品と統合するために必要な、サーバー名前変更後の追加ステップをすべて実行します。 詳しくは、制限および追加情報を参照してください。

フィードバック