How to Install Files for a Subversion Remote Adapter
Before installing files for the Subversion remote adapter, see, Using a Subversion Adapter as a Remote Client to learn the steps required in using a Subversion adapter as a remote client.
Use this procedure to install files for a Subversion adapter on a remote machine.
1. Create directory ADAPTER_HOME on the machine where the Subversion adapter is 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 Subversion Adapter — download this package (svn.zip) to install and run the Subversion adapter .bat file.
Configuring the Subversion adapter on the remote machine
The following section explains how to configure a Subversion adapter on a remote machine.
1. Configure the startSVNAdapter.bat file using the downloaded Windchill to Subversion Adapter package, svn.zip.
a. Extract the svn.zip file to a local folder.
b. Copy startSVNAdapter.bat to the <ADAPTER_HOME> directory.
Example startSVNAdapter.bat file:
@echo off
rem Start up script for Windchill Integrations for
rem Embedded Software Subversion 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 svn.zip was extracted
set ADAPTER_HOME=
rem ADAPTER_NAME should be the set to the name of Subversion 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%\svn.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 Subversion 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 svn.zip was extracted
set ADAPTER_HOME=
rem ADAPTER_NAME should be the set to the name of Subversion 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%\svn.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 startSVNAdapter.bat file and specify the following values:
▪ ADAPTER_HOME— specify the directory where all the jar files from svn.zip file were extracted. For example:
set ADAPTER_HOME=D:\SVN-OOP
▪ JAVA_HOME— specify the location of JDK (on the machine where the Subversion adapter is running). JDK version 1.7 should be installed on the client machine.
For example,
set JAVA_HOME=c:\jdk\jdk1.7_0
▪ ADAPTER_NAME— specify the name of the Subversion 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 startSVNAdapter.bat file.
|
d. The final step is the start the Subversion adapter. Once the adapter is running, start the Windchill server, servlet engine.
a. Using the startSVNAdapter.bat file, start the Subversion adapter on the machine where it resides.
Once the adapter is started, start the Windchill server, servlet engine. The Subversion adapter should now be successfully configured and running remotely.