ハイブリッド・クラウド上の Engineering Lifecycle Management 用マッピング・ファイルの準備

マッピング・ファイルを用意する必要がある。 IBM® Engineering Lifecycle Management インスタンスのリネームに使用するために必要です。

このタスクについて

サーバー名を変更する前に、いくつかの手順を踏む必要があります。 これには、名前の変更操作に使用するマッピングファイルの準備と見直しも含まれる。 マッピング・ファイルには、既存のソース URL とデプロイメント内の名前変更後のターゲット URL がリストされます。 これには、Jazz® Team Server、アプリケーション、およびその他の影響を受けるアプリケーションの URL が含まれます。 Engineering Lifecycle Management アプリケーション、およびその他の影響を受けるアプリケーションの URL が含まれます。 トポロジー図とマッピングファイルのサンプルについては、「 サーバー名変更用ファイルのマッピング 」を参照してください。

注意： セットアップが完了し、インスタンスがエラーなく動作しているオリジナルのJazz Team Server（本番またはソース）上で以下の手順を実行してください。

手順

  1. 本番インスタンスまたはソースインスタンスの Jazz Team Server アプリケーションポッドで以下の手順を実行し、アプリケーショ ンがサーバーに正しく登録されていることを確認します。
    1. Jazz Team Server の管理ページにログインします。 ウェブ・ブラウザでhttps://hostname:port/jts/admin にアクセスしてください。
    2. Server] タブを開き、 [Configuration] セクションで[ Registered Applications ]をクリックする。
    3. すべてのアプリケーションが登録されていることを確認し、詳細については「 Jazz Team Serverへのアプリケーションの登録 」を参照してください。
  2. ディレクトリ /elm/server の Jazz Team Server アプリケーションポッド端末にアクセスします。 詳細については、 アプリケーションポッド端末へのアクセスを参照してください。
  3. repotools-jts -generateURLMappingsコマンドを使用して初期マッピングファイルを生成し、以後の編集のテンプレートとして使用する。 すでにコマンドを実行しているか、ファイルが存在する場合は、overwrite=true パラメータを追加する。 生成されたファイルを永続ボリュームの場所に保存する。 すなわち elm/backup。
    cd /elm/server 
./repotools-jts.sh -generateURLMappings toFile=/elm/backup/mappings.txt additionalURLFile=/elm/backup/additionalurl.txt \ 
unrenameableURLFile=/elm/backup/unrenameableurls.txt \ 
adminUserId=<adminId> adminPassword=<adminPassword> \ 
repositoryURL=https://source.example.org/jts

    このコマンドの出力は、既存のソース公開 URL、Jazz Team Server用のデフォルトターゲット URL、およびJazz Team Serverに登録されている各アプリケーション をリストしたマッピングファイルです。 Engineering Lifecycle Management Jazz Team Serverに登録されている各アプリケーション CCM, DCC, GC, LQE, QM, ENI, RM, and RB をリストしたマッピングファイルです。

    さらに、マッピングが必要なURLやサードパーティの統合を参照するURLのリストを含む2つ目のファイルも作成される。 これらの URL をマッピング・ファイルに追加できます。 単純なデプロイメントの場合、このファイルに追加 URL が含まれていないことも珍しくありません。 additionalURLFile=additionalurl.txtパラメータを指定すると、このファイルに別の名前を指定できる。 このパラメータの詳細については、 サーバーの名前変更マッピングファイルを生成するリポジトリツールコマンドを参照してください。

    のログファイルにエラーがないことを確認する。/elm/server/repotools-jts_generateURLMappings.log

  4. ホスト名、ポート、ルート・コンテキストのタイプミスを含め、生成されたマッピング・ファイルを注意深く見直し、編集する。 タイプミスの中には、サーバーのリネームツールでは検出できないものもあり、不正な機能を引き起こす可能性があります。 マッピング・ファイルの構造の詳細については、 サーバー名変更用ファイルのマッピングを参照してください。
    1. 名前を変更するすべてのアプリケーションについて、ソースとターゲットのペアが存在することを確認する。
    2. 名前を変更したいエントリーのtarget=urlsを編集して、正しいターゲットにする。
    3. を使い、リネームされたくないURLのソース->ターゲットのペアをコメントアウトする。
    4. 影響のある URL のリストを検討します。 このコマンドは配置内のすべての既知の URL を検索しますが、見落とされる可能性もあります。 これらの影響を受けるURLのいずれかをマッピングする必要がある場合は、影響を受ける URL のソース/ターゲットのペアのコメントを解除し、新しいターゲット URL を指定してください。
    5. additionalurls。 詳細については、 サーバーの名前変更マッピングファイルを生成するリポジトリツールコマンドを参照してください。
    注: アプリケーションの追加登録など、実際の名前の変更を行う前に Engineering Lifecycle Management 注: アプリケーションの追加登録など、実際の名前の変更に進む前に配備の 設定変更が行われた場合は、マッピング ファイルを再生成する必要があります。
  5. repotools-jts -verifyURLMappingsコマンドを使用して、マッピング・ファイルを検証する。
    ./repotools-jts.sh -verifyURLMappings mappingFile=/elm/backup/mappings.txt repositoryURL=<serverURL> adminUserId=<adminId> adminPassword=<adminPassword>
    このコマンドが実行する検証の種類の詳細については、 マッピング・ファイルを検証するリポジトリ・ツールのコマンドを参照してください。