IBM Support

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

Question & Answer


Question

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

Answer


1. Learning more2. Troubleshooting3. Collecting data

下面的章节对于不同的系统及ClearQuest版本提供了详细的步骤以收集所需的诊断信息。
请点击章节的标题以查看相应的章节内容。


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

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

这个工具将基于所定义要收集的诊断信息数据,按照下面的规则自动收集相关数据:

Rational ClearQuest Web General Collector - No Service Restart: 收集那些诊断信息数据但不启用跟踪功能。
Rational ClearQuest Web General Collector: 收集那些诊断信息数据,并且按照规则需要更改设置以启用/禁用跟踪功能
Rational ClearQuest Web General Performance Issues Collector: 收集那些诊断信息数据。服务器将被重起并且启用性能跟踪功能以收集问题重现时的信息数据,之后会再重起服务器并且禁用性能跟踪功能。

Rational ClearQuest Web Database Connection Issues Collector: 收集那些诊断信息数据。服务器将被重起并且启用数据库跟踪功能以收集问题重现时的信息数据,之后会再重起服务器并且禁用数据库跟踪功能。

Rational ClearQuest Web - Customized Trace Collector - 收集那些诊断信息数据。用户自己(或当与支持一起工作时)可以自定义跟踪功能的设置。服务器将被重起并按照定义好的设置当问题重现时去收集数据,之后会再重起服务器并禁用跟踪功能。


收集ClearQuest 7.0.x Windows Web 服务器的诊断信息数据

收集版本 7.0.x 的数据

收集 Rational 软件信息
对服务器上安装的每一款Rational产品都查出Rational产品的版本信息和补丁信息。

收集ClearQuest Web系统信息
收集操作系统和service pack的版本信息
查看c盘的剩余的磁盘空间的信息,如果软件没有安装在c盘,还会查看软件安装的硬盘分区的剩余的磁盘空间的信息
包括杀毒软件和防火墙的品牌和版本信息
提供用于安装软件的登陆账号,管理员账号,拥有管理员权限的账号,或一个普通账号。

收集ClearQuest Web配置信息
收集下面的配置文件

<install dir>\Rational\common\rwp\IHS\conf\httpd.conf

<install dir>\Rational\common\rwp\EmbeddedExpress\profiles\profile1\
config\cells\DefaultNode\virtualhosts.xml

<install dir>\Rational\common\rwp\EmbeddedExpress\profiles\plugin_cfg.xml

<install dir>\Rational\Common\rwp\EmbeddedExpress\profiles\profile1\installedApps
\DefaultNode\RationalClearQuestWeb.ear\CQWebModule.war\WEB-INF\classes\common.properties

<install dir>\Rational\Common\rwp\EmbeddedExpress\profiles\profile1\installedApps
\DefaultNode\RationalClearQuestWeb.ear\CQWebModule.war\WEB-INF\classes\pl.properties

<install dir>\Rational\Common\rwp\EmbeddedExpress\profiles\profile1\installedApps
\DefaultNode\RationalClearQuestWeb.ear\CQWebModule.war\WEB-INF\classes\jtl.properties

<install dir>\Rational\ClearQuest\cqweb\cqserver\config\jtl.properties

<install dir>\Rational\ClearQuest\cqweb\cqserver\config\common.properties

<install dir>\Rational\ClearQuest\cqweb\csm.properties

另外, 如果启用了SSL, 还包括这个文件

<install dir>\Rational\common\rwp\IHS\conf\ssl.conf


收集ClearQuest Web日志信息
停ClearQuest Web服务或重起您的机器
在Windows管理服务的窗口中,停"IBM HTTP Server"服务
在Windows管理服务的窗口中,停"IBM WebSphere Application Serve V6 - RWP servlet"服务
在Windows管理服务的窗口中,停"IBM Rational ClearQuest Registry Server"服务


