將隨附的 Rational Team Concert 伺服器應用程式部署在 Tomcat 上

IBM® Rational® Asset Manager 需要 IBM Rational Team Concert,以便控制可讓您用來管理資產開發的生命週期功能。如果您沒有 Rational Team Concert,會隨附該產品的有限版本,以供您部署到 Tomcat 伺服器上。

開始之前

如果您已部署和配置 Rational Team Concert 伺服器應用程式,可以使用現有的應用程式,而不需安裝新的應用程式。如果要將 Rational Team Concert 配置成使用 Rational Asset Manager,請參閱將 Rational Team Concert 伺服器配置成使用 Rational Asset Manager

您必須有已安裝且在執行中之 Tomcat 伺服器的管理和檔案存取權。

執行這項作業之前,請先完成下列作業:
  1. 擷取應用程式檔案
  2. 建立生命週期資料庫

您必須具備 Tomcat 伺服器的安全憑證。 Rational Team Concert 隨附版本需要安全連線。

關於這項作業

您可以增進 Rational Asset Manager 的效能和穩定性,作法是在個別的 Tomcat 伺服器上,安裝其 Web 應用程式和 IBM Rational Team Concert 隨附的應用程式檔案。在這整份文件中,Rational Asset Manager Tomcat 伺服器的安裝目錄稱為 tomcat_install_directoryRational Team Concert Tomcat 伺服器的安裝目錄是 tomcat_for_rtc_install_directory。如果您將所有的 Web 應用程式安裝在同一部 Tomcat 伺服器上,這些目錄會相同。

