IBM Support

如何在ClearQuest Web 7.1服务器上收集诊断信息

Technote (FAQ)


疑问

[Simplified Chinese]对于IBM Rational ClearQuest,您可以遵循哪些步骤去收集更多的诊断信息以解决遇到的关于ClearQuest Web 7.1.x服务器的问题?

答案

点击下面的标题查看相关内容:


使用IBM提供的工具进行诊断信息的自动收集

您可以使用工具自动收集Windows和UNIX/Linux平台上所需要收集的关于ClearQuest 7.1.x的诊断信息数据.
如果您想使用这种方式,需要下载软件“IBM Support Assistant Lite”的支持ClearQuest 7.1.x的版本。
您可以在技术文档1407905里找到下载链接,软件的使用方法和相关信息。

这个工具可以按照这些分类收集ClearQuest Web和CM服务器的相关数据:

General Change Management Server Collector: 对于CM服务器的一般问题收集相关的数据。这些数据包括CM服务器的配置信息,IBM安装管理器的信息,以及相关的嵌入式IBM WebSphere应用服务器的信息。

Server Configuration Collector: 仅收集CM服务器配置信息。

Server Processes Trace Collector: 在CM服务器上启用进程跟踪。您可以在重现服务器问题后,用这个数据收集工具收集相关信息并且关闭跟踪功能。

建议您用拥有系统管理员权限的帐号运行这个收集工具去收集收据。



默认安装位置

下面是Rational软件默认安装的主目录和Rational通用组件的默认安装目录。如果您安装软件到非默认安装路径,您在查阅相关手册和说明时注意这一点。

RATIONAL_HOME指向Rational产品安装的位置。
Windows: C:\Program Files\IBM\RationalSDLC


Linux/UNIX: /opt/IBM/RationalSDLC


RATIONAL_COMMON指向一般组件安装的位置。

Windows: C:\Program Files\IBM\RationalSDLC\common


Linux/UNIX: /opt/IBM/RationalSDLC/common


注意:在一些UNIX的操作系统上,路径可能包括小写的"ibm"目录。您也可以通过下面的链接路径访问Rational的主目录和一般组件的目录:

/opt/rational

/opt/rational/common


基本验证信息

注意:对于第二步到第五步,如果您没有得到软件运行正常的验证信息,把截屏信息或保存的相关信息发给IBM支持。
1.检查是否达到了安装软件的系统需求。您可以参考技术文档1294762

2.访问下面的链接确认IBM HTTP Server在正常运行:

http://<server_name>

如果运行正常,您可以看到下面的欢迎信息:
Rational Web Platform: 如果看到此页面,即表示 Rational Web Platform 已安装且正在此系统上运行。

3.访问下面的链接确认CM Server在正常运行:

http://<server_name>/TeamWeb/services/Team

如果运行正常,您可以看到下面的欢迎信息:

Hi there, this is a Web service!

4.访问下面的链接确认ClearQuest Web应用在正常运行:

http://<server_name>/cqweb

如果运行正常,您可以看到ClearQuest Web界面和登录窗口。

5.确认RPC服务在正常运行。如果想获得更多信息,参考ClearQuest信息中心的主题Checking RPC servers

在微软的windows系统上收集ClearQuest Web的诊断信息

1.用超级用户登陆ClearQuest Web。打开站点管理 > 配置的页面。在应用程序选项表里设置启用诊断的值为全部。

2.如果是ClearQuest支持工程师需要相关信息,参考下面的章节CM服务器诊断日志和信息的说明来提高CM服务器的日志级别。

3.停下CM服务器和ClearQuest Web服务。参考ClearQuest信息中心启动,停止和重起CM服务器的主题。

注意:这样也会停下ClearCase远程客户端(CCRC)服务器和CM应用编程接口的操作,如果它们在同一台机器上。

如果启用了全文本查询服务,也要禁用它。
IBM WebSphere Application Server V6.1 - cqsearchprofile

4.启用诊断跟踪。从这个技术文档下载文件core_trace_for_web.zip。把文件core_trace_for_web_enable.reg解压缩到您的Web服务器。双击这个注册文件去更新Windows的注册表。

5.重起除了全文本查询以外的所有的Web服务。

6.重现ClearQuest Web的问题。

7.再停下所有Web服务。

8.从这些目录中收集所有的日志:
<RATIONAL_COMMON>\CM\profiles\cmprofile\logs
这个目录必须要包含ffdc的目录。这个目录包含第一次失败时捕捉到的日志。
<RATIONAL_COMMON>\eWAS\logs
<RATIONAL_COMMON>\IHS\logs

如果这些目录里有core dump文件或heap文件,请告知ClearQuest支持工程师,因为稍后可能需要收集这些文件:
<RATIONAL_COMMON>\cm
<RATIONAL_COMMON>\cm\bin
<RATIONAL_COMMON>\cm\profiles\cmprofile

