Question & Answer
Question
Answer
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 9.0.1 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:
- 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 - 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 - In case of problem you may need to define additional variables, example:
- if not defined RCLEARTOOL_HOME set RCLEARTOOL_HOME=<ECLIPSE_HOME>\plugins\com.ibm.rational.ccrc.cli_8.0.0.v20171108_0148
if not defined JARS_DIR set JARS_DIR=<ECLIPSE_HOME>\plugins\com.ibm.rational.teamapi_8.0.1.v20171103_0502
if not defined CCRC_CLEARDIFF_PATH set CCRC_CLEARDIFF_PATH=<ECLIPSE_HOME>\plugins\com.ibm.rational.clearcase.compare_merge.win32.x86_8.0.1.v20170829_2326
if not defined ORG_APACHE_XML_PATH set ORG_APACHE_XML_PATH=<ECLIPSE_HOME>\plugins\org.apache.xmlrpc_2.0.0.jar
4. 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.
On Unix:
- 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 - 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} - 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.
- You may now add <ECLIPSE_HOME> to your system PATH variable.
Was this topic helpful?
Document Information
Modified date:
18 May 2022
UID
swg21598728