マッピング・ファイルの準備

このトピックでは、後に CLM サーバーの実際の名前変更で使用するマッピング・ファイルの準備方法について説明します。 サーバーがまだオンラインの間、実際の名前変更を行う前に、マッピング・ファイルを準備して検討することができます。

始める前に

重要: サーバーの名前変更機能は、CLM バージョン 4 のフィーチャーです。したがって、サーバーの名前変更を実行する前に、Jazz™ Team Server とすべての CLM アプリケーションをバージョン 4 にアップグレードする必要があります。

このタスクについて

サーバーを実際に名前変更する前に実行する必要があるいくつかのステップがあります。これには主に、名前変更操作の実行に使用するマッピング・ファイルの準備と検討が含まれます。マッピング・ファイルには、既存のソース URL とデプロイメント内の名前変更後のターゲット URL がリストされます。これらの URL には、Jazz Team Server、CLM アプリケーション、CLM ヘルプの WAR ファイル、および影響を受けるその他すべてのアプリケーションの URL が含まれます。サンプルのトポロジー・ダイアグラムおよびマッピング・ファイルについては、テスト・ステージング環境をセットアップするためのトポロジーおよびマッピング・ファイルを参照してください。

これらのステップは、Jazz Team Server と CLM アプリケーションがすべて同じコンピューターにインストールされる一体型の CLM デプロイメント、または複数の CLM アプリケーションがそれぞれ異なるコンピューターにインストールされる分散デプロイメントの両方で実行できます。これらの準備ステップは、例えば、コンピューターを新しい物理的ロケーションに移動する場合、新しいコンピューターにテスト・サンドボックスをセットアップする場合、または新しいコンピューターでの名前変更済み環境が関連するデータ・センター統合のケースなど、さまざまなシナリオで使用できます。

For z/OS operating system 注: サーバーの名前変更は z/OS® でサポートされていますが、マッピング・ファイルの作成プロセスでいくつかの違いがあります。詳しくは、z/OS でのサーバーの名前変更を参照してください。

手順

  1. 名前変更に関連するすべてのサーバーをバージョン 4 にアップグレードした後は、Jazz Team Server (JTS) を開始し、アプリケーションがサーバーに正しく登録されていることを確認します。
    1. Jazz Team Server の「管理」ページにログインします。 Web ブラウザーに https://hostname:port/jts/admin と指定します。
    2. 「サーバー」タブをクリックします。
    3. 左ペインの「構成」セクションで、「登録済みアプリケーション」をクリックします。
    4. すべてのアプリケーションが登録されていることを確認します。

    詳しくは、Jazz Team Server へのアプリケーションの登録を参照してください。

  2. Jazz Team Server がインストールされているコンピューターでコマンド・プロンプトを開き、JazzInstallDir¥server ディレクトリーに移動します。
    注: 新しいハードウェアに移動する場合でも、このステップと以下のステップは必ず元の Jazz Team Server で実行してください。
  3. 以下に示すように、repotools-jts -generateURLMappings コマンドを使用して、以降の編集のためのテンプレートとして使用する初期マッピング・ファイルを生成します。既にこのコマンドを実行している場合、またはこのファイルが既に存在する場合は、overwrite=true パラメーターを追加してください。
    注: UNIX 用として示されているすべての例は、Linux 用としても有効です。
    • For Windows operating system repotools-jts.bat -generateURLMappings toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword>
    • For Unix operating systems ./repotools-jts.sh -generateURLMappings toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword>

    このコマンドの出力は、Jazz Team Server、および Jazz Team Server に登録されている各 CLM アプリケーション (CCM、QM、および RM) の既存のソース・パブリック URL とデフォルトのターゲット URL をリストするマッピング・ファイルです。このファイルでは、CLM ヘルプの WAR ファイルおよび影響を受けるすべての既知の外部システムのソース URL とターゲット URL も特定されます。

    JazzInstallDir/server/repotools-jts_generateURLMappings.log のログ・ファイルにエラーが記録されていないことを確認します。

  4. 生成されたマッピング・ファイルを注意深く検討して編集します。ホスト名、ポート、またはルート・コンテキストにタイプミスがないか確認します。これらのタイプミスのいくつかはサーバー名前変更ツールで検出できず、そのために製品が機能しなくなる場合があります。

    サーバー名前変更によって使用されるマッピング・ファイルの理解のトピックを検討して、マッピング・ファイルの構造をよく理解してください。生成されたマッピング・ファイルを注意深く検討して編集します。

    1. 名前変更するすべてのアプリケーションと CLM ヘルプ WAR ファイルのソースとターゲットのペアがあることを確認します。
    2. 名前変更する項目の target= urls を、正しいターゲットになるように編集します。
      注: JTS またはその他のアプリケーションのポート番号を名前変更する場合は、名前変更の 後で、かつサーバーを再始動する前に、アプリケーション・サーバーでポート情報を更新する必要があります。詳細情報については、アプリケーション・サーバーのポート番号の変更を参照してください。JTS またはその他のアプリケーションのコンテキスト・ルートを名前変更する場合は、コンテキスト・ルートの変更を参照してください。
    3. 「#」を使用して、名前変更しない URL の source-> target ペアをコメント化します。
    4. 影響のある URL のリストを検討します。コマンドは、デプロイメント内のすべての既知の URL を検索しますが、いくつかが欠落する可能性があります。環境について何らかの懸念がある場合には、名前変更を進める前に管理者に相談してください。
    注: 実際の名前変更に進む前に CLM デプロイメントに対して構成変更を行った場合は、マッピング・ファイルの再生成が必要になります。
  5. ユーザーのシナリオに新しいハードウェアが含まれている場合は、新しいコンピューターに CLM バージョン 4 をインストールしてください。Jazz セットアップ・ウィザードを実行したり、Jazz Team Server を開始したりしない でください。 Jazz Team Server および Rational solution for Collaborative Lifecycle Management アプリケーションのインストールを参照してください。

次のタスク

サーバーの名前変更に進みます。詳しくは、サーバー名前変更を使用した、パイロット・デプロイメントから実動への移動または 実動データを使用したテスト・ステージング環境のセットアップを参照してください。

フィードバック