如果ClearQuest支持工程师需要您帮忙收集CM Server MBean的配置信息,您可以在下面的CM服务器诊断日志和信息章节找到说明。

也要收集跟踪文件,它的位置应该在C盘的根目录。

9.禁用诊断跟踪。把文件core_trace_for_web_disable.reg解压缩到您的Web服务器。双击这个注册文件去更新Windows的注册表。

10.重起所有必须的Web服务。

11.如果您要校正CM服务器的日志级别,您必须恢复原始设置。参考下面的章节CM服务器诊断日志和信息的说明。

12.用超级用户登陆ClearQuest Web。打开站点管理 > 配置的页面。在应用程序选项表里设置启用诊断的值为默认值。

13.您现在可以恢复正常的ClearQuest Web操作。


在Linux或UNIX系统上收集ClearQuest Web的诊断信息

1.用超级用户登陆ClearQuest Web。打开站点管理 > 配置的页面。在应用程序选项表里设置启用诊断的值为全部。

2.如果是ClearQuest支持工程师需要相关信息,参考下面的章节CM服务器诊断日志和信息的说明来提高CM服务器的日志级别。

3.停下CM服务器和ClearQuest Web服务。参考ClearQuest信息中心启动,停止和重起CM服务器的主题。

注意:这样也会停下ClearCase远程客户端(CCRC)服务器和CM应用编程接口的操作,如果它们在同一台机器上。


4.启用诊断跟踪。

修改文件cqrpc.sh,它在这个目录里:
<RATIONAL_COMMON>/CM/bin

如果您是用ClearQuest 7.1.1和之后的版本,您可以在文件里找到这些跟踪设置:

#CQ_DIAG_TRACE="DB_CONNECT;DBDESC;EDIT;EMAIL;HOOKS;JNIREG;LICENSE;MAINS;METADATA
_INIT;MULTISITE;PERL;RESULTSET;SESSION;THROW;TIMER;API"
#CQ_DIAG_REPORT="MESSAGE_INFO=0x070B;DIAG_FLAGS=0x010"
#CQ_DIAG_OUTPUT="/opt/rational/common/CM/profiles/cmprofile/logs/server1/cq_trace.log"
#export CQ_DIAG_TRACE
#export CQ_DIAG_REPORT
#export CQ_DIAG_OUTPUT

删除这些行最前面的注释符号(#)。

如果您是用版本7.1.0.x,在文件里可能不包含这些行。如果是这种情况,找到这些行:
echo Execing CQ RPC server with this command line:
echo cqrpc $*
exec cqrpc $*

在这些行的前面加上上面的跟踪设置。

5.重起除了全文本查询以外的所有的Web服务。

6.重现ClearQuest Web的问题。

7.再停下所有Web服务。

8.从这些目录中收集所有的日志:

<RATIONAL_COMMON>/CM/profiles/cmprofile/logs
这个目录必须要包含ffdc的目录。这个目录包含第一次失败时捕捉到的日志。
<RATIONAL_COMMON>/eWAS/logs
<RATIONAL_COMMON>/IHS/logs

如果这些目录里有core dump文件或heap文件,请告知ClearQuest支持工程师,因为稍后可能需要收集这些文件:
<RATIONAL_COMMON>/cm
<RATIONAL_COMMON>/cm/bin
<RATIONAL_COMMON>/cm/profiles/cmprofile


如果ClearQuest支持工程师需要您帮忙收集CM Server MBean的配置信息,您可以在下面的CM服务器诊断日志和信息章节找到说明.

如果您对于诊断跟踪的输出定义了不同的cmprofile日志目录,也要从那个目录中收集日志。

9.通过注释文件cqrpc.sh中6行关于诊断的设置来禁用诊断跟踪功能。您最好注释它们而不是直接删除它们,即使它们是您后添加上的。

10.重起所有的CQWeb服务。

11.如果您要校正CM服务器的日志级别,您必须恢复原始设置。参考下面的章节CM服务器诊断日志和信息的说明。

12.用超级用户登陆ClearQuest Web。打开站点管理 > 配置的页面。在应用程序选项表里设置启用诊断的值为默认值。

13.您现在可以恢复正常的ClearQuest Web操作。


变动管理(CM)服务器诊断日志和信息

在某些情况下,收集CM服务器的诊断信息和收集ClearQuest Web的诊断信息一样,是必须的。这些章节告诉您在收集

ClearQuest Web信息时如何准备这些诊断信息。如果ClearQuest支持工程师需要相关的信息,您只需要按照下面的说明来操作。

收集MBean的属性信息

MBean的属性是您配置的CM服务器所使用的各种不同的变量设置。当遇到ClearQuest Web或CM服务器的问题时,需要查看这些属性的配置是不是正确。不正确的属性值会造成服务器进程的启动或稳定方面的问题。

您可以按照这些说明来发送用户的MBean配置概要到IBM Rational支持:

1.找到这些目录:

Windows 7.1.0.x:

<RATIONAL_COMMON>\CM\profiles\cmprofile\config\cells\
<host>CMProfileNode01Cell\
nodes\<host>CMProfileNode01Cell\servers\server1\stp


Windows 7.1.1.x 和更新的版本:

<RATIONAL_COMMON>\CM\profiles\cmprofile\config\cells\
dfltCell\nodes\dfltNode\servers\server1\stp


Linux/UNIX:

<RATIONAL_COMMON>/CM/profiles/cmprofile/config/cells/
dfltCell/nodes/dfltNode/servers/server1/stp


注意:如果目录"stp"不存在,您不能确定用户的MBean属性。您不能继续收集这些特定的数据。


2.这些文件储存了CM服务器的当前的MBean属性配置。收集这个目录里的所有文件。

更多的关于正确的MBean配置信息

您可以在这些文档里找到更多的关于这个的信息:

ClearQuest信息中心里的章节设置可用的MBean属性
Technote 1384772 - Change Management Server MBean Attributes -- Information Center Corrections.
Technote 1384746 - Preserve the CM Server MBean Configuration Before Customizing the MBean Attributes, Upgrading, or Reinstalling ClearCase and ClearQuest.


提高CM服务器的日志级别

这是提高CM服务器的日志详细信息级别的步骤。由于提高了日志级别,在CM服务器的日志文件里会包含更多的跟踪输出和诊断信息。对于这些记录方式,您也要确认在重现问题的跟踪过程中日志文件的数量和大小是否充足。

提高诊断级别会影响系统性能,所以需要在短时间内完成。当不再需要详细的日志时,确认恢复了原始设置。

1.访问CM服务器的管理控制台的链接:
http://<server_name>:<port>/ibm/console

注意:独立的CM服务器的默认端口是12060。在IBM WebSphere应用服务器上的CM服务器的默认端口是9060。

2.登入管理控制台。

3.如果您是用的ClearQuest 7.1.1.x或之后的版本,请直接跳到第4步。如果您是用的ClearQuest 7.1.0.x版本,您需要按照下面aj的步骤进行操作,以确保正确记录日志。

a. 打开菜单选择故障诊断 > 日志和跟踪
b. 点击您的服务器。独立的CM服务器默认是server1.
c. 点击诊断跟踪
d. 切换到运行时表,改变最大文件大小最大历史文件数的值到20。点击页面下面的确定。
e. 在打开页面的上面部分的信息区域中点击保存链接。
f. 点击JVM日志。
g.配置表中,改变最大大小历史日志文件的最大数的值到20。这个改变会影响System.outSystem.err两个错误日志文件。点击页面下面的确定
h. 在打开页面的上面部分的信息区域中点击保存链接。
i. 为了使改变生效,您需要重起CM服务器的进程。
j. 一旦重新启动完成,返回CM服务器的管理控制台。

注意:您不需要在完成诊断后把文件的大小和文件数的设置重置。这些值是CM服务器日志设置的建议值。在版本7.1.1.0里它们是默认值。

4.打开菜单选择故障诊断 > 日志和跟踪

5.点击您的服务器。独立的CM服务器默认是server1.

6.点击更改日志详细信息级别

7.运行时的表里,展开com.ibm.rational.*组。

8.点击子组com.ibm.rational.stp.*。选择上下文菜单消息和跟踪级别 > 好。点击页面下面的确定

9.在打开页面的上面部分的信息区域中点击保存链接。

恢复CM服务器日志级别的标准设置

这些步骤会恢复CM服务器日志级别到原始状态。

1. 打开这个链接:

http://<server_name>:<port>/ibm/console

注意:独立的CM服务器的默认端口是12060。在IBM WebSphere应用服务器上的CM服务器的默认端口是9060。

2. 登入管理控制台。

3. 打开菜单选择故障诊断 > 日志和跟踪

4. 点击您的服务器。独立的CM服务器默认是server1.

5. 点击更改日志详细信息级别

6.运行时的表里,展开com.ibm.rational.*组。

7. 点击子组com.ibm.rational.stp.* 。选择上下文菜单消息和跟踪级别 > 信息。点击页面下面的确定

8. 在打开页面的上面部分的信息区域中点击保存链接。




 REGISTRY EDITS:

这个方案包含了修改系统注册表的内容。在用微软的注册表编辑器作修改之前,强烈建议您先备份现有的注册表。您可以通过这个链接http://support.microsoft.com/kb/256986,来查看微软的知识库中的文章256986,获得关于如何备份注册表的帮助。

相关信息

English Technote 1366509

core_trace_for_web.zip

Document information

More support for: Rational ClearQuest
Web Server (7.1)

Software version: 7.1, 7.1.1, 7.1.2

Operating system(s): AIX, HP-UX, Linux, Solaris, Windows

Reference #: 1447970

Modified date: 18 October 2010