IBM Rational ClearCase アダプタを再起動する方法
次のいずれかのシステムエラーが発生した場合、IBM Rational ClearCase アダプタを再起動してください。
• メソッドサーバーの起動中に、アダプタに問題があり、アダプタが動作していないことを示すエラーが表示された場合
• Windchill から IBM Rational ClearCase ブラウザを起動しようとしたときに、エラーが表示された場合
次の場合は、IBM Rational ClearCase アダプタを再起動します。
• アダプタがリモートでインストールされている場合
または
• IBM Rational ClearCase アダプタを、Windchill メソッドサーバーではなく、別の Java 仮想マシン (JVM) で実行する必要がある場合
このセクションでは、Windchill JVM 以外の JVM で実行するようにアダプタを設定する方法について説明します。
IBM Rational ClearCase アダプタへのファイルのインストール
以下のセクションでは、リモートマシンに IBM Rational ClearCase アダプタのファイルをインストールする方法について説明します。
1. アダプタを実行するマシンに ADAPTER_HOME ディレクトリを作成します (たとえば、D:\SCMI-OOP)。
2. Windchill の「クイックリンク」ドロップダウンリストで「ソフトウェアのダウンロード」ページにアクセスします。
3. PTC のソフトウェアダウンロードページから、cc.zip ファイルをクライアントマシンにダウンロードします。
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 - すべてのクラスパスが設定されている classpath に追加します。たとえば、次のようになります。
例:
set CLASSPATH=%SCM_HOME%\install.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%;%CLASSPATH%
set CLASSPATH=%SCM_HOME%;%CLASSPATH%
◦ 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 サーバーサーブレットエンジンを起動します。
1. startCCAdapter.bat ファイルを使用して、アダプタが常駐するマシンでアダプタを起動します。
2. アダプタが起動したら、Windchill サーバーサーブレットエンジンを起動します。これでアダプタは正常に設定され、リモートで実行されました。