How to Install Files for an IBM ClearCase Remote Adapter
The following section explains how to install files for the IBM Rational ClearCase adapter on the remote machine.
1. Create directory ADAPTER_HOME on the machine where the IBM Rational ClearCase adapter will be run, for example D:\SVN-OOP.
2. Log in to Windchill and access the Software Downloads page from the Windchill Quick Links drop-down list. Under Windchill Integrations for Embedded Software, download the following files to your local machine:
◦ Windchill to IBM Rational ClearCase Adapter — download this package (cc.zip) to install and run the IBM Rational ClearCase adapter .bat file.
Configuring the IBM Rational ClearCase adapter on the remote machine
The following section explains how to configure the IBM Rational ClearCase adapter on the remote machine.
1. Configure the startCCAdapter.bat file using the downloaded Windchill to IBM Rational ClearCase Adapter package, cc.zip.
a. Extract the cc.zip file to a local folder.
b. Copy startCCAdapter.bat to the <ADAPTER_HOME> directory.
Example startCCAdapter.bat file:
@echo off
rem Start up script for Windchill Integrations for
rem Embedded Software IBM Rational ClearCase Adapter
rem *****************************************
rem User configured properties
rem set JAVA_HOME to the install location of the JDK
set JAVA_HOME=
rem set ADAPTER_HOME to the directory where the file cc.zip was extracted
set ADAPTER_HOME=
rem ADAPTER_NAME should be the set to the name of ClearCase adapter you created
rem in Windchill Integrations for Embedded Software.
set ADAPTER_NAME=$WC.com.ptc.swlink.scm.defaultAdapter$
rem *****************************************
rem IEPROPFILE should look like..
rem ldap://cn=manager:manager@test.ptc.com/dc=IeProps,dc=test...
rem and should be the same as 'seeAlso' value seen in the file
rem WT_HOME\codebase\WEB-INF\ie.properties
set IEPROPFILE=$WC.com.ptc.swlink.scm.iepropfile$
rem IENAMINGSERVICENAME should be the same as the value of
rem wt.federation.ie.namingService
rem in WT_HOME\codebase\wt.properties
set IENAMINGSERVICENAME=$WC.com.ptc.swlink.scm.ccConfig.host2$.namingService
set SCM_HOME=%ADAPTER_HOME%
set CLASSPATH=%JAVA_HOME%\lib\tools.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\servlet.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\ie3rdpartylibs.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\ieWeb.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\jmxcoreWeb.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\wc3rdpartylibs.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\CommonCore.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\MetaSpecCommon.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\cc.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\install.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%;%CLASSPATH%
title SCM Adapter
echo -------------------------------------------------------------------------------
echo Starting SCM Adapter
echo.
echo JAVA_HOME = %JAVA_HOME%
echo ADAPTER_HOME = %ADAPTER_HOME%
echo ADAPTER_NAME = %ADAPTER_NAME%
echo.
echo CLASSPATH = %CLASSPATH%
echo.
if not exist %JAVA_HOME%\bin\java.exe (
echo ERROR: Cannot find Java command - check JAVA_HOME value
echo.
pause
exit
)
if not exist %ADAPTER_HOME% (
echo ERROR: %ADAPTER_HOME% does not exist - check ADAPTER_HOME value
echo.
pause
exit
)
rem The following line starts the scm adapter as a standalone process
%JAVA_HOME%\bin\java.exe -cp "%CLASSPATH%" -DpropFile="%IEPROPFILE%"
-DruntimeServiceName="%ADAPTER_NAME%" -DserviceName="%ADAPTER_NAME%"
-DnamingServiceName="%IENAMINGSERVICENAME%" -Dwt.home="%SCM_HOME%"
com.ptc.swlink.scm.adapter.clearcase.CcMultithreadedAdapter
pause
rem Start up script for Windchill Integrations for
rem Embedded Software IBM Rational ClearCase Adapter
rem *****************************************
rem User configured properties
rem set JAVA_HOME to the install location of the JDK
set JAVA_HOME=
rem set ADAPTER_HOME to the directory where the file cc.zip was extracted
set ADAPTER_HOME=
rem ADAPTER_NAME should be the set to the name of ClearCase adapter you created
rem in Windchill Integrations for Embedded Software.
set ADAPTER_NAME=$WC.com.ptc.swlink.scm.defaultAdapter$
rem *****************************************
rem IEPROPFILE should look like..
rem ldap://cn=manager:manager@test.ptc.com/dc=IeProps,dc=test...
rem and should be the same as 'seeAlso' value seen in the file
rem WT_HOME\codebase\WEB-INF\ie.properties
set IEPROPFILE=$WC.com.ptc.swlink.scm.iepropfile$
rem IENAMINGSERVICENAME should be the same as the value of
rem wt.federation.ie.namingService
rem in WT_HOME\codebase\wt.properties
set IENAMINGSERVICENAME=$WC.com.ptc.swlink.scm.ccConfig.host2$.namingService
set SCM_HOME=%ADAPTER_HOME%
set CLASSPATH=%JAVA_HOME%\lib\tools.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\servlet.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\ie3rdpartylibs.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\ieWeb.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\jmxcoreWeb.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\wc3rdpartylibs.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\CommonCore.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\MetaSpecCommon.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\cc.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\install.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%;%CLASSPATH%
title SCM Adapter
echo -------------------------------------------------------------------------------
echo Starting SCM Adapter
echo.
echo JAVA_HOME = %JAVA_HOME%
echo ADAPTER_HOME = %ADAPTER_HOME%
echo ADAPTER_NAME = %ADAPTER_NAME%
echo.
echo CLASSPATH = %CLASSPATH%
echo.
if not exist %JAVA_HOME%\bin\java.exe (
echo ERROR: Cannot find Java command - check JAVA_HOME value
echo.
pause
exit
)
if not exist %ADAPTER_HOME% (
echo ERROR: %ADAPTER_HOME% does not exist - check ADAPTER_HOME value
echo.
pause
exit
)
rem The following line starts the scm adapter as a standalone process
%JAVA_HOME%\bin\java.exe -cp "%CLASSPATH%" -DpropFile="%IEPROPFILE%"
-DruntimeServiceName="%ADAPTER_NAME%" -DserviceName="%ADAPTER_NAME%"
-DnamingServiceName="%IENAMINGSERVICENAME%" -Dwt.home="%SCM_HOME%"
com.ptc.swlink.scm.adapter.clearcase.CcMultithreadedAdapter
pause
c. Edit the startCCAdapter.bat file and specify the following values:
▪ ADAPTER_HOME— specify the directory where all the jar files from cc.zip file were extracted, as described above. For example:
set ADAPTER_HOME=D:\SCMI-OOP
▪ JAVA_HOME— specify the location of JDK (on the machine where the IBM Rational ClearCase adapter will be running). JDK version 1.5 should be installed on the client machine.
For example,
set JAVA_HOME=c:\jdk\jdk1.5_0_06
▪ ADAPTER_NAME— specify the name of the IBM Rational ClearCase adapter that created in Windchill.
For example,
set ADAPTER_NAME=$WC.com.ptc.swlink.scm.defaultAdapter$
 |
Also verify that IEPROPFILE and IENAMINGSERVICENAME all have correct values as described in the comments of the startCCAdapter.bat file.
|
d. The final step is the start the IBM Rational ClearCase adapter. Once the adapter is running, start the Windchill server, servlet engine.
a. Using the startCCAdapter.bat file, start the IBM Rational ClearCase adapter on the machine where it is to be run.
b. Once the adapter is started, start the Windchill server, servlet engine. The IBM Rational ClearCase adapter should now be successfully configured and running remotely.