設定 Rational® Engineering Lifecycle Manager 的 Tomcat 伺服器

部署及啟動 Jazz™ Team Server,首先要選取管理 Jazz Team Server 及其應用程式的應用程式伺服器。

關於這項作業

部署及啟動 Jazz Team Server,首先要選取管理 Jazz Team Server 及其應用程式的應用程式伺服器。

如果您打算利用內含的 Apache Tomcat 應用程式伺服器作為您的 Jazz Team Server 管理環境,請按一下部署及啟動 Apache Tomcat 伺服器鏈結。

如果您打算使用 IBM® WebSphere® Application Service 作為您的管理環境,請按一下部署及啟動 WebSphere Application Server 鏈結。

解決在 Linux 上以遠端控制模式啟動 RM 伺服器時發生的錯誤。RM 應用程式包含轉換器,提供圖形構件的視覺化呈現,例如商業程序圖、使用案例圖、組件圖、概略圖、分鏡腳本及畫面流程。 轉換器在伺服器上執行。在 Linux 上以遠端控制(主控台)模式啟動 RM 伺服器時,動作會無聲自動失敗,並發生 CRRRW8010E 錯誤。 如果發生這種情形,您必須終止 Java™ 程序並採取改善動作,才能順利啟動伺服器。 如需相關資訊,請參閱下列 Wiki 頁面:https://jazz.net/wiki/bin/view/Main/RRCConverterTroubleshooting

以 Windows 服務形式(64 位元)在 Apache Tomcat 中執行

如果要在 64 位元電腦中以服務形式來執行 Jazz Team Server,您必須配置 Jazz Team Server 隨附的 Tomcat 64 位元版本。

開始之前

提示: 為了避免發生問題,請勿在檔案路徑中使用空格。 例如,以 Program Files 目錄而言,您可以使用 PROGRA~1
如果您使用 Derby 作為 Jazz 儲存庫的資料庫,請編輯每個應用程式的 teamserver.properties 檔,使 DB 位置成為絕對路徑。將 app name 變數替換成適當的應用程式目錄名稱,例如,jtsccmqm。 在下列範例中,JazzInstallDir 是指 Jazz Team Server 的安裝位置。
  1. 開啟 JazzInstallDir\server\conf\app name\teamserver.properties 檔。
  2. com.ibm.team.repository.db.jdbc.location=conf/app name/derby/repositoryDB 項目變更為 com.ibm.team.repository.db.jdbc.location=C:/JazzInstallDir/server/conf/app name/derby/repositoryDB。請注意路徑中的(正)斜線 (/)。
  3. 另外,對於應用程式,將 com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527/conf/jts/derby/warehouseDB 項目變更為 com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527/C:/JazzInstallDir/server/conf/jts/derby/warehouseDB。 對於 JTS,將 com.ibm.team.datawarehouse.db.jdbc.location=conf/jts/derby/warehouseDB 項目變更為 com.ibm.team.datawarehouse.db.jdbc.location=C:/JazzInstallDir/server/conf/jts/derby/warehouseDB。 請注意路徑中的(正)斜線 (/)。
除了編輯 teamserver.properties 之外,您也必須編輯 log4j.properties 檔,以建立絕對的日誌檔路徑名稱。 將 app name 變數替換成適當的應用程式目錄名稱,例如,jtsccmqmrmadmin。 將 app name.logapp name-etl.log 變數替換成每一個適當的應用程式日誌檔名稱,例如,jts.logccm.logqm.logrm.logadmin.logjts-etl.logccm-etl.logqm-etl.log (admin 和 rm 沒有 *-etl.log):
  1. 開啟 JazzInstallDir\server\conf\app name\log4j.properties 檔。
  2. log4j.appender.file.File=logs/appName.log 項目變更為 log4j.appender.file.File=C:/JazzInstallDir/server/logs/appName.log。 請注意路徑中的(正)斜線 (/)。
  3. log4j.appender.etl.File=logs/appName-etl.log 項目變更為 log4j.appender.etl.File=C:/JazzInstallDir/server/logs/appName-etl.log。 請注意路徑中的(正)斜線 (/)。
