importURLMappings 错误

本主题描述 importURLMappings 命令产生的错误的恢复过程。

如果运行 importURLMappings 时发生错误,那么您可以检查 JazzInstallDir/server/repotools-jts_importURLMappings.log 文件。

映射文件中缺少某个映射条目

如果您发现原始映射文件中缺少某个条目(例如,其中一个 CLM 应用程序的“源/目标”对),请执行下列步骤:

  1. 关闭服务器。
  2. 创建仅具有所缺少条目的新映射文件。
  3. 通过重新运行 repotools-jts -importUrlMappings 命令来应用此新映射文件。

您在映射的目标 URL 中出错

如果您在目标 URL 中出错,请应用以下纠正过程。您所作的纠正是累积性的;即,只要服务器已关闭,您在任何时候都可以进行纠正。您可以对多个条目进行这些纠正,但是您只应添加发生错误的条目。不应包括那些您认为已正确映射的 URL。假定您的原始映射文件中具有以下条目:
...
source=https://myOriginalUrl
target=https://myTargetUrlWithATypo
...
  1. 关闭服务器。
  2. 创建具有纠正映射的新映射文件。请勿将此条目添加至原始映射文件。此条目可能类似于以下内容:
    source=https://myTargetUrlWithATypo
    target=https://myCorrectTargetUrl
  3. 通过重新运行 repotools-jts -importUrlMappings 命令来应用此新映射文件。

您在映射的源 URL 中出错

此过程与前一节相似,但是要稍微复杂一些,这是因为您必须分别执行两个纠正映射。假定您的原始映射文件中具有以下条目:

...
source=https://myOriginalUrlWithATypo
target=https://myTargetUrl
...
  1. 创建具有以下纠正映射的新映射文件。此映射文件的用途是将目标 myTargetUrl 移开。
    source=https://myTargetUrl
    target=dummy://aDummyUrl
  2. 通过重新运行 repotools-jts -importUrlMappings 命令来应用此新映射文件。请按如下所示应用此纠正映射:
    source=https://myOriginalUrl
    target=https://myTargetUrl

请勿试图将这些映射组合在一个文件中。必须分别应用上述纠正映射,以便系统可以明确纠正它自身。

在映射文件中您无意中将源与目标颠倒了

例如,您的起始位置为如下所示:

...
source=https://myTargetUrl
target=https://mySourceUrl
...
要点: 此方案只能通过一般恢复过程进行恢复。

要补救这种情况,您将需要遵循一般恢复规则。问题是这样一个映射表示 https://myTargetUrl 处的应用程序也位于 https://mySourceUrl。因为这是您的应用程序已经存在于的位置,所以它引入了无法撤销的歧义性。

在映射文件中造成语法错误

请更正错误,然后再次运行 importURLMappings。

命令失败,产生了 CRJAZ2436E

不支持在集群中进行服务器重命名。对于重命名的脱机和联机部分,Jazz™ Team Server 和 CLM 应用程序服务器必须保持不建立集群。

命令失败,产生了 CRJAZ2449E

已开始进行升级,但是尚未完成。在完成联机升级之前就尝试进行重命名,通常就会产生此错误。RM 会进行联机迁移,必须在完成脱机升级之后才运行联机迁移。请完成联机升级。有关详细信息,请参阅roadmap_clm_upgrade.html。请关闭服务器,然后再次尝试运行 importURLMappings。

运行命令时产生了警告 CRJAZ2425W

此警告表明映射事件文件未包含任何新映射。如果两次导入了同一个映射文件,或者未更新原来生成的映射事件文件以指定目标 URL,可能就会发生这种情况。请确认映射文件参数指向正确的文件,并验证文件内容。

运行命令显示了 CRJAZ2197E 消息

importURLMappings 日志中存在由 CRJAZ2197E 消息表明的错误;或者,当您在运行 importURLMappings 之后启动服务器时,出现了 CRJAZ2197E 消息。

此消息表明 The public URI for this server has already been set to https://jts.source.example.org:9443/jts.It cannot be changed to https://jts.target.example.org:9443/jts after the server has been configured. If the server has moved to a new location at https://jts.target.example.org:9443/jts, follow the instructions to rename the server.

每当 importURLMappings 失败时,它会将 JTS teamserver.properties 中的 URL 还原为其原始值。如果未还原为其原始值,那么您可以手动更新 teamserver.properties,使其包含原始 URL,然后重新运行 importURLMappings 或者重新启动服务器。


反馈