How to Restart the IBM Rational ClearCase Adapter
Restart the IBM Rational ClearCase adapter if you encounter either of the following system errors:
• During the method server start-up, if there is a problem with the adapter, the system displays an error if the adapter is not running.
• Attempting to bring up any IBM Rational ClearCase browser from Windchill displays an error.
Restart the IBM Rational ClearCase adapter:
• If it is installed remotely
or
• If you need to run an IBM Rational ClearCase adapter in a separate Java Virtual Machine (JVM), rather than the Windchill Method Server
This section explains how the adapter can be configured to run on a different JVM than the Windchill JVM.
Installing Files for an IBM Rational ClearCase 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 adapter is run, for example D:\SCMI-OOP.
2. Access the Software Downloads page from the Windchill Quick Links drop-down list.
3. Copy the cc.zip file from the PTC software downloads page to the client machine.
Editing the bat file to start the IBM Rational ClearCase adapter
The following section explains how to install files for the IBM Rational ClearCase adapter on the remote machine.
1. Copy startCCADapter.bat contained in cc.zip to the <ADAPTER_HOME> directory.
2. Edit startCCADapter.bat.
3. 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%
◦ 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
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
Starting the IBM Rational ClearCase Adapter
The final step is the start the IBM Rational ClearCase adapter. Once the adapter is running, start the Windchill server, servlet engine.
1. Using the startCCAdapter.bat file, start the adapter on the machine where it resides.
2. Once the adapter is started, start the Windchill server, servlet engine. The adapter should now be successfully configured and running remotely.