How to turning on client side tracing for use in troubleshooting IBM® Rational® ClearCase® Remote Client (CCRC) issues on Microsoft® Windows®.
To enable tracing within CCRC:
1. Open a command prompt (Start > Run type cmd) and navigate to the CCRC installation directory:
(default) C:\Program Files\IBM\Rational\ClearCase\CCRC
2. Create a file named .options
Note: The file name must be created at the command line as Windows Explorer does not allow you to create files with a preceding period (dot).
Example:
C:\>cd C:\Program Files\IBM\Rational\ClearCase\CCRC
C:\Program Files\IBM\Rational\ClearCase\CCRC>notepad .options
The following window will appear - Click Yes
3. Type (or copy and paste) the following lines into the .options file:
com.ibm.rational.clearcase/client_trace=true
com.ibm.rational.clearcase/client_trace/output=file
com.ibm.rational.clearcase/client_trace/file_name=c:/ccrc_client.txt
com.ibm.rational.clearcase/client_trace/params=*:4
com.ibm.rational.clearcase/server_trace=true
com.ibm.rational.clearcase/server_trace/level=4
com.ibm.rational.clearcase/server_trace/subsys=CCRC
4. Start CCRC using the -debug switch.
Option 1:
Command line start: ccrc -debug
Example: C:\Program Files\IBM\Rational\ClearCase\CCRC>ccrc -debug
Option 2:
Modify the ClearCase Remote Client shortcut and add the -debug switch after the ccrc executable in the target window.
Note: The -debug switch must come first before any other switches.
Example:
Double click your new shortcut to start CCRC in debug mode.
5. A command window open and will display a message that the .options file was loaded successfully.
6. Use CCRC and reproduce the problem.
7. Locate the ccrc_client.txt file on the client located in the path specified on line 3 of the .options file (copied from step 3 above); by default at the root of the C drive.
8. Locate the trace log file on the Rational Web Platform (RWP) server:
No comments:
Post a Comment