このトピックでは、importURLMappings コマンドでのエラーのリカバリー手順について説明します。
importURLMappings の実行中にエラーが発生した場合は、JazzInstallDir/server/repotools-jts_importURLMappings.log ファイルを確認してください。
元のマッピング・ファイルに、いずれかの CLM アプリケーションのソースとターゲットのペアなどの項目がないことを発見した場合は、以下のステップを実行してください。
...
source=https://myOriginalUrl
target=https://myTargetUrlWithATypo
...
source=https://myTargetUrlWithATypo
target=https://myCorrectTargetUrl
このプロセスは前のセクションに似ていますが、2 個 の修正マッピングを別々に行わなければならないので若干複雑になります。元のマッピング・ファイルに以下の項目があると想定します。
...
source=https://myOriginalUrlWithATypo
target=https://myTargetUrl
...
source=https://myTargetUrl
target=dummy://aDummyUrl
source=https://myOriginalUrl
target=https://myTargetUrl
これらのマッピングを 1 個のファイルに結合しようとしないでください。システムがあいまいさなしに自体を修正できるように、上記の修正マッピングは別々に適用する必要があります。
例えば、以下のように指定してしまった場合です。
...
source=https://myTargetUrl
target=https://mySourceUrl
...
この状態を修正するには、一般的なリカバリー規則に従う必要があります。この問題は、そのようなマッピングによって、https://myTargetUrl にあるアプリケーションが https://mySourceUrl にも存在することになるということです。ここはユーザーのアプリケーションが既に存在する場所であるため、この誤ったマッピングにより、元に戻すことのできないあいまいさが導入されることになります。
エラーを修正し、importURLMappings を再度実行します。
サーバー名前変更は、クラスターではサポートされません。名前変更のオフラインおよびオンラインの部分で、Jazz™ Team Server および CLM アプリケーション・サーバーはクラスター化されていない状態のままでなければなりません。
アップグレードが開始されましたが、完了していません。通常、これは、オンライン・アップグレードの終了前に名前変更を試行した場合に起こります。RM に、オフライン・アップグレードの完了後に実行する必要があるオンライン・マイグレーションがあります。オンライン・アップグレードを終了させます。詳しくは、roadmap_clm_upgrade.htmlを参照してください。サーバーをシャットダウンし、importURLMappings を再試行します。
この警告は、マッピング・イベント・ファイルに新規マッピングが含まれていなかったことを示しています。これは、同じマッピング・ファイルを 2 回インポートした場合、または生成された元のマッピング・イベント・ファイルが、ターゲット URL を指定するように更新されていなかった場合に起こることがあります。マッピング・ファイル引数が正しいファイルを指していることを確認し、ファイル内容を検証します。
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 を再実行するか、サーバーを再始動してください。