程序

  1. 驗證所有的儲存庫伺服器皆設定成相同的現行日期、時間與時區。
  2. 擷取適合 Tomcat 和您作業系統的保存檔中的應用程式檔案。這些應用程式檔案位於 archive_extract_location/apps/tomcat/ 資料夾。
  3. 若為 Windows: 若為 Linux:若為 AIX: 將 Rational Licensing Key Server 8.1.2 版的程式庫檔案解壓縮到 tomcat_for_rtc_install_directory\shared\lib 資料夾:
    重要: 若為 Linux for zSeries®,請勿完成這個步驟
    1. 尋找並解壓縮 archive_extract_location\sharedLibs\rlsclients_rlsibmratl_812.zip檔。
    2. 從解壓縮後的 .zip 檔,找出適合您作業系統與架構的 rlsibmratl812.zip 檔。例如,若為 32 位元 Windows,則檔案位於 win32 目錄。
    3. 解壓縮適當 rlsibmratl812.zip 檔的內容。
    4. 將解壓縮之 rlsibmratl812.zip 檔的內容,複製到 tomcat_for_rtc_install_directory\shared\lib 目錄。
    如果您將 Rational Asset ManagerRational Team Concert 安裝在相同的應用程式伺服器上,則您已完成這個步驟。
  4. 在安裝媒體中尋找 archive_extract_location/apps/tomcat/RTC-server.zip 檔。
  5. RTC-server.zip 解壓縮至您硬碟上的一個位置,在這些指示中,它稱為 rtc_install_dir
  6. 尋找 rtc_install_dir/jazz/server/ramjazz_war.ear 檔並解壓縮它。如果要解壓縮 .ear 檔,您可以使用像 7-Zip 之類的免費公用程式。從解壓縮的 ramjazz_war.ear 套件,將 ramjazz.war 檔複製到 tomcat_for_rtc_install_directory/webapps/ 目錄。
  7. 在 Tomcat 伺服器上配置 Rational Team Concert 的安全埠:
    1. 建立安全憑證來識別 Rational Team Concert 的 Tomcat 伺服器,以建立 SSL 連線。您可以利用 Java JDK keytool 指令,來建立自簽憑證。或者,要求取得授信憑證管理中心所簽發的憑證。
      如需利用 keytool 指令來建立自簽憑證的相關資訊,請參閱 Oracle Java 說明文件。您可以利用以下的 keytool 指令範例,來建立自簽憑證:
      keytool -genkey -alias tomcat -keystore tomcat_for_rtc_install_directory/.keystore

      執行該指令時,會提示您提供金鑰儲存庫檔案的密碼。預設密碼是 changeit,但是您應該指定不同的密碼。您必須記住該密碼,以便稍後輸入到 server.xml 檔中。

      如果您使用 IBM JRE,許多版本在 IBM_Java_JRE_install_location/jre/bin/ 目錄中都包括 IBM 工具 ikeyman。您可以使用這個工具來建立及管理伺服器上的安全憑證。如需使用 iKeyman 工具的相關資訊,請參閱《iKeyman 使用手冊》。

      我們也會在 rtc_install_dir/jazz/server/ 資料夾中隨附一份簡式憑證;憑證檔是 ibm-team-ssl.keystore

    2. tomcat_for_rtc_install_directory\conf\server.xml 檔中,尋找含有 scheme="https" 屬性的 <Connector> 標籤。預設檔案包括埠 8443 的範例 <Connector> 標籤(已註銷)。
    3. 複製並貼上下列文字:
      <Connector port="8443"
           maxHttpHeaderSize="8192"
           maxThreads="150"
           minSpareThreads="25"
           maxSpareThreads="75"
           enableLookups="false"
           disableUploadTimeout="true"
           connectionTimeout="20000"
           acceptCount="100"
           scheme="https"
           secure="true"
           clientAuth="false"
           keystoreFile="keystore_file"
           keystorePass="keystore_password"
           sslProtocol="keystore_protocol"
           algorithm="keystore_algorithm"
           URIEncoding="UTF-8"
      />
      其中:
      • keystore_file 是金鑰儲存庫檔的檔名。它可以是絕對路徑,或是 Tomcat 伺服器根目錄 (tomcat_for_rtc_install_directory) 的相對路徑。如果您使用上述的簡式指令,這會是 .keystore。如果您使用隨附的憑證,這會是 rtc_install_dir/jazz/server/ibm-team-ssl.keystore
      • keystore_password 是金鑰儲存庫檔的密碼。如果您使用隨附的金鑰儲存庫檔,這會是 ibm-team
      • keystore_protocol 是金鑰儲存庫的通訊協定。很可能是 TLSSSL_TLS。如果您使用隨附的金鑰儲存庫檔,這會是 SSL_TLS
      • keystore_algorithm 是金鑰儲存庫的 X509 演算法。很可能是 SunX509IbmX509(視憑證的來源而定)。如果您使用隨附的金鑰儲存庫檔,這會是 IbmX509
    4. 您可以變更 port 值,以便讓非 SSL 連接器使用 8443 以外的埠(依預設為埠 8080)。如果您變更埠值,請變更 redirectPort 屬性的值,以符合 SSL 連接器的埠號。

    如需對 Tomcat 配置 SSL 的相關資訊,請參閱《Apache Tomcat 5.5 SSL 配置方式以及 Apache Tomcat 配置參考手冊》。

  8. 若為 Oracle:若為 Microsoft SQL Server: 複製資料庫提供者中的適當 .jar 檔:
    • 若為 Oracle:ojdbc14.jar 檔複製到 rtc_install_dir/jazz/server/oracle 資料夾(您可能需要建立 oracle 資料夾)。

      您可以從 Oracle 下載檔案。如果您使用 Oracle 11,請下載 Oracle 10g 的套件,以找出 ojdbc14.jar 檔。

    • 若為 Microsoft SQL Server: 將下列檔案複製到 rtc_install_dir/jazz/server/sqlserver 資料夾 (您可能需要建立 sqlserver 資料夾):
  9. 配置 Tomcat 啟動內容設定:
    1. 尋找 Tomcat 啟動檔,並在文字編輯器中開啟它。在 Windows 上,這個檔案是 tomcat_for_rtc_install_directory\bin\startup.bat。在 Linux、AIX® 或 Linux for zSeries 上,這個檔案是 tomcat_for_rtc_install_directory/bin/startup.sh
    2. 在啟動檔案中,輸入下列文字:
      • 若為 Windows:%20 取代 rtc_install_dir 中的每一個空格字元:
        set ORACLE_JDBC=oracle_jar_dir
        set SQLSERVER_JDBC=sqlServer_jar_dir
        set JAZZ_INSTALL_DIR=rtc_install_dir
        set JAVA_OPTS=-Djava.awt.headless=true -Djava.library.path="tomcat_for_rtc_install_directory\shared\lib" -DSQLSERVER_JDBC="%SQLSERVER_JDBC%" -DORACLE_JDBC="%ORACLE_JDBC%" -DDB2I_JDBC="%DB2I_JDBC%" -DDB2Z_JDBC="%DB2Z_JDBC%" -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file:///%JAZZ_INSTALL_DIR%\jazz\server\conf -Dcom.ibm.team.repository.tempDir=%TEMP% -Xmx700M
      • 若為 Linux:若為 AIX:若為 Linux for zSeries:
        ORACLE_JDBC=oracle_jar_dir
        SQLSERVER_JDBC=sqlServer_jar_dir
        JAZZ_INSTALL_DIR=rtc_install_dir
        export JAVA_OPTS="-Djava.awt.headless=true -Djava.library.path=tomcat_for_rtc_install_directory/shared/lib -DSQLSERVER_JDBC=$SQLSERVER_JDBC -DORACLE_JDBC=$ORACLE_JDBC -DDB2I_JDBC=$DB2I_JDBC -DDB2Z_JDBC=$DB2Z_JDBC -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file://"$JAZZ_INSTALL_DIR"/jazz/server/conf -Dcom.ibm.team.repository.tempDir=$TEMP_DIR -Xmx700M"
      其中:
      • rtc_install_dirRTC-server.zip 檔解壓縮後的目錄。在 Windows 中,請以 %20 取代 rtc_install_dir 中的每一個空格字元
      • 若為 Oracle: oracle_jar_dirojdbc14.jar 檔的目錄 (rtc_install_dir/jazz/server/oracle)
      • 若為 Microsoft SQL Server: sqlServer_jar_dirsqljdbc.jar 檔的目錄 (rtc_install_dir/jazz/server/sqlserver)
      • tomcat_for_rtc_install_directory 是 Tomcat 伺服器的安裝目錄
      • 若為 Windows: 若為 Linux:若為 AIX: 如果您要將 Rational Asset ManagerRational Team Concert 安裝在相同的應用程式伺服器上,請使用 JAVA_OPTS 系統變數來取代您在配置 Rational Asset Manager Tomcat 伺服器的啟動 Script 時所建立的變數;這項宣告仍包含 -Djava.library.path 選項。
  10. 尋找適當的 Jazz™ 伺服器內容檔,然後重新命名:
    1. rtc_install_dir/jazz/server/conf/ramjazz/ 目錄中,尋找 teamserver.properties 檔,並將它重新命名為 teamserver.derby.properties
    2. 尋找適合您資料庫伺服器的檔案:
      • 若為 DB2:若為 Windows:若為 Windows 中的 DB2:teamserver.db2.win32.properties
      • 若為 DB2:若為 Linux:若為 AIX:若為 Linux for zSeries:若為 Linux、AIX 或 Linux for zSeries 中的 DB2:teamserver.db2.linux.properties
      • 若為 Oracle: teamserver.oracle.properties
      • 若為 SQL Server: teamserver.sqlserver.properties
    3. 將檔案重新命名為 teamserver.properties
  11. 在文字編輯器中,開啟 teamserver.properties 檔,並按如下所示來修改它(針對您的資料庫提供者):
    • 若為 DB2:
      1. 尋找下列字行:
        com.ibm.team.repository.db.vendor = DB2
        com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
        com.ibm.team.repository.db.jdbc.password=db2admin
      2. 編輯您 DB2® 伺服器位置的 com.ibm.team.repository.db.jdbc.location 值,以及生命週期的資料庫名稱:
        1. 以 DB2 資料庫的位置與埠,取代 localhost:50000
          提示: 在 DB2 指令視窗中,輸入 db2 get dbm cfg,然後尋找內含 SVCENAME 的字行,此行指出 DB2 的埠名或埠號。如果這個指令顯示號碼,請用來作為埠號(以取代先前範例中的 50000)。如果指令傳回非數值的名稱,請判斷指派給這個名稱的埠號,然後使用該埠號。在 Linux 中,/etc/services 檔含有埠名與埠號之間的對映;在 Windows 中,C:\windows\system32\drivers\etc\services 檔含有這項對映。如需相關資訊,請詢問您的資料庫管理者,或參閱資料庫說明文件。
        2. 以生命週期的資料庫名稱取代 JAZZ。
        3. 以 DB2 資料庫的使用者名稱取代 db2admin。
          註: DB2 使用者對於建立表格、表格空間與修改資料庫配置,必須具備許可權。DB2 使用者由作業系統所建立。
      3. com.ibm.team.repository.db.jdbc.password 內容中指定使用者密碼。
        註: 請勿變更 com.ibm.team.repository.db.jdbc.location 內容中的 password={password} 文字。
      4. teamserver.properties 檔中,新增下列內容:
        其中:
        • unsecure_port 是 Tomcat 伺服器的非安全埠(依預設是 8080)
        • secure_port 是 Tomcat 伺服器的安全埠號(依預設是 8443)
        • team_temp_dir 是用來儲存暫存檔之目錄的絕對路徑
        com.ibm.team.scm.tmpdir=team_temp_dir
        com.ibm.team.repository.server.repourl.port.http=unsecure_port
        com.ibm.team.repository.user.registry.type=UNSUPPORTED
        com.ibm.team.repository.ws.allow.admin.access=false
        com.ibm.team.repository.server.repourl.port.https=secure_port
    • 若為 Oracle:
      1. 尋找下列字行:
        com.ibm.team.repository.db.vendor = ORACLE
        com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
        com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      2. 編輯您 Oracle 伺服器位置的 com.ibm.team.repository.db.jdbc.location 值,以及生命週期的資料庫名稱:
        1. 以 Oracle 資料庫的使用者名稱(例如 RAMSCHEMA),取代 jazzDBUser
        2. 以 Oracle 資料庫的位置與埠,取代 @localhost:1521。如果位置不是 localhost,您必須在位置之前加上兩條(正)斜線 (//);例如 @//oracleserver.example.com:1521
        3. 以生命週期資料庫名稱(例如,rtcdb),取代 ORCL
      3. com.ibm.team.repository.db.jdbc.password 內容中,以您在先前指定的 Oracle 使用者密碼,取代 JazzDBpswd
        註: 請勿變更 com.ibm.team.repository.db.jdbc.location 內容中的 {password} 文字。
      4. teamserver.properties 檔中,新增下列內容:
        其中:
        • unsecure_port 是 Tomcat 伺服器的非安全埠(依預設是 8080)
        • secure_port 是 Tomcat 伺服器的安全埠號(依預設是 8443)
        • team_temp_dir 是用來儲存暫存檔之目錄的絕對路徑
        com.ibm.team.scm.tmpdir=team_temp_dir
        com.ibm.team.repository.server.repourl.port.http=unsecure_port
        com.ibm.team.repository.user.registry.type=UNSUPPORTED
        com.ibm.team.repository.ws.allow.admin.access=false
        com.ibm.team.repository.server.repourl.port.https=secure_port
      5. 如果您使用 Oracle 11:在 teamserver.properties 檔中新增下列內容:
        com.ibm.team.repository.db.override.versioncheck=true
    • 若為 Microsoft SQL Server:
      1. 尋找下列字行:
        com.ibm.team.repository.db.vendor = SQLSERVER
        com.ibm.team.repository.db.jdbc.location=//localhost:1433;databaseName=jazz;user=jazzDBuser;password={password}
        com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      2. 編輯您 SQL Server 位置的 com.ibm.team.repository.db.jdbc.location 值,以及生命週期的資料庫名稱:
        1. 以 SQL Server 資料庫的位置與埠,取代 @localhost:1433
        2. 以生命週期資料庫名稱(例如,RTCDB),取代 jazz;。
        3. 以 SQL Server 資料庫的使用者名稱,取代 jazzDBUser
      3. com.ibm.team.repository.db.jdbc.password 內容中,以您在先前指定的 SQL Server 使用者密碼,取代 JazzDBpswd
        註: 請勿變更 com.ibm.team.repository.db.jdbc.location 內容中的 {password} 文字。
      4. teamserver.properties 檔中,新增下列內容:
        其中:
        • unsecure_port 是 Tomcat 伺服器的非安全埠(依預設是 8080)
        • secure_port 是 Tomcat 伺服器的安全埠號(依預設是 8443)
        • team_temp_dir 是用來儲存暫存檔之目錄的絕對路徑
        com.ibm.team.scm.tmpdir=team_temp_dir
        com.ibm.team.repository.server.repourl.port.http=unsecure_port
        com.ibm.team.repository.user.registry.type=UNSUPPORTED
        com.ibm.team.repository.ws.allow.admin.access=false
        com.ibm.team.repository.server.repourl.port.https=secure_port
  12. 建立 Rational Team Concert 的表格:
    1. 開啟指令行視窗,然後導覽至 rtc_install_dir/jazz/server/ 目錄。
    2. 輸入下列指令:
      • 若為 Windows:
        repotools.bat -createTables teamserver.properties=conf\jazz\teamserver.properties
      • 若為 Linux:若為 AIX:若為 Linux for zSeries:
        ./repotools.sh -createTables teamserver.properties=conf/jazz/teamserver.properties
  13. 配置 Tomcat 伺服器的使用者安全。如果您打算使用 LDAP 安全,請先使用檔案型安全來配置應用程式,並在配置應用程式之後,切換至 LDAP 鑑別。如需相關資訊,請參閱配置 Tomcat 的 LDAP 鑑別
    1. 在文字編輯器中,開啟 tomcat_for_rtc_install_directory\conf\tomcat-users.xml 檔。同樣地,如果您要將應用程式安裝到相同的 Tomcat 伺服器,這個檔案就是您用來修改 Rational Asset Manager 應用程式的使用者安全設定的同一個檔案。
    2. <tomcat-users> 標籤之間,貼上下列文字:
      <role rolename="JazzUsers"/>
      <role rolename="JazzAdmins"/>
      <role rolename="JazzDWAdmins"/>
      <role rolename="JazzGuests"/>
    3. 新增名稱為 admin 的使用者,並且指派 admin、manager 與 JazzAdmins 的角色給該使用者。如果要新增這個使用者,您可以複製下列文字,並貼到 <tomcat-users> 標籤之間:
      <user username="admin" password="" roles="admin,manager,JazzAdmins" />

      如果您將應用程式安裝在相同的 Tomcat 伺服器上,請為您在修改 Rational Asset Manager 應用程式的使用者安全設定時所建立的使用者,新增 JazzAdmins 角色。

  14. 啟動 Rational Team Concert 的 Tomcat 伺服器。
    如果要啟動 Tomcat,請執行下列檔案:
    • 若為 Windows:tomcat_for_rtc_install_directory\bin\startup.bat
    • 若為 Linux:若為 AIX:若為 Linux for zSeries:tomcat_for_rtc_install_directory/bin/startup.sh
  15. Rational Team Concert 配置成使用 Rational Asset Manager。您必須在 Rational Team Concert 中配置管理權以及建立專案區域。

意見