如何重新啟動 IBM Rational ClearCase 轉接器
如果出現下列系統錯誤，請重新啟動 IBM Rational ClearCase 轉接器：
• 啟動應用伺服器時，如果轉接器出現問題，系統將會在轉接器並未執行時顯示錯誤。
• 嘗試從 Windchill 中開啟任何 IBM Rational ClearCase 瀏覽器都會顯示錯誤。
在下列情況下，請重新啟動 IBM Rational ClearCase 轉接器：
• 如果遠端安裝轉接器
或
• 如果您需要在單獨 Java Virtual Machine (JVM) 中，而非 Windchill 應用伺服器中執行 IBM Rational ClearCase 轉接器
本節說明如何配置轉接器以在與 Windchill JVM 不同的 JVM 上執行它。
安裝 IBM Rational ClearCase 轉接器的檔案
下一節說明如何在遠端機器上安裝 IBM Rational ClearCase 轉接器的檔案。
1. 請在要執行轉接器的電腦上建立目錄 ADAPTER_HOME，例如 D:\SCMI-OOP。
2. 從 Windchill「快速連結」下拉清單存取「軟體下載」頁。
3. 將 cc.zip 檔案從 PTC 軟體下載頁複製到用戶端電腦上。
編輯啟動 IBM Rational ClearCase 轉接器的 bat 檔案
下一節說明如何在遠端機器上安裝 IBM Rational ClearCase 轉接器的檔案。
1. 將 cc.zip 中的 startCCADapter.bat 複製到 <ADAPTER_HOME> 目錄中。
2. 編輯 startCCADapter.bat。
3. 指定下列值：
◦ ADAPTER_HOME - 指定擷取所有來自 cc.zip 檔案的 jar 檔案的目錄。例如：
set ADAPTER_HOME=D:\SCMI-OOP
◦ JAVA_HOME - 指定 JDK 的位置 (轉接器所在的電腦)。JDK 1.7 版應該安裝在用戶端電腦上。例如，
set JAVA_HOME=c:\jdk\jdk1.7_0
 |
此外，也請確認 IEPROPFILE、IEMYNAME、IENAMINGSERVICENAME 都擁有如 startCCAdapter.bat 檔案註解所述的正確值。
|
例如，
set JAVA_HOME=c:\jdk\jdk<version number>
◦ ADAPTER_NAME -- 指定在 Windchill 中建立之轉接器的名稱。
例如，
set ADAPTER_NAME=$WC.com.ptc.swlink.scm.defaultAdapter$
|
|
此外，也請確認 IEPROPFILE、IENAMINGSERVICENAME 都擁有如 startCCAdapter.bat 檔案註解所述的正確值。
|
◦ install.jar -- 將 install.jar 新增至已設定全部類別路徑的類別路徑。
例如，
set CLASSPATH=%SCM_HOME%\install.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%;%CLASSPATH%
set CLASSPATH=%SCM_HOME%;%CLASSPATH%
◦ wt.home -- 將 wt.home 屬性新增至 java 指令中的註解
“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.windchill.scm.adapter.clearcase.
CcMultithreadedAdapter
-DruntimeServiceName="%ADAPTER_NAME%" -DserviceName="%ADAPTER_NAME%"
-DnamingServiceName="%IENAMINGSERVICENAME%"
-Dwt.home="%SCM_HOME%" com.ptc.windchill.scm.adapter.clearcase.
CcMultithreadedAdapter
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
啟動 IBM Rational ClearCase 轉接器
最後一步為啟動 IBM Rational ClearCase 轉接器。轉接器執行之後，啟動 Windchill 伺服器，即 servlet engine。
1. 使用 startCCAdapter.bat 檔案，在轉接器所在的電腦上啟動該轉接器。
2. 轉接器啟動之後，啟動 Windchill 伺服器 servlet 引擎。現在，轉接器應該已經成功配置並遠端執行了。