このトピックでは、オンライン名前変更中の障害のトラブルシューティング手順およびリカバリー手順について説明します。
サーバーの名前変更の状況 UI は、個別の名前変更の状況についてアプリケーションにポーリングします。アプリケーションのいずれかの名前変更が失敗すると、サーバー名前変更全体が完了しません。障害が発生した場合は、まず、Jazz™ Team Server およびアプリケーションのログで失敗内容を確認してください。以下に、一般的なエラーのリストとその修正方法を示します。
UI が、名前変更が開始されていないことを示す
importURLMappings の実行後に、/serverRenameStatus を表示すると、サーバー名前変更が開始されていないことが示されています。
名前変更後に serverRenameStatus ページにリダイレクトされない
名前変更が既に完了している場合は、これは、期待される動作です。確認するには、https://jts.example.org:9443/jts/serverRenameStatus にアクセスし、すべてが 100% かつ緑になっているかを確認します。
アプリケーション名前変更が失敗する
- アプリケーションが実行中で、Jazz Team Server からそのアプリケーションに ping できるかを確認します。
- ブラウザーで各アプリケーションの rootservices にアクセスできるかを確認します。CCM の場合は、https://ccm.example.org:9443/ccm/rootservices を確認します。
その他のアプリケーションについて、繰り返します。
- アプリケーションが実行中でない場合は、アプリケーションを開始します。Jazz Team Server を再始動する必要はありません。
状況についてアプリケーションにポーリングし続けています。アプリケーションがオンラインに戻ると、UI で状況が更新されます。
- アプリケーションが実行中の場合は、アプリケーションに接続できるかを確認します (例えば、CCM の場合は https://ccm.example.org:9443/ccm/appServerRenameStatus)。404 エラーが表示される場合は、アプリケーションが 4.0 アプリケーションではないことを示しています。サーバー名前変更をサポートするには、アプリケーションはバージョン 4.0 以上でなければなりません。サーバー名前変更を行う前に、アップグレードを実行できます。詳しくは、roadmap_clm_upgrade.htmlを参照してください。
- Jazz Team Server およびアプリケーションのログで、詳細なエラー・メッセージを確認します。
- すべてのアプリケーションの server/conf/ ディレクトリーに .mappingEvent ファイルが存在するかを確認します。
UI で名前変更が完了したと示されるが、エラーがある
この場合、UI で名前変更が完了したことが示されるが、アクションをアプリケーションに対して実行したときにエラーがあります。これは、名前変更が完了していないことを示しています。
- アプリケーション・ログを確認して、名前変更全体が完了したと認識されているかどうかを判別します。
- アプリケーションを停止します。
- アプリケーションの 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>
- これらの項目が存在しない場合は、アプリケーションは、名前変更全体が完了したとは認識していません。項目を追加し、WAR ファイルを再デプロイします。アプリケーション・サーバーを再始動し、ブラウザーでアプリケーションの開始をトリガーするページを開きます。例えば、CCM アプリケーションの場合は、https://ccm.example.org:9443/ccm/admin にアクセスします。
- その他のアプリケーション WAR ファイルにこれらの項目が含まれているかを確認し、項目が存在しない場合は、同じ一連のステップを実行します。
サーバーの名前変更のファイナライズが失敗する
すべてのアプリケーション名前変更が完了した後に、多数の処理が Jazz Team Server で行われます。
- Jazz Team Server ログを確認して、どのファイナライズのステップが失敗したのかを判別します。
- データウェアハウスの更新でエラーが発生した可能性があります。
データウェアハウス構成が正しいか、およびデータベース・サーバーが使用可能かを確認します。
- 問題の特定後に、一般のリカバリー手順に従います。ファイナライズのステップを再試行することはできません。
マッピング・イベント・ファイルが存在しない
ご使用の環境が分散されている場合は、マッピング・イベント・ファイルがアプリケーション構成ディレクトリーにコピーされなかった可能性があります。障害が発生しているアプリケーションの server/conf/ ディレクトリーに .mappingEvent ファイルが含まれているかを確認します。.mappingEvent ファイルが存在しない場合は、以下を行います。
- アプリケーションを停止します。
- .mappingEvent ファイルを server/conf/jts ディレクトリーからアプリケーションの server/conf ディレクトリーにコピーします。
注: 特定の JTS トポロジーのすべての .mappingEvent ファイルは同一です。
- アプリケーション・サーバーを再始動します。
Jazz Team Server を再始動する必要はありません。状況についてアプリケーションにポーリングし続けています。アプリケーションがオンラインに戻ると、UI で状況が更新されます。