importURLMappings エラー

このトピックでは、importURLMappings コマンドでのエラーのリカバリー手順について説明します。

importURLMappings の実行中にエラーが発生した場合は、JazzInstallDir/server/repotools-jts_importURLMappings.log ファイルを確認してください。

マッピング・ファイルにマッピング項目がない

元のマッピング・ファイルに、いずれかの CLM アプリケーションのソースとターゲットのペアなどの項目がないことを発見した場合は、以下のステップを実行してください。

  1. サーバーをシャットダウンします。
  2. 欠落している項目のみを含む新規マッピング・ファイルを作成します。
  3. repotools-jts -importUrlMappings コマンドを再実行して、新規マッピング・ファイルを適用します。

マッピングのターゲット URL を間違えた

ターゲット URL を間違えた場合は、以下の修正手順を適用してください。修正は累積されます。つまり、サーバーがシャットダウンされている限りいつでも修正を行うことができます。これらの修正は複数の項目に対して行うことができますが、誤りの項目に対してのみ追加する必要があります。正しくマッピングされていると考えられる URL は含めないでください。元のマッピング・ファイルに以下の項目があると想定します。
...
source=https://myOriginalUrl
target=https://myTargetUrlWithATypo
...
  1. サーバーをシャットダウンします。
  2. 修正マッピングを使用して新しいマッピング・ファイルを作成します。この項目を元のマッピング・ファイルに追加しないでください。この項目は、次のようになります。
    source=https://myTargetUrlWithATypo
    target=https://myCorrectTargetUrl
  3. repotools-jts -importUrlMappings コマンドを再実行して、新規マッピング・ファイルを適用します。

マッピングのソース URL を間違えた

このプロセスは前のセクションに似ていますが、2 個 の修正マッピングを別々に行わなければならないので若干複雑になります。元のマッピング・ファイルに以下の項目があると想定します。

...
source=https://myOriginalUrlWithATypo
target=https://myTargetUrl
...
  1. 以下の修正マッピングによって新しいマッピング・ファイルを作成します。このマッピング・ファイルの目的は、ターゲット myTargetUrl を無関係な場所に移動することです。
    source=https://myTargetUrl
    target=dummy://aDummyUrl
  2. repotools-jts -importUrlMappings コマンドを再実行して、新規マッピング・ファイルを適用します。以下の手順で、修正マッピングを適用します。
    source=https://myOriginalUrl
    target=https://myTargetUrl

これらのマッピングを 1 個のファイルに結合しようとしないでください。システムがあいまいさなしに自体を修正できるように、上記の修正マッピングは別々に適用する必要があります。

マッピング・ファイル内で誤ってソースとターゲットを逆にした

例えば、以下のように指定してしまった場合です。

...
source=https://myTargetUrl
target=https://mySourceUrl
...
重要: このシナリオは、一般的なリカバリー手順でのみリカバリー可能です。

この状態を修正するには、一般的なリカバリー規則に従う必要があります。この問題は、そのようなマッピングによって、https://myTargetUrl にあるアプリケーションが https://mySourceUrl にも存在することになるということです。ここはユーザーのアプリケーションが既に存在する場所であるため、この誤ったマッピングにより、元に戻すことのできないあいまいさが導入されることになります。

マッピングに構文エラーがある

エラーを修正し、importURLMappings を再度実行します。

コマンドが CRJAZ2436E で失敗する

サーバー名前変更は、クラスターではサポートされません。名前変更のオフラインおよびオンラインの部分で、Jazz™ Team Server および CLM アプリケーション・サーバーはクラスター化されていない状態のままでなければなりません。

コマンドが CRJAZ2449E で失敗する

アップグレードが開始されましたが、完了していません。通常、これは、オンライン・アップグレードの終了前に名前変更を試行した場合に起こります。RM に、オフライン・アップグレードの完了後に実行する必要があるオンライン・マイグレーションがあります。オンライン・アップグレードを終了させます。詳しくは、roadmap_clm_upgrade.htmlを参照してください。サーバーをシャットダウンし、importURLMappings を再試行します。

コマンドで警告 CRJAZ2425W が出される

この警告は、マッピング・イベント・ファイルに新規マッピングが含まれていなかったことを示しています。これは、同じマッピング・ファイルを 2 回インポートした場合、または生成された元のマッピング・イベント・ファイルが、ターゲット URL を指定するように更新されていなかった場合に起こることがあります。マッピング・ファイル引数が正しいファイルを指していることを確認し、ファイル内容を検証します。

コマンドで CRJAZ2197E メッセージが表示される

importURLMappings ログに CRJAZ2197E メッセージが含まれたエラーがあるか、importURLMappings の実行後にサーバーを始動すると CRJAZ2197E メッセージが表示されます。

このメッセージは、このサーバーのパブリック URI が https://jts.source.example.org:9443/jts に既に設定されていることを示しています。サーバーの構成後に、https://jts.target.example.org:9443/jts に変更することはできません。サーバーが新しい場所 https://jts.target.example.org:9443/jts に移動された場合は、サーバー名前変更の手順に従ってください。

importURLMappings が失敗するたびに、このコマンドは JTS teamserver.properties 内にある URL を元の値に戻す必要があります。それが行われない場合は、元の URL が含まれるように teamserver.properties をユーザーが手動で更新し、importURLMappings を再実行するか、サーバーを再始動してください。


フィードバック