註: 如果您跳過這個步驟,並且沒有提供日誌檔的路徑,會將日誌檔寫入到預設 Windows 目錄。舉例來說,在 Windows 7 中,日誌目錄是 C:\Windows\System32\LogFiles

請確認沒有安裝這個服務。 如果已安裝這個服務,請將服務解除安裝,然後重新啟動電腦。 然後安裝新的服務。

程序

  1. 遵循下列步驟來設定 CATALINA_HOME 變數:
    1. 從「Windows 控制台」,開啟「系統內容」視窗。
    2. 按一下進階標籤,然後按一下環境變數
    3. 在「系統變數」之下,按一下新建
    4. 變數名稱中,輸入 CATALINA_HOME,在變數值中,輸入 C:\JazzInstallDir\server\tomcat
  2. 重新啟動系統,使變數生效。
  3. 開啟命令提示字元,切換至 JazzInstallDir\server\tomcat\bin 目錄,輸入下列指令,以安裝新的 64 位元服務:

    service.bat install tomcat7.

    註: 在具有「使用者帳戶控制 (UAC)」的 Windows 作業系統上(例如,Windows 7),必須以管理者的身分來執行指令 Shell。
  4. 執行 JazzInstallDir\server\tomcat\bin\tomcat7w.exe 程式來配置服務。
  5. 按一下 Java 標籤,然後清除使用預設值勾選框。
  6. 新增下列路徑至 Java 虛擬機器。 您也可以按一下省略符號圖示,瀏覽並找出 jvm.dll 檔。
    JazzInstallDir\server\jre\bin\j9vm\jvm.dll
  7. Java 選項文字欄位尾端,新增下列各行
    註: -DJAZZ_HOME-Dlog4j.configuration 的路徑必須是 URL 路徑。 請注意 "file:" 後面的三條正斜線 (///) 及路徑中的正斜線。tempDir 的路徑必須是絕對路徑。
    -DJAZZ_HOME=file:///C:/JazzInstallDir/server/conf
    -Djava.awt.headless=true 
    -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true 
    -Dcom.ibm.team.repository.tempDir=C:\JazzInstallDir\server\tomcat\temp
    -Djazz.connector.sslProtocol=SSL_TLS
    -Djazz.connector.algorithm=IbmX509
    -Dlog4j.configuration=file:///C:/JazzInstallDir/server/conf/startup_log4j.properties
    -Xmx4g
    -Xms4g
    -Xgcpolicy:gencon
    -Xcompressedrefs 
    如果您的 Jazz Team Server 安裝在 Windows 平台上,但是您使用 DB2® for z/OS® 資料庫伺服器,請新增這一行,將路徑替換成驅動程式位置。
    註: 磁碟機位置的路徑必須是檔案路徑,並注意使用(正)斜線。
    -DDB2Z_JDBC=D:/JazzInstallDir/server/db2z
    如果您使用 Oracle 資料庫,請新增這一行,將路徑替換成磁碟機位置。
    註: 磁碟機位置的路徑必須是檔案路徑。
    -DORACLE_JDBC_DRIVER_FILE=C:\OJDBCLocation\ojdbc6.jar
    如果您使用 SQL Server 資料庫,請新增這一行,將路徑替換成磁碟機位置。
    註: 磁碟機位置的路徑必須是檔案路徑。
    -DSQLSERVER_JDBC_DRIVER_FILE=C:\SQLJDBCLocation\sqljdbc4.jar
  8. 記憶體儲存區上限中,將儲存區大小變更為 4000。
  9. 啟動關閉標籤中,確定已在模式設定中選取 jvm
  10. 一般標籤,將啟動類型變更為自動,以便在 Windows 啟動時,自動啟動服務。
  11. 當服務啟動之後,請從瀏覽器登入伺服器,來驗證伺服器正在執行。

意見