IBM Support

设置ClearCase Remote Client的调试跟踪。

Question & Answer


Question

如何打开客户端的调试跟踪(Debug Tracing) 来排除IBM Rational ClearCase Remote Client (CCRC)(包括完整客户端平台和Eclipse插件)的问题

Answer


注意:如需诊断CCRC 7.1版本的问题,请查阅技术文档
1413762 ClearCase Remote Client (CCRC) 7.1版本必须收集的文档

启用 CCRC (Eclipse插件和CCRC完整版客户端)跟踪:

  1. 备份当前工作台(workspace)的.log文件。
    注意:工作台的.log文件默认存储在下面的路径中:

    WINDOWS:C:\Documents and Settings\{用户名}\.Rational\CCRC701\workspace\.metadata\.log

    LINUX/UNIX:{~用户名}/.Rational/CCRC701/workspace/.metadata/.log
  2. 在Eclipse或者CCRC应用程序所在的目录下,创建一个名称为”.options”的文件。
    注意:在Windows平台上,创建用句点(“.”)开头的文件的操作需要在命令行完成。

    Windows范例:
    .options文件必须在命令行窗口建立,因为Windows浏览器不允许您创建用句点(“.”)开头的文件。

    说明:
    1. 打开一个命令行窗口(点击 开始 > 运行,键入cmd)。
      进入CCRC的安装目录(默认为C:\Program Files\IBM\Rational\ClearCase\CCRCC:\>cd C:\Program Files\IBM\Rational\ClearCase\CCRC
    2. 注意:CCRC 7.0.1安装目录为C:\Program Files\IBM\Rational\ClearCase701
    3. 用记事本程序创建.options文件
      C:\Program Files\IBM\Rational\ClearCase\CCRC>notepad .options

      注意:当下面窗口出现时选择“是”:
  3. 将下面的文本拷贝至.options文件,然后将{文本文件路径}部分替换为一个适合存储客户端跟踪日志文件的路径(比如, Windows平台上C:\\ccrc_client_trace.txt或者UNIX/Linux平台上 /tmp/ccrc_client_trace.log)

    提示:下面的文本中同时包含客户端和服务器端跟踪的选项。

    注意:在Windows平台上,需要使用斜线而不是反斜线。

    # -------------- CCRC Tracing Options File -----------------
    # All line preceeded with a # sign are not evaluated.

    # ------Server Tracing-------
    # subsystems available:
    # CCRC - Core general tracing related to CCRC server operations
    # CCWEB- CCWeb(CGI operations)
    # SUM -  UCM specific
    com.ibm.rational.clearcase/server_trace=true
    com.ibm.rational.clearcase/server_trace/subsys=CCRC:CCWEB:SUM
    com.ibm.rational.clearcase/server_trace/level=4

    # ------Client Only Tracing-------
    # Parameters available:
    # HTTP_CLIENT - Tracing specific to HTTP communications
    # CTRC_UI -     Tracing specific to the user interface
    # CTRC_CORE -   For client core tracing

    com.ibm.rational.clearcase/client_trace=true
    com.ibm.rational.clearcase/client_trace/params=HTTP_CLIENT:4 CTRC_UI:3

    CTRC_CORE:3com.ibm.rational.clearcase/client_trace/output=file
    com.ibm.rational.clearcase/client_trace/file_name=
    {文本文件路径}
    # --------------------------------------------------------------


  4. 用-debug模式启动Eclipse或者CCRC客户端。
    选择1 Windows,UNIX以及Linux命令行。
      用下面的方法通过命令行启动Eclipse或者CCRC的-debug模式:

      Windows范例:
      C:\Program Files\IBM\Rational\ClearCase\CCRC>ccrc -debug

      C:\eclipse_3.1.2\eclipse>eclipse.exe -debug

      Linux范例:
      /opt/IBM/Rational/CCRC701/ccrc -debug


      /opt/eclipse_3.2/eclipse/eclipse -debug

      注意: 调试操作将指向默认的安装路径下的.options文件,但是,如果您由于安全限制对于这个目录没有写入的权限,您可以把.options文件建立在别的目录然后指向它的目录。

      下面这个例子中,将.options文件创建在另外一个目录并指向它:
      C:\Program Files\IBM\Rational\CCRC>ccrc -debug "C:\Documents and Settings\username\.options"
    选择2 Windows图形界面
      修改CCRC或者Eclipse的快捷方式,将-debug参数加入到目标窗口的可执行程序之后
      注意:-debug参数必须加在其它任何参数之前。


      Windows范例:

      例子:


      通过双击您的新快捷方式启动CCRC或者Eclipse的调试模式。

      注意:通过按调试模式启动CCRC或者Eclipse,一个命令行窗口会自动打开并提示.options文件已经成功载入,同时还会提示客户端跟踪日志文件的路径。


  1. 在CCRC中执行操作。请记录下您开始操作的时间(系统时间)以便于技术支持人员分析跟踪日志(这对于分析比较复杂的操作跟踪时尤其有帮助)。

    当您希望诊断的任务完成后关闭CCRC。

    * 将上面产生的客户端日志收集起来并发给技术支持人员。

    * 将Rational Web Platform (RWP)服务器上的日志收集起来并发给技术支持人员(如果服务器端跟踪已经激活且日志文件已经产生)。调试用的服务器日志文件保存在下面的目录:

    WINDOWS: C:\Program Files\Rational\ClearCase\var\log\trace\{USERNAME}\*.log

    LINUX/UNIX:
    /var/adm/rational/clearcase/log/trace/{username}/*.log

    注意:每一个发送到服务器的远程程序调用(RPC)会产生多个文件。

    例子
    ccrc_fred_s1707973141_d070720_t211420_p24232.log

    -- s######是用户的进程编号。
    查看session.dat文件,Winodws: C:\ccweb\{用户名},UNIX或者Linux: /var/adm/rational/clearcase/ccweb/{用户名}
    -- d######是远程程序调用的日期。
    -- t######是远程程序调用的时间。
    -- p######是通讯包的序列号。
  2. 调试跟踪的同时,请收集实例的配置。具体方法请查看 帮助 > 关于Rational ClearCase Remote Client> 配置信息

    将文本拷贝到一个文本文件。

    这将给技术支持人员提供该Eclipse实例的详细信息。

Related Information

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"ClearCase Remote Client","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF015","label":"IRIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"2003.06.14;2003.06.15;2003.06.16;7.0;7.0.0.1;7.0.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
29 September 2018

UID

swg21445437