サーバーの名前変更の状況 UI エラー

このトピックでは、オンライン名前変更中の障害のトラブルシューティング手順およびリカバリー手順について説明します。

サーバーの名前変更の状況 UI は、個別の名前変更の状況についてアプリケーションにポーリングします。アプリケーションのいずれかの名前変更が失敗すると、サーバー名前変更全体が完了しません。障害が発生した場合は、まず、Jazz™ Team Server およびアプリケーションのログで失敗内容を確認してください。以下に、一般的なエラーのリストとその修正方法を示します。

UI が、名前変更が開始されていないことを示す

importURLMappings の実行後に、/serverRenameStatus を表示すると、サーバー名前変更が開始されていないことが示されています。

名前変更後に serverRenameStatus ページにリダイレクトされない

名前変更が既に完了している場合は、これは、期待される動作です。確認するには、https://jts.example.org:9443/jts/serverRenameStatus にアクセスし、すべてが 100% かつ緑になっているかを確認します。

アプリケーション名前変更が失敗する

  1. アプリケーションが実行中で、Jazz Team Server からそのアプリケーションに ping できるかを確認します。
  2. ブラウザーで各アプリケーションの rootservices にアクセスできるかを確認します。CCM の場合は、https://ccm.example.org:9443/ccm/rootservices を確認します。 その他のアプリケーションについて、繰り返します。
  3. アプリケーションが実行中でない場合は、アプリケーションを開始します。Jazz Team Server を再始動する必要はありません。 状況についてアプリケーションにポーリングし続けています。アプリケーションがオンラインに戻ると、UI で状況が更新されます。
  4. アプリケーションが実行中の場合は、アプリケーションに接続できるかを確認します (例えば、CCM の場合は https://ccm.example.org:9443/ccm/appServerRenameStatus)。404 エラーが表示される場合は、アプリケーションが 4.0 アプリケーションではないことを示しています。サーバー名前変更をサポートするには、アプリケーションはバージョン 4.0 以上でなければなりません。サーバー名前変更を行う前に、アップグレードを実行できます。詳しくは、roadmap_clm_upgrade.htmlを参照してください。
  5. Jazz Team Server およびアプリケーションのログで、詳細なエラー・メッセージを確認します。
  6. すべてのアプリケーションの server/conf/ ディレクトリーに .mappingEvent ファイルが存在するかを確認します。

UI で名前変更が完了したと示されるが、エラーがある

この場合、UI で名前変更が完了したことが示されるが、アクションをアプリケーションに対して実行したときにエラーがあります。これは、名前変更が完了していないことを示しています。

  1. アプリケーション・ログを確認して、名前変更全体が完了したと認識されているかどうかを判別します。
  2. アプリケーションを停止します。
  3. アプリケーションの WAR ファイルを開き、WEB/web.xml にアクセスします。XML で以下の要素を探します。
    
    <filter>
       <filter-name>bridgefilter</filter-name>
       <filter-class>com.ibm.team.repository.server.servletbridge.BridgeFilter</filter-class>        
    </filter>
             
    <filter-mapping>
       <filter-name>bridgefilter</filter-name>
       <servlet-name>equinoxbridgeservlet</servlet-name>
    </filter-mapping>
  4. これらの項目が存在しない場合は、アプリケーションは、名前変更全体が完了したとは認識していません。項目を追加し、WAR ファイルを再デプロイします。アプリケーション・サーバーを再始動し、ブラウザーでアプリケーションの開始をトリガーするページを開きます。例えば、CCM アプリケーションの場合は、https://ccm.example.org:9443/ccm/admin にアクセスします。
  5. その他のアプリケーション WAR ファイルにこれらの項目が含まれているかを確認し、項目が存在しない場合は、同じ一連のステップを実行します。

サーバーの名前変更のファイナライズが失敗する

すべてのアプリケーション名前変更が完了した後に、多数の処理が Jazz Team Server で行われます。

  1. Jazz Team Server ログを確認して、どのファイナライズのステップが失敗したのかを判別します。
  2. データウェアハウスの更新でエラーが発生した可能性があります。 データウェアハウス構成が正しいか、およびデータベース・サーバーが使用可能かを確認します。
  3. 問題の特定後に、一般のリカバリー手順に従います。ファイナライズのステップを再試行することはできません。

マッピング・イベント・ファイルが存在しない

ご使用の環境が分散されている場合は、マッピング・イベント・ファイルがアプリケーション構成ディレクトリーにコピーされなかった可能性があります。障害が発生しているアプリケーションの server/conf/ ディレクトリーに .mappingEvent ファイルが含まれているかを確認します。.mappingEvent ファイルが存在しない場合は、以下を行います。

  1. アプリケーションを停止します。
  2. .mappingEvent ファイルを server/conf/jts ディレクトリーからアプリケーションの server/conf ディレクトリーにコピーします。
    注: 特定の JTS トポロジーのすべての .mappingEvent ファイルは同一です。
  3. アプリケーション・サーバーを再始動します。 Jazz Team Server を再始動する必要はありません。状況についてアプリケーションにポーリングし続けています。アプリケーションがオンラインに戻ると、UI で状況が更新されます。

フィードバック