How to Reconfigure the IBM Rational ClearCase Adapter
Reconfigure the IBM Rational ClearCase adapters, after you have recreated IBM Rational ClearCase adapters, including the default adapter, in the Adapters Administration utility.
 |
For instructions on how to recreate the IBM Rational ClearCase adapters, including the default adapter, refer to Creating an Adapter.
|
This step is required if you:
• Migrated IBM Rational ClearCase 9.x content to the latest Windchill 10.2 release.
• Upgraded from Windchill 9.x to Windchill 10.2.
• Upgraded from Windchill 10.0 F000, or MOR to the latest Windchill 10.2 release.
1. Access the Software Downloads page from the Windchill Quick Links drop-down list.
2. Copy the cc.zip file from the PTC software downloads page to the client machine.
3. Copy startCCADapter.bat contained in cc.zip to the <ADAPTER_HOME> directory.
4. Edit startCCADapter.bat.
5. Specify the following values:
◦ ADAPTER_HOME— specify the directory where all the jar files from cc.zip file were extracted. For example:
set ADAPTER_HOME=D:\SCMI-OOP
◦ JAVA_HOME— specify the location of JDK (on the machine where the adapter resides). JDK version 1.7 should be installed on the client machine. For example,
set JAVA_HOME=c:\jdk\jdk1.7_0
|
|
Also verify that IEPROPFILE, IEMYNAME, IENAMINGSERVICENAME all have correct values as described in the comments of the startCCAdapter.bat file.
|
For example,
set JAVA_HOME=c:\jdk\jdk<version number>
◦ ADAPTER_NAME— specify the name of the adapter that created in Windchill.
For example,
set ADAPTER_NAME=$WC.com.ptc.swlink.scm.defaultAdapter$
|
|
Also verify that IEPROPFILE, IENAMINGSERVICENAME all have correct values as described in the comments of the startCCAdapter.bat file.
|
◦ install.jar—add install.jar to the classpath, where all classpaths are set.
For example,
set CLASSPATH=%SCM_HOME%\install.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%;%CLASSPATH%
set CLASSPATH=%SCM_HOME%;%CLASSPATH%
◦ wt.home—add a wt.home property to the java command, under the comment
“rem The following line starts the scm adapter as a standalone process".
For example,
%JAVA_HOME%\bin\java.exe -cp "%CLASSPATH%" -DpropFile="%IEPROPFILE%"
-DruntimeServiceName="%ADAPTER_NAME%" -DserviceName="%ADAPTER_NAME%"
-DnamingServiceName="%IENAMINGSERVICENAME%"
-Dwt.home="%SCM_HOME%" com.ptc.windchill.scm.adapter.clearcase.
CcMultithreadedAdapter
-DruntimeServiceName="%ADAPTER_NAME%" -DserviceName="%ADAPTER_NAME%"
-DnamingServiceName="%IENAMINGSERVICENAME%"
-Dwt.home="%SCM_HOME%" com.ptc.windchill.scm.adapter.clearcase.
CcMultithreadedAdapter
Example startCCAdapter.bat:
@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 the ClearCase adapter that 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
rem %JAVA_HOME%\bin\java.exe -cp "%CLASSPATH%" -DpropFile="%IEPROPFILE%"
rem -DruntimeServiceName="%ADAPTER_NAME%" -DserviceName="%ADAPTER_NAME%"
rem -DnamingServiceName="%IENAMINGSERVICENAME%" -Dwt.home="%SCM_HOME%"
rem 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 the ClearCase adapter that 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
rem %JAVA_HOME%\bin\java.exe -cp "%CLASSPATH%" -DpropFile="%IEPROPFILE%"
rem -DruntimeServiceName="%ADAPTER_NAME%" -DserviceName="%ADAPTER_NAME%"
rem -DnamingServiceName="%IENAMINGSERVICENAME%" -Dwt.home="%SCM_HOME%"
rem com.ptc.swlink.scm.adapter.clearcase.CcMultithreadedAdapter
pause
6. Using the startCCAdapter.bat file, start the IBM Rational ClearCase adapter on the machine where it resides.
7. Once the IBM Rational ClearCase adapter is started, start the Windchill server, servlet engine. The adapters should now be successfully configured and running remotely.