启用 ClearQuest核心跟踪功能.
下载文件core_trace_for_web_enable.reg到您的Web服务器
双击文件更新Windows的注册表


注意: 如果您运行ClearQuest Web组件在不同的服务器,请在ClearQuest的注册服务器上启用跟踪功能。

移除以前生成的所有日志文件
在下面的目录里:

<install dir>\Rational\common\rwp\EmbeddedExpress\profiles\profile1\logs\server1
<install dir>\Rational\common\rwp\EmbeddedExpress\profiles\profile2\logs\server2
<install dir>\Rational\common\rwp\IHS\logs
<install dir>\Rational\ClearQuest\cqweb\cqserver\logs
<install dir>\Rational\ClearQuest\cqweb\cqregsvr\logs

删除所有已存在的ClearQuest跟踪日志文件(在C盘的根下)

编辑下面文件(备注1):
<install dir>\Rational\ClearQuest\cqweb\cqserver\config\logging.xml
<install dir>\Rational\ClearQuest\cqweb\cqregsvr\config\logging.xml
<install dir>\Rational\Common\rwp\EmbeddedExpress\profiles\
profile1\installedApps\DefaultNode\RationalClearQuestWeb.ear\
CQWebModule.war\WEB-INF\classes\logging.xml

对每一个文件,在文件的末尾,有一个赋给"priority"的值。请把这个值改成"debug"并保存。
重起服务器,如果不能重起服务器请重起服务:
在Windows管理服务的窗口中,启动"IBM HTTP Server"服务
在Windows管理服务的窗口中,启动"IBM WebSphere Application Serve V6 - RWP servlet"服务
在Windows管理服务的窗口中,启动"IBM Rational ClearQuest Registry Server"服务

在ClearQuest Web上重现错误,之后注销。

再次停掉服务
在Windows管理服务的窗口中,停"IBM HTTP Server"服务
在Windows管理服务的窗口中,停"IBM WebSphere Application Serve V6 - RWP servlet"服务
在Windows管理服务的窗口中,停"IBM Rational ClearQuest Registry Server"服务

在下面的目录里收集日志文件

<install dir>\Rational\common\rwp\EmbeddedExpress\profiles\profile1\logs\server1
<install dir>\Rational\common\rwp\EmbeddedExpress\profiles\profile2\logs\server2
<install dir>\Rational\common\rwp\IHS\logs
<install dir>\Rational\ClearQuest\cqweb\cqserver\logs
<install dir>\Rational\ClearQuest\cqweb\cqregsvr\logs

也请收集ClearQuest跟踪的日志文件(应该在C盘的根下),并且把所有的日志文件压缩到一个ZIP文件中。

禁用ClearQuest核心跟踪功能。
下载文件"core_trace_for_web_disable.reg"到您的Web服务器上。
双击文件更新Windows注册表。

在下面的目录中删除所有的日志文件


<install dir>\Rational\common\rwp\EmbeddedExpress\profiles
\profilen\logs\server1
<install dir>\Rational\common\rwp\EmbeddedExpress\profiles
\profilen\logs\server2
<install dir>\Rational\common\rwp\IHS\logs
<install dir>\Rational\ClearQuest\cqweb\cqserver\logs
<install dir>\Rational\ClearQuest\cqweb\cqregsvr\logs

和ClearQuest跟踪日志文件 (它们应该在c盘的根下)
您的ZIP文件里应该有它们备份,所以您不需要它们了。

编辑下面的文件(备注1):


<install dir>\Rational\ClearQuest\cqweb\cqserver\config\logging.xml
<install dir>\Rational\ClearQuest\cqweb\cqregsvr\config\logging.xml
<install dir>\Rational\Common\rwp\EmbeddedExpress\profiles\profile1
\installedApps\DefaultNode\RationalClearQuestWeb.ear
\CQWebModule.war\WEB-INF\classes\logging.xml

把文件末尾赋给priority的值改成默认值"error"并保存。

重起服务器,如果不能重起服务器请重起服务:

在Windows管理服务的窗口中,启动"IBM HTTP Server"服务
在Windows管理服务的窗口中,启动"IBM WebSphere Application Serve V6 - RWP servlet"服务
在Windows管理服务的窗口中,启动"IBM Rational ClearQuest Registry Server"服务

检查Java core dump文件
访问下面的目录看是否有Java core dump文件。。。

<install dir>\Program Files\Rational\ClearQuest\cqweb\cqserver
<install dir>\Rational\Common\rwp\EmbeddedExpress

如果文件存在,请把它们添加到刚才生成的ZIP文件中。

收集Windows事件查看器的日志信息
打开控制面板 --> 管理工具 --> 计算机管理. 对于事件查看器中的每一类日志(应用程序, 安全性,系统) 点击右键并选择"另存日志文件...".之后把所有的日志文件添加到ZIP文件中.


在Linux和UNIX平台上对于ClearQuest 7.0.x Web服务器收集诊断信息数据

在Linux和UNIX系统上对于版本 7.0.x 收集数据

收集Rational软件信息
对服务器上安装的每一款Rational产品都查出Rational产品的版本信息和补丁信息。
对于clearquest,您可以打开一个终端窗口,把路径改成<install dir>/Rational/clearquest/bin,再运行下面的命令就可以获得所需要的信息:

./clearquest -ver

收集ClearQuest Web系统信息
收集您机器上unix/linux的系统版本和核心信息.您可以在一个终端窗口中运行下面的命令得到相关信息:

uname -a

运行下面的命令得到umask的设置:

umask

运行下面的命令得到/tmp分区和安装目录的剩余硬盘空间的信息:

df -m

运行下面的命令得到环境变量的列表:

env

提供用于安装软件的登陆账号信息,管理员账号或拥有管理员权限的账号。

收集ClearQuest Web配置信息
收集下面的配置文件

<install dir>/Rational/common/rwp/IHS/conf/httpd.conf

<install dir>/Rational/common/rwp/EmbeddedExpress/profiles/profile1/
config/cells/DefaultNode/virtualhosts.xml

<install dir>/Rational/common/rwp/EmbeddedExpress/profiles/plugin_cfg.xml

<install dir>/Rational/Common/rwp/EmbeddedExpress/profiles/profile1/
installedApps/DefaultNode/RationalClearQuestWeb.ear/CQWebModule.war/WEB-INF/
classes/common.properties

<install dir>/Rational/Common/rwp/EmbeddedExpress/profiles/profile1/
installedApps/DefaultNode/RationalClearQuestWeb.ear/CQWebModule.war/WEB-INF/
classes/pl.properties

<install dir>/Rational/Common/rwp/EmbeddedExpress/profiles/profile1/
installedApps/DefaultNode/RationalClearQuestWeb.ear/CQWebModule.war/WEB-INF/
classes/jtl.properties

<install dir>/Rational/ClearQuest/cqweb/cqserver/config/jtl.properties

<install dir>/Rational/ClearQuest/cqweb/cqserver/config/common.properties

<install dir>/Rational/ClearQuest/cqweb/csm.properties

另外, 如果启用了SSL, 还包括这个文件

<install dir>/Rational/common/rwp/IHS/conf/ssl.conf



收集ClearQuest Web日志信息
注意: 默认安装目录是 /opt
停ClearQuest Web服务或重起您的机器
运行 "rwp_shutdown.sh", 该脚本在目录<install dir>/Rational/common/rwp/bin下

运行 "cqserver_shutdown.sh", 该脚本在目录<install dir>/Rational/clearquest/cqweb下


启用 ClearQuest核心跟踪功能.
在UNIX上启用核心跟踪功能,需要修改文件start_cqreg.sh,这个文件在目录/opt/rational/clearquest/cqweb/cqregsvr下.

注意: 如果您指定了不同的安装目录, 请按您的安装目录来修改文件

添加下面的几行到文件的头部:

CQ_DIAG_TRACE="PERL;SQL=3;RESULTSET=2;HOOKS=2;THROW;EDIT;TIMER;API;SCRIPTSERVER;SESSION;LICENSE;DB_MISC;DB_CONNECT;"

CQ_DIAG_REPORT="MESSAGE_INFO=0x070B;DIAG_FLAGS=-1;OUTPUT_LIMIT=1000000" CQ_DIAG_OUTPUT="/opt/rational/clearquest/cqweb/cqserver
/logs/cq_trace.log"
export CQ_DIAG_TRACE
export CQ_DIAG_REPORT
export CQ_DIAG_OUTPUT

注意:
如果您指定了不同的安装目录, 请您修改文件时按您指定的安装路径赋相应的值给参数CQ_DIAG_OUTPUT
如果您运行ClearQuest Web组件在不同的服务器,请在ClearQuest的注册服务器上启用跟踪功能。

移除以前生成的所有日志文件
在下面的目录里:
<install dir>/Rational/common/rwp/EmbeddedExpress/profiles/profile1/logs/server1
<install dir>/Rational/common/rwp/EmbeddedExpress/profiles/profile2/logs/server2
<install dir>/Rational/common/rwp/IHS/logs
<install dir>/Rational/ClearQuest/cqweb/cqserver/logs
<install dir>/Rational/ClearQuest/cqweb/cqregsvr/logs

删除所有已存在的ClearQuest跟踪日志文件(它应该在目录<install dir>/Rational/ClearQuest/cqweb/cqregsvr/logs 下)

编辑下面文件(备注1):

<install dir>/Rational/ClearQuest/cqweb/cqserver/config/logging.xml
<install dir>/Rational/ClearQuest/cqweb/cqregsvr/config/logging.xml
<install dir>/Rational/Common/rwp/EmbeddedExpress/profiles/profile1
/installedApps/DefaultNode/RationalClearQuestWeb.ear/CQWebModule.war
/WEB-INF/classes/logging.xml

对每一个文件,在文件的末尾,有一个赋给"priority"的值。请把这个值改成"debug"并保存。
重起服务器,如果不能重起服务器请重起服务:
运行 rwp_startup.sh, 该脚本在目录 <install dir>/Rational/common/rwp/bin下
运行 cqserver_startup.sh, 该脚本在目录 <install dir>/Rational/clearquest/cqweb下

在ClearQuest Web上重现错误,之后注销。

再次停掉服务:
运行 "rwp_shutdown.sh", 该脚本在目录 <install dir>/Rational/common/rwp/bin下

运行 "cqserver_shutdown.sh", 该脚本在目录 <install dir>/Rational/clearquest/cqweb 下

在下面的目录里收集日志文件

<install dir>/Rational/common/rwp/EmbeddedExpress/profiles/profile1/logs/server1
<install dir>/Rational/common/rwp/EmbeddedExpress/profiles/profile2/logs/server2
<install dir>/Rational/common/rwp/IHS/logs
<install dir>/Rational/ClearQuest/cqweb/cqserver/logs
<install dir>/Rational/ClearQuest/cqweb/cqregsvr/logs

也请收集ClearQuest跟踪的日志文件(应该在目录<install dir>/Rational/ClearQuest/cqweb/cqregsvr/logs下),并且把所有的日志文件压缩到一个ZIP或TAR文件中。
禁用ClearQuest核心跟踪功能.

删除下面目录中的所有日志文件

<install dir>/Rational/common/rwp/EmbeddedExpress/profiles
/profile1/logs/server1
<install dir>/Rational/common/rwp/EmbeddedExpress/profiles
/profile2/logs/server2
<install dir>/Rational/common/rwp/IHS/logs
<install dir>/Rational/ClearQuest/cqweb/cqserver/logs
<install dir>/Rational/ClearQuest/cqweb/cqregsvr/logs

和ClearQuest跟踪日志文件(它应该在目录<install dir>/Rational/ClearQuest/cqweb/cqregsvr/logs下)
您的ZIP或TAR文件里应该有它们备份,所以您不需要它们了。

编辑下面的文件(备注1):

<install dir>/Rational/ClearQuest/cqweb/cqserver/config/logging.xml
<install dir>/Rational/ClearQuest/cqweb/cqregsvr/config/logging.xml
<install dir>/Rational/Common/rwp/EmbeddedExpress/profiles/profile1
/installedApps/DefaultNode/RationalClearQuestWeb.ear
/CQWebModule.war/WEB-INF/classes/logging.xml

把文件末尾赋给priority的值改成默认值"error"并保存。

禁用ClearQuest核心跟踪功能.

如果想在UNIX系统上禁用核心跟踪功能,需要修改文件start_cqreg.sh,您可以在目录/opt/rational/clearquest/cqweb/cqregsvr下找到文件start_cqreg.sh.

注意: 如果您指定了不同的安装目录, 请按您的安装目录来修改文件

按照下面的例子修改那些您之前添加到这个脚本里的用以启用跟踪功能的行.

CQ_DIAG_TRACE=""
CQ_DIAG_REPORT=""
CQ_DIAG_OUTPUT=""
export CQ_DIAG_TRACE
export CQ_DIAG_REPORT
export CQ_DIAG_OUTPUT

重起服务器,如果不能重起服务器请重起服务:
运行 rwp_startup.sh, 该脚本在目录 <install dir>/Rational/common/rwp/bin下
运行 cqserver_startup.sh, 该脚本在目录<install dir>/Rational/clearquest/cqweb下

检查Java core dump文件:
访问下面的目录看是否有Java core dump文件。。。

<install dir>/Rational/ClearQuest/cqweb/cqserver/
<install dir>/Rational/Common/rwp/EmbeddedExpress/

如果文件存在,请把它们添加到刚才生成的ZIP或TAR文件中。


在微软的Windows平台上收集ClearQuest 2003.06.13 - 2003.06.16 Web 服务器的诊断信息数据

收集版本 2003.06.13 到 2003.06.16的数据

如果您在版本2003.06.13或2003.06.14上遇到了关于ClearQuest Web服务器的问题,请升级到版本2003.06.16(Service Release 6 -SR6)或之后的版本.因为在这些版本里有很多性能问题已经被解决了.

如果在升级后您还能遇到相同的问题,请联系Rational ClearQuest支持,并且帮忙收集下面提到的Request Manager服务器上的文件和相关的信息:

收集 Rational 软件信息

对服务器上安装的每一款Rational产品都查出Rational产品的版本信息和补丁信息。

收集ClearQuest Web系统信息

收集操作系统和service pack的版本信息
查看c盘的剩余的磁盘空间的信息,如果软件没有安装在c盘,也查看软件安装的硬盘分区的剩余的磁盘空间的信息

包括杀毒软件和防火墙的品牌和版本信息

提供用于安装软件的登陆账号,管理员账号,拥有管理员权限的账号,或一个普通账号。

收集ClearQuest Web配置信息

收集下面的配置文件

<install dir>\Rational\common\rwp\conf\rwp.conf

<install dir>\Rational\common\rwp\conf\include\cqweb.conf

<install dir>\Rational\Common\rwp\webapps\cqweb\WEB-INF\classes\common.properties

<install dir>\Rational\Common\rwp\webapps\cqweb\WEB-INF\classes\pl.properties

<install dir>\Rational\Common\rwp\webapps\cqweb\WEB-INF\classes\jtl.properties

<install dir>\Rational\ClearQuest\cqweb\cqserver\config\jtl.properties

<install dir>\Rational\ClearQuest\cqweb\cqserver\config\common.properties

另外, 如果启用了SSL, 还包括这个文件
<install dir>\Rational\common\rwp\conf\ssl.conf

