在更新期间,输出会写入到会话日志文件和“消息”对话框。但是,可能难以读取此日志文件中的更新结果,因为所有其他消息也写入到此文件。
您可以将 ccm_client.log(用户界面日志)文件重定向,以指向除 Windows 概要信息目录(Windows 用户)或 ccmlog 目录(UNIX 用户)以外的其他位置。按后续步骤中所示在 ccm.user.properties 文件中设置 ccm.user.properties 键。
对于 Windows 用户,该文件称为 ccm.user.properties 并位于 Windows 概要信息目录中。
对于 UNIX 用户,该文件称为 .ccm.user.properties 并位于主目录中。
* 要将日志文件重定向到 C:\cmsynergy\synint\bob,请执行以下操作:
user.default.logfile=
C:\\cmsynergy\\synint\\bob\\ccm_client.log
* 要重命名 int 数据库的日志文件(通常在多个数据库中使用时),请执行以下操作:
user.default.logfile=
C:\\cmsynergy\\bob\\ccm_client_int.log
在使用 ccm.user.properties 键时,必须使用完整路径和文件名。
此外,用户还必须使用双反斜杠输入 Windows 路径。
在每个更新/构建循环后读取更新结果以查找问题。在更新消息结尾处,会在“消息”对话框或输出日志中写入摘要,描述更新的结果。不过,请养成习惯定期复审日志,以读取有关更新失败的详细报告。
此外,成功构建并不总是意味着正确配置了软件。复审更新结果是查找配置中错误的一种理想方法:对象或项目的版本错误,未合并更改,特性设置选择不正确等。以下是要查找的一些内容。
假设您从 CLI 进行构建并设置 update_parallel_check 选项。 如果给定的更新候选集包含并行计分,那么您在 ccm_ui.log 中会接收到类似以下的警告消息。
Warning: Parallel versions selected by selection
rules, latest create time will be used:
save.c-3
save.c-2.1.1
检查在并行警告消息中调出的对象历史记录是否已合并。 如果否,那么表示构建缺少某部分更改。请通知所涉及的开发者合并并行版本。
有关在从 CLI 进行构建时,如何检查并行版本的信息,请参阅所有构建管理员以获取有关在更新期间选择并行通知的信息。
构建管理项目层次结构必须作为一个单元整体保留。如果更新特性(发布标识和平台等)设置不正确,那么更新可能会选择其他版本的子项目。检查消息,例如:
Subproject editor-int_3.0 replaces editor-int_2.1 under toolkit-2:dir:1
如果查找有关已替换的项目的任何消息,请审查项目版本;检查其更新特性以验证这些特性是否正确。
缺省情况下,如果目录条目没有任何候选项,那么会将该目录条目保持为空。如果找到任何候选项,请查找出现的原因,如任务具有错误的发布标识值。查找消息,例如:
2 directory entries were left empty because they had no candidates.
空目录条目并不总是表示错误。例如,如果在多个平台上的单个目录中构建产品,那么目录条目可能保持为空。共享库可能命名为 mylibrary.so(在 Solaris 上)和 mylibrary.dll(在 Windows 上)。假设您在同一目录中控制两个产品,但是在两个平台的两个并行项目中使用该目录。对于 Windows 项目中的 Solaris 库,目录条目为空,反之亦然。
开发者可定制具有特定环境设置的 makefile,然后随机检入定制的 makefile。如果在更新过程期间替换了任何 makefile,请复审新版本的 makefile。确保更改适合于您的构建环境。查找消息,例如:
'makefile-6:makefile:3' replaces 'makefile-5:makefile:3' under 'editor-2:dir:1'
如果项目具有冲突,请使用同步工作区解决工作区冲突,然后再次更新。查找消息,例如:
Unable to update membership of project ccm_client,td_7.1 with InteractiveProcessCreator.java,21:java:J#1 due to work area conflicts.
如果较旧对象版本在更新过程期间替换较新对象版本,请执行显示冲突操作以帮助减少可能的问题。查找诸如以下的消息:
'main.c-2:csrc:3' replaces main.c-3:csrc:3' under 'toolkit-4:dir:1'
此外,查看较新对象版本的关联任务以及项目的流程规则。比较可能会显示较旧版本替换较新版本的原因。比较还可能显示导致任务添加较旧对象版本的流程规则中的差异。
如果您查看到任何问题且无法理解这些问题,请再次运行更新,并将详细消息设置为在输出日志中接收详细更新结果。(在更新选项内的“选项”对话框操作选项卡中,设置显示详细消息。)
以下部分对更新进行了更详细的描述: