IBM Support

Getting Started with Remote Cleartool (rcleartool) - CCRC CLI

Question & Answer


Question

How do I install, configure, and get started with CCRC CLI?

Answer

This document describes the installation and configuration of CCRC CLI.

Overview

The CCRC CLI is installed with the ClearTeam Explorer (CTE) package. This is available for install through the IBM Installation Manager.

Pre-requisites

This release of CCRC CLI (rcleartool) requires a CCRC WAN Server to be upgraded to ClearCase version 8.0.0.3 or higher.

IBM Rational ClearCase or IBM Rational ClearCase Remote Client

Installing either IBM Rational ClearCase or the IBM Rational ClearCase Remote Client installs CCRC CLI. These are sample paths to the installation:

Windows:


C:\Program Files\IBM\RationalSDLC\ClearCase\RemoteClient\rcleartool.bat
C:\Program Files\IBM\RationalSDLC\ClearCase\RemoteClient\rcleartool.conf

Unix systems:
/opt/ibm/RationalSDLC/clearcase/RemoteClient/rcleartool
/opt/ibm/RationalSDLC/clearcase/RemoteClient/rcleartool.conf

IBM Rational ClearTeam Explorer Extension

If ClearTeam Explorer Extension is installed into a Rational Desktop product, the rcleartool script file will be installed alongside eclipse.exe for that product. For example when CTE is installed into Rational Team Concert (RTC), you could find the rcleartool files here:

Windows:
C:\Program Files\IBM\TeamConcert\rcleartool.bat
C:\Program Files\IBM\TeamConcert\rcleartool.conf

Unix:
/opt/ibm/TeamConcert/rcleartool
/opt/ibm/TeamConcert/rcleartool.conf

NOTE: Installing ClearTeam Explorer Extension in RTC on Windows
When installing into RTC, the java path provided at installation time is not compatible with CCRC CLI. This is a known issue with this release. The following work around is required to use rcleartool under this scenario.
1. Locate rcleartool.bat
Example: C:\Program Files\IBM\TeamConcert\rcleartool.bat
2. Open the file for editing.
3. The following line must be modified, keep the path provided in <PATH TO TEAM CONCERT> and only replace javaw.exe with java.exe.
from:
if not defined _JAVACMD set _JAVACMD=<PATH TO TEAM CONCERT>\jdk\jre\bin\javaw.exe

to:
if not defined _JAVACMD set _JAVACMD=<PATH TO TEAM CONCERT>\jdk\jre\bin\java.exe

4. Proceed to run rcleartool for the first time.

Running rcleartool for the first time

On the first run of rcleartool, there will be an automatic configuration of paths to determine where to find the rcleartool jars and the CM API jars path. This information is written to the rcleartool script for future use with this release.

Note: An automatic configuration of paths will only work if the current directory must be the directory containing rcleartool, such as this:



# cd /opt/rational/clearcase/RemoteClient
# ./rcleartool
Configuring rcleartool for first time use
Configuring /opt/ibm/RationalSDLC/clearcase/RemoteClient/rcleartool for first time use.
Finished updating /opt/ibm/RationalSDLC/clearcase/RemoteClient/rcleartool
RCleartool now configured for use. Please re-enter command.

Note: On Unix, rcleartool script requires root access to write/modify script itself. So if you run rcleartool script for the first time other than root then it will create a copy of rcleartool script into the user's home directory and configure it automatically. You can use this new rcleartool script for future rcleartool use.

Adding rcleartool to your system PATH

Installing CCRC CLI does not automatically add rcleartool to your PATH variable. If you want to be able to run the 'rcleartool' command from any directory, add the installed directory (see above for example paths to rcleartool).

What is rcleartool.conf?

The file 'rcleartool.conf' is a text file that should be present in the same directory as 'rcleartool.bat' (or 'rcleartool' on UNIX). This file is used to provide any custom Java VM flags. For instance, if you wanted to specify a particular language, in this example Spanish, you could add a line to the file 'rcleartool.conf':

-Duser.language=es

There are no required properties to be set in this file at this time.

Manual configuration of the rcleartool script

If you are installing ClearTeam Explorer from the Eclipse update site, 'rcleartool.bat' / 'rcleartool' scripts must be configured manually. Take the following steps to manually configure the rcleartool scripts. In the following example <ECLIPSE_HOME> refers to the location of your eclipse installation, the same directory eclipse.exe would reside.

On Windows:

  1. Copy 'rcleartool.bat' from (your path version number may be slightly different, choose the latest version of the CCRC CLI directory) <ECLIPSE_HOME>\plugins\com.ibm.rational.ccrc.cli_8.0.0.v20120614_0216\rcleartool.bat
    to <ECLIPSE_HOME>\rcleartool.bat
  2. Open 'rcleartool.bat' to edit the following line replacing <JAVA_EXE_PATH> with the full path to your installed version of Java 6 (or greater) JRE:
    from:
    if not defined _JAVACMD set _JAVACMD=_JAVA_CMD_PATH_
    to:
    if not defined _JAVACMD set _JAVACMD=<JAVA_EXE_PATH>

    Here is an example of a valid input for this line:
    if not defined _JAVACMD set _JAVACMD=C:\Program Files\IBM\Java60\jre\bin\java.exe
  3. Run the 'rcleartool.bat' file once to configure the remaining paths automatically. Note: An automatic configuration of the remaining paths will only work if the current directory must be the directory containing rcleartool.
  4. You may now add <ECLIPSE_HOME> to your system PATH variable in order to run rcleartool from any directory in your command window.

On Unix:
  1. Copy 'rcleartool.bat' from (your path version number may be slightly different, choose the latest version of the CCRC CLI directory) <ECLIPSE_HOME>\plugins\com.ibm.rational.ccrc.cli_8.0.0.v20120614_0216\rcleartool
    to <ECLIPSE_HOME>\rcleartool
  2. Open 'rcleartool' to edit the following line replacing <JAVA_EXE_PATH> with the full path to your installed version of Java 6 (or greater) JRE:
    from:
    _JAVACMD=${_JAVACMD:-_JAVA_CMD_PATH_}
    to:
    _JAVACMD=${_JAVACMD:-<JAVA_EXE_PATH>}

    Here is an example of a valid input for this line:
    _JAVACMD=${_JAVACMD:-/opt/IBM/Java60/jre/bin/java}
  3. Run 'rcleartool' once to configure the remaining paths automatically. Note: An automatic configuration of the remaining paths will only work if the current directory must be the directory containing rcleartool.
  4. You may now add <ECLIPSE_HOME> to your system PATH variable.

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.0.0.3;8.0.0.4;8.0.0.5;8.0.0.6;8.0.0.7;8.0.0.8;8.0.1;8.0.1.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21598728