另外,查找一个Java HotSpot错误文件,如果这个文件存在,它会生成在下面的位置
<install dir>\Rational\ClearQuest\cqweb\cqserver\hs_err_pid####

(文件格式是 hs_err_pid####, 符号 #### 是指进程java.exe Request Manager的id号)

收集ClearQuest Web日志信息

停ClearQuest Web服务或重起您的机器

在目录<install dir>\Rational\common\rwp\bin下运行bat文件rwp_shutdown.bat

在Windows管理服务的窗口中,停下"IBM Rational ClearQuest Registry Server"服务.
在Windows管理服务的窗口中,停下"IBM Rational ClearQuest Request Manager"服务.

启用 ClearQuest核心跟踪功能.
下载文件core_trace_for_web_enable.reg到您的Web服务器.
双击文件更新Windows的注册表

注意: 如果您运行ClearQuest Web组件在不同的服务器,请在ClearQuest的注册服务器上启用跟踪功能。

移除以前生成的所有日志文件
在下面的目录里:

<install dir>\Rational\common\rwp\logs
<install dir>\Rational\ClearQuest\cqweb\cqserver\logs
<install dir>\Rational\ClearQuest\cqweb\cqregsvr\logs

删除所有已存在的ClearQuest跟踪日志文件(在C盘的根下)


编辑下面文件:


<install dir>\Rational\ClearQuest\cqweb\cqserver\config\logging.xml
<install dir>\Rational\ClearQuest\cqweb\cqregsvr\config\logging.xml
<install dir>\Rational\Common\rwp\webapps\cqweb\WEB-INF\classes\logging.xml

对每一个文件,在文件的开头,有一个赋给"logger level"的值。请把默认值从"Severe"改成"Debug"并保存。

重起服务:

在目录<install dir>\Rational\common\rwp\bin下运行"rwp_startup.bat".
在Windows管理服务的窗口中,启动"IBM Rational ClearQuest Registry Server"服务
在Windows管理服务的窗口中,启动"IBM Rational ClearQuest Request Manager"服务

在ClearQuest Web上重现错误,之后注销。


再次停掉服务:
在目录<install dir>\Rational\common\rwp\bin下运行"rwp_shutdown.bat".
在Windows管理服务的窗口中,停下"IBM Rational ClearQuest Registry Server"服务
在Windows管理服务的窗口中,停下"IBM Rational ClearQuest Request Manager"服务

在下面的目录里收集日志文件

<install dir>\Rational\ClearQuest\cqweb\cqserver\config\logging.xml
<install dir>\Rational\ClearQuest\cqweb\cqserver\logs
<install dir>\Rational\ClearQuest\cqweb\cqregsvr\logs

也请收集ClearQuest跟踪日志文件(应该在C盘的根下),并且把所有的日志文件压缩到一个ZIP文件中。
禁用ClearQuest核心跟踪功能。
下载文件"core_trace_for_web_disable.reg"到您的Web服务器上。
双击文件更新Windows注册表。

在下面的目录中删除所有的日志文件

<install dir>\Rational\ClearQuest\cqweb\cqserver\config\logging.xml
<install dir>\Rational\ClearQuest\cqweb\cqserver\logs
<install dir>\Rational\ClearQuest\cqweb\cqregsvr\logs

和ClearQuest跟踪日志文件 (它们应该在c盘的根下)
您的ZIP文件里应该有它们备份,所以您不需要它们了。

编辑下面的文件:

<install dir>\Rational\ClearQuest\cqweb\cqserver\config\logging.xml
<install dir>\Rational\ClearQuest\cqweb\cqregsvr\config\logging.xml
<install dir>\Rational\Common\rwp\webapps\cqweb\WEB-INF\classes\logging.xml

把文件开头赋给"logger level"的值改成默认值"Severe"并保存。
重起服务:
在目录<install dir>\Rational\common\rwp\bin下运行rwp_startup.bat.
在Windows管理服务的窗口中,启动"IBM Rational ClearQuest Registry Server"服务.
在Windows管理服务的窗口中,启动"IBM Rational ClearQuest Request Manager"服务.


在Linux和UNIX平台上对于ClearQuest 2003.06.13 -2003.06.16 Web服务器收集诊断信息数据


在Linux和UNIX系统上对于版本 2003.06.13 - 2003.06.16 收集数据

收集Rational软件信息
对服务器上安装的每一款Rational产品都查出Rational产品的版本信息和补丁信息。
对于clearquest,您可以打开一个终端窗口,把路径改成<install dir>/Rational/clearquest/bin,再运行下面的命令就可以获得所需要的信息:

./clearquest -ver

收集ClearQuest Web系统信息
收集您机器上unix/linux的系统版本和核心信息.您可以在一个终端窗口中运行下面的命令得到相关信息:

uname -a

运行下面的命令得到umask的设置:

umask

运行下面的命令得到/tmp分区和安装目录的剩余硬盘空间的信息:

df -m

运行下面的命令得到环境变量的列表:

env


提供用于安装软件的登陆账号信息,管理员账号或拥有管理员权限的账号。

收集ClearQuest Web配置信息
收集下面的配置文件

<install dir>/Rational/common/rwp/conf/rwp.conf

<install dir>/Rational/common/rwp/conf/include/cqweb.conf

<install dir>/Rational/Common/rwp/webapps/cqweb/WEB-INF/classes/common.properties

<install dir>/Rational/Common/rwp/webapps/cqweb/WEB-INF/classes/pl.properties

<install dir>/Rational/Common/rwp/webapps/cqweb/WEB-INF/classes/jtl.properties

<install dir>/Rational/ClearQuest/cqweb/cqserver/config/jtl.properties

<install dir>/Rational/ClearQuest/cqweb/cqserver/config/common.properties


另外, 如果启用了SSL, 还包括这个文件
<install dir>/Rational/common/rwp/conf/ssl.conf

收集ClearQuest Web日志信息
注意: 默认安装目录是 /opt
停ClearQuest Web服务或重起您的机器
运行 "rwp_shutdown.sh", 该脚本在目录<install dir>/Rational/common/rwp/bin下

运行 "cqserver_shutdown.sh", 该脚本在目录<install dir>/Rational/clearquest/cqweb下

启用 ClearQuest核心跟踪功能.
在UNIX上启用核心跟踪功能,需要修改文件start_cqreg.sh,这个文件在目录/opt/rational/clearquest/cqweb/cqregsvr下.
注意: 如果您指定了不同的安装目录, 请按您的安装目录来修改文件

添加下面的几行到文件的头部:

CQ_DIAG_TRACE="PERL;SQL=3;RESULTSET=2;HOOKS=2;THROW;EDIT;TIMER;API;SCRIPTSERVER;SESSION;LICENSE;DB_MISC;DB_CONNECT;"

CQ_DIAG_REPORT="MESSAGE_INFO=0x070B;DIAG_FLAGS=-1;OUTPUT_LIMIT=1000000" CQ_DIAG_OUTPUT="/opt/rational/clearquest/cqweb/cqserver
/logs/cq_trace.log"
export CQ_DIAG_TRACE
export CQ_DIAG_REPORT
export CQ_DIAG_OUTPUT

注意:
如果您指定了不同的安装目录, 请您修改文件文件时按您指定的安装路径赋相应的值给参数CQ_DIAG_OUTPUT
如果您运行ClearQuest Web组件在不同的服务器,请在ClearQuest的注册服务器上启用跟踪功能。

移除以前生成的所有日志文件
在下面的目录里:

<install dir>/Rational/common/rwp/logs
<install dir>/Rational/ClearQuest/cqweb/cqserver/logs
<install dir>/Rational/ClearQuest/cqweb/cqregsvr/logs

删除所有已存在的ClearQuest跟踪日志文件(它应该在目录<install dir>/Rational/ClearQuest/cqweb/cqregsvr/logs下)

编辑下面文件:

<install dir>/Rational/ClearQuest/cqweb/cqserver/config/logging.xml
<install dir>/Rational/ClearQuest/cqweb/cqregsvr/config/logging.xml
<install dir>/Rational/Common/rwp/webapps/cqweb/WEB-INF/classes/logging.xml

对每一个文件,在文件的开头,有一个赋给"logger level"的值。请把默认值"Severe"改成"Debug"并保存。
重起服务:
运行 rwp_startup.sh, 该脚本在目录 <install dir>/Rational/common/rwp/bin下
运行 cqserver_startup.sh, 该脚本在目录 <install dir>/Rational/clearquest/cqweb下

在ClearQuest Web上重现错误,之后注销。

再次停掉服务:
运行 "rwp_shutdown.sh", 该脚本在目录 <install dir>/Rational/common/rwp/bin下
运行 "cqserver_shutdown.sh", 该脚本在目录 <install dir>/Rational/clearquest/cqweb下

在下面的目录里收集日志文件

<install dir>/Rational/common/rwp/logs
<install dir>/Rational/ClearQuest/cqweb/cqserver/logs
<install dir>/Rational/ClearQuest/cqweb/cqregsvr/logs

也请收集ClearQuest跟踪日志文件(应该在目录<install dir>/Rational/ClearQuest/cqweb/cqregsvr/下),并且把所有的日志文件压缩到一个ZIP或TAR文件中。
禁用ClearQuest核心跟踪功能.

删除下面目录中的所有日志文件

<install dir>/Rational/common/rwp/logs
<install dir>/Rational/ClearQuest/cqweb/cqserver/logs
<install dir>/Rational/ClearQuest/cqweb/cqregsvr/logs

和ClearQuest跟踪的日志文件(它应该在目录<install dir>/Rational/ClearQuest/cqweb/cqregsvr/logs下)
您的ZIP或TAR文件里应该有它们备份,所以您不需要它们了。

编辑下面的文件:

<install dir>/Rational/ClearQuest/cqweb/cqserver/config/logging.xml
<install dir>/Rational/ClearQuest/cqweb/cqregsvr/config/logging.xml
<install dir>/Rational/Common/rwp/webapps/cqweb/WEB-INF/classes/logging.xml

把文件开头赋给"logger level"的值改成默认值"Severe"并保存。

禁用ClearQuest核心跟踪功能.

如果想在UNIX系统上禁用核心跟踪功能,需要修改文件start_cqreg.sh,您可以在目录/opt/rational/clearquest/cqweb/cqregsvr下找到文件start_cqreg.sh.

注意: 如果您指定了不同的安装目录, 请按您的安装目录来修改文件

按照下面的例子修改那些您之前添加到这个脚本里的用以启用跟踪功能的行.

CQ_DIAG_TRACE=""
CQ_DIAG_REPORT=""
CQ_DIAG_OUTPUT=""
export CQ_DIAG_TRACE
export CQ_DIAG_REPORT
export CQ_DIAG_OUTPUT

重起服务:
运行 rwp_startup.sh, 该脚本在目录 <install dir>/Rational/common/rwp/bin下
运行 cqserver_startup.sh, 该脚本在目录<install dir>/Rational/clearquest/cqweb下




附加说明:
在ClearQuest信息中心里有关于如何解决问题的概述(请看"Troubleshooting and support"章节).
请在ClearQuest网上支持站点查找相关技术文档和关于下载,培训的资料.

备注1:
在某些情况下, ClearQuest支持工程师可能请您改变日志纪录级别到比默认的"WARN"更高的级别.请阅读技术文档1141306
获得更多相关信息.

core_trace_for_web.zip

[{"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Web Java Server","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"2003.06.16;7.0;7.0.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21445843