服务器重命名状态 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 错误,那么表明此应用程序的版本不是 V4.0。应用程序的版本必须为 V4.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 中会更新状态。

反馈