您可以使用日志文件对在 IBM® Rational® DOORS® 数据库服务器、客户机和互操作服务器中以及在 Rational DOORS Web Access 服务器和消息代理中发生的问题进行故障诊断。
以下日志记录工具可用于诊断意外的行为(具体取决于配置):
- 客户机的诊断日志
- 数据库服务器事务日志记录
- 客户机事务日志记录
- Rational DOORS Web Access 服务器、互操作服务器和消息代理日志记录
- 应用程序消息记录和数据收集实用程序
Rational DOORS 客户机的诊断日志
客户机具有内置日志记录机制,用于记录由于会话期间内部错误而发生的任何异常事件。要查看此诊断日志,请单击。如有必要,可以从输出窗口复制信息并将其另存为本地文本文件。
要记录更详细的日志,还可以在客户机和数据库服务器上启用额外的基于事务的日志记录。有关更多信息,请参阅随后的部分。
Rational DOORS 的数据库服务器日志记录
数据库服务器提供能够以不同详细级别来记录活动的日志记录功能。缺省情况下,不会启用此日志记录功能,因为它可加大事务的处理器使用并减慢完成所请求功能的速度,或者降低总体性能。输出日志中的详细信息基于所设置的日志级别值。这些值的范围是从级别 1(最简短)到级别 6(最详细)。开启服务器日志记录之前,请与 IBM 软件支持人员商讨以确定用于解决问题的必要级别。
表 1. 日志记录级别日志级别 |
日志详细信息 |
1 |
连接、断开连接和问题包 |
2 |
连接、断开连接和包类型 |
3 |
紧凑格式的连接、断开连接、包类型和包参数 |
4 |
详细格式的连接、断开连接、包类型和包参数 |
5 |
仅数据高速缓存操作 |
6 |
详细格式的连接、断开连接、数据高速缓存操作、包类型和包参数 |
要帮助识别未指定的错误,可能需要启动级别 6 的日志记录以捕获所有活动。启用数据库日志记录并重现行为后,请将生成的日志文件发送给 IBM 软件支持人员并禁用日志记录,如服务器日志记录帮助主题中所述。
在 Rational DOORS 数据库服务器中启用事务日志记录注: 请仅在有限的诊断周期内启用数据库日志记录。要关闭日志记录而不关闭服务器,请通过使用 dbadmin 命令 -serverlogging 将日志级别值设置为 0;例如,dbadmin -d 36677@IBMEDSERV -serverlogging 0。
Rational DOORS 互操作服务器以及 Rational DOORS Web Access 服务器和消息代理的日志记录
缺省情况下,Rational DOORS Web Access 组件提供“参考”级别的日志记录。在“参考”级别,日志记录将包含以高级别描述应用程序进度的参考消息。要诊断安装问题,可以让组件以调试方式运行。
在“调试”级别,日志记录将包含对于调试应用程序有用的更详细参考事件。
Rational DOORS 互操作服务器以及
Rational DOORS Web Access 服务器和消息代理在以下目录中提供“参考”级别日志记录:
应用程序消息记录和数据收集器实用程序
V9.4 引入了基于 Apache log4cxx 日志记录服务的应用程序消息记录。您可以限制日志文件大小,设置旧文件的自动清除,选择输出日志文件的格式,以及更改日志级别和日志配置而无需重新启动服务器。配置文件将每 60 秒受到一次监视以检测更改。
存在五种级别的日志记录,从最低到最高列为:“调试”、“参考”、“警告”、“错误”和“严重”。每种级别都将记录该级别和所有更高级别的信息。例如,“警告”级别将包含“警告”、“错误”和“严重”方式的信息。
Rational DOORS 的较低版本需要在初始故障诊断阶段中以手动迭代的方式收集环境和资源信息以及诊断日志。随着 V9.4 中应用程序消息传递的引入,可以运行命令行数据收集工具来收集根据应用程序消息传递配置指令所生成的日志。此数据收集工具还会创建 3 个文本文件:
- readme.txt 清晰描述问题发生时的用法。
- problemDetails.txt 是可在其中手动输入问题详细信息的模板文件。
- collectedInformation.txt 是对自动收集的关于操作系统的信息、Rational DOORS 产品信息、受支持的动态链接库文件 (.DLL) 以及 config.ini 文件的记录。
有关如何设置日志文件的信息,请参阅以下主题:
- Rational DOORS 中的日志记录:
- Rational DOORS Web Access 中的日志记录: