本主题描述联机重命名期间所发生故障的故障诊断和恢复过程。
服务器重命名状态 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 错误,那么表明此应用程序的版本不是 V4.0。应用程序的版本必须为 V4.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 中会更新状态。