這個主題說明線上重新命名期間失敗的疑難排解和回復程序。
伺服器重新命名狀態使用者介面會輪詢應用程式,以取得其個別的重新命名狀態。若有任何應用程式重新命名失敗,整體的伺服器重新命名就不會完成。如果您看到失敗,首先,您應該要檢查 Jazz™ Team Server 和應用程式日誌,查看是哪裡出錯。以下列出一般錯誤和其修正方法。
使用者介面指出重新命名未啟動
在執行
importURLMappings 之後,您看到 /serverRenameStatus,它指出伺服器重新命名未啟動。
在重新命名之後,沒有重新導向至 serverRenameStatus 頁面。
如果重新命名已完成,這是預期行為。如果要驗證,請移至 https://jts.example.org:9443/jts/serverRenameStatus,並確認每一項都是 100% 並且是綠色。
應用程式重新命名失敗
- 確認應用程式正在執行,且您可以從 Jazz Team Server 對它進行連通測試。
- 確認您可以在瀏覽器中呼叫到每一個應用程式 rootservices。若為 CCM,請檢查 https://ccm.example.org:9443/ccm/rootservices。針對其他應用程式,重複此動作。
- 如果應用程式不在執行中,請啟動應用程式。不必重新啟動 Jazz Team Server。它會繼續輪詢應用程式以取得狀態。當應用程式回到線上時,會在使用者介面中更新其狀態。
- 如果應用程式正在執行,請驗證您聯絡應用程式,以 CCM 為例,它位於 https://ccm.example.org:9443/ccm/appServerRenameStatus。如果您收到 404 錯誤,表示應用程式不是 4.0 應用程式。應用程式必須是 4.0 版或更新的版本,才支援伺服器重新命名。您可以在執行伺服器重新命名之前,先執行升級。如需詳細資料,請參閱 roadmap_clm_upgrade.html。
- 檢查 Jazz Team Server 和應用程式的日誌,以取得詳細的錯誤訊息。
- 確認 .mappingEvent 檔存在於所有應用程式的 server/conf/ 目錄中。
使用者介面顯示重新命名已完成,但發生錯誤
在此情況下,使用者介面顯示重新命名已完成,但是對應用程式執行動作時,發生錯誤。這表示重新命名未完成。
- 檢查應用程式日誌,判斷它是否認定整體重新命名已完成。
- 停止應用程式。
- 開啟應用程式 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。它會繼續輪詢應用程式,來取得其狀態。當應用程式回到線上之後,會在使用者介面中更新其狀態。