將 Rational Asset Manager 部署在連接 Oracle 的 Apache Tomcat 5.5 版上

您可以手動將 IBM® Rational® Asset Manager 安裝在現有的 Apache Tomcat 安裝架構上。 請遵循下列指示,將 Rational Asset Manager 部署在 Tomcat 5.5 版上。
開始之前

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

您會需要 ojdbc14.jar(用於 Oracle 10)或 ojdbc5.jar(用於 Oracle 11)檔,其可讓 Tomcat 與 Oracle 伺服器通訊。您的資料庫伺服器提供者應該會提供這些檔案。

執行這項作業的原因和時機

如果您要改善 Rational Asset Manager 的效能和穩定性, 您可以在個別的 Tomcat 伺服器上安裝 Rational Asset Manager 的 Web 應用程式,以及內含 Rational Team Concert 的應用程式檔案。在這整份文件中,Rational Asset Manager 的 Tomcat 伺服器安裝目錄稱為 <tomcat_install_directory>,而 Rational Team Concert 的 Tomcat 伺服器安裝目錄則稱為 <tomcat_for_rtc_install_directory>。 如果您在同一部伺服器上安裝所有 Web 應用程式, 這些目錄會相同。

註: 如果您打算將 Rational Asset Manager 與隨附的 Rational Team Concert 部署在相同機器中的不同 Tomcat 伺服器應用程式上,請確定您已配置不同的 Tomcat 伺服器來使用不同的安全與非安全埠,以免發生衝突。如需 Tomcat 5.5 中的埠資訊,請參閱 Apache Tomcat 文件。
  1. 驗證所有的儲存庫伺服器皆設定成相同的現行日期、時間與時區。
  2. 適合 Tomcat 和您作業系統的保存檔上,擷取 Rational Asset Manager 伺服器檔案。 這些應用程式檔案會位於 <archive_extract_location>/apps/tomcat/ 資料夾中。
  3. 將共用程式庫解壓縮到 <tomcat_install_directory>\shared\lib 資料夾:
    1. 找出並解壓縮 <archive_extract_location>\apps\tomcat\sharedLib.zip 檔。
    2. 將解壓縮後之 sharedLib.zip 檔的完整內文, 複製到 <tomcat_install_directory>\shared\lib 目錄。
    3. 如果您要在不同的 Tomcat 伺服器上安裝 Rational Team Concert, 請將 sharedLib.zip 檔解壓縮的內容重複複製到其他 Tomcat 伺服器的 <tomcat_for_rtc_install_directory>\shared\lib 目錄。
  4. <archive_extract_location>/apps/tomcat/ 目錄, 將下列檔案複製到 <tomcat_install_directory>/webapps/ 目錄:
    • com.ibm.ram.repository.web.tomcat_runtime.war
    • com.ibm.ram.repository.web.ws.tomcat_runtime.war
    • iehs.war
    • rmcabdgovernprocess.war
  5. 如果要變更應用程式的環境定義路徑, 請重新命名 WAR 應用程式檔案。 建議的名稱如下:
    表 1. 建議的 Rational Asset Manager Web 應用程式檔案環境定義路徑
    原始檔案名稱 建議檔案名稱 產生的環境定義路徑 這是什麼?
    com.ibm.ram.repository.web.tomcat_runtime.war ram.war ram Tomcat 的 Rational Asset Manager 主要 Web 應用程式
    com.ibm.ram.repository.web.ws.tomcat_runtime.war ram.ws.war ram.ws Tomcat 的 Rational Asset Manager Web 服務應用程式
    iehs.war ram.help.war ram.help Rational Asset Manager 說明和使用者輔助應用程式
    rmcabdgovernprocess.war ram.process.war ram.process 資產型開發和控管程序的文件應用程式
  6. Rational Asset Manager 配置 Tomcat 伺服器以存取 Oracle。
    1. 在文字編輯器中,開啟 <tomcat_install_directory>\conf\server.xml 檔。
    2. server.xml 中找出開頭為 <Connector,以及包含 port="8080"port="8009" 的任何字行。將這些字行的開頭全變更為 <Connector URIEncoding="UTF-8"
    3. server.xml 中,於廣域 JNDI 資源 <GlobalNamingResources></GlobalNamingResources> 的開頭和結尾標籤之間,針對您的 Tomcat 版本輸入下列文字。
      註: 針對 <your_username><your_password> 值, 請使用對資料庫有完整管理權的使用者 ID 和密碼。此處顯示的 "maxWait" 、"maxActive" 和 "maxIdle" 等值為範例值,可根據您的效能需求加以調整。
    輸入下列文字:
    <Resource name="jdbc/RAM_Con"
    type="javax.sql.DataSource"
    driverClassName="oracle.jdbc.driver.OracleDriver"
    username="<your_username>"
    password="<your_password>"
    url="jdbc:oracle:thin:@<fully_qualified_machine_name>:<oracle_port_number>:<Rational_Asset_Manager_database_name>"
    poolPreparedStatements="true"
    maxWait="5000"
    maxActive="4"
    maxIdle="2"/>
  7. 新增下列的 .jar 檔至 <tomcat_install_directory>\common\lib 資料夾:
    • ojdbc14.jar(用於 Oracle 10);或者
    • ojdbc5.jar(用於 Oracle 11)
    您的資料庫應用程式提供者會提供這個檔案。
  8. 在安裝媒體中找出 <archive_extract_location>/apps/tomcat/RTC-server.zip 檔。
  9. RTC-server.zip 解壓縮至您硬碟上的一個位置,在這些指示中,將稱它為 <rtc_install_dir>
  10. 找出 <rtc_install_dir>/jazz/server/jazz_war.ear 檔並解壓縮。您可以使用免費的公用程式 7-Zip 來解壓縮 .ear 檔。 從已解壓縮的 jazz_war.ear 套件中,將 jazz.war 檔複製到 <tomcat_for_rtc_install_directory>/webapps/ 目錄。
  11. 在 Tomcat 伺服器上配置 Rational Team Concert 的安全埠:
    1. 您必須建立安全憑證來識別 Rational Team Concert 的 Tomcat 伺服器,以建立 SSL 連線。您可以利用 Java JDK keytool 指令來建立自簽憑證, 也可以要求由授信的憑證管理中心所簽發的憑證。

      如需以 keytool 指令來建立自簽憑證的相關資訊, 請參閱 Sun Java 文件。利用 keytool 指令,您可以利用下列範例指令來建立自簽憑證:keytool -genkey -alias tomcat -keystore <tomcat_for_rtc_install_directory>/.keystore

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

    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"
           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_password> 是金鑰儲存庫檔的密碼;
      • <keystore_protocol> 是金鑰儲存庫的通訊協定。其很可能是 TLSSSL_TLS
      • <keystore_algorithm> 是金鑰儲存庫的 X509 演算法。其很可能是 SunX509IbmX509(視憑證的來源而定)。
    4. 如果您變更 port 值以使用 8443 以外的埠, 針對非 SSL 連接器(依預設為埠 8080),請變更 redirectPort 屬性的值, 以符合 SSL 連接器的埠號。

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

  12. 配置 Tomcat 啟動內容設定:
    1. 將適當的 .jar 檔從資料庫提供者複製到 <rtc_install_dir>/jazz/server/oracle 資料夾(您可能必須建立 oracle 資料夾):
      • ojdbc14.jar(用於 Oracle 10);或者
      • ojdbc5.jar(用於 Oracle 11)
    2. 只適用於 Oracle 11: ojdbc5.jar 檔重新命名為 ojdbc14.jar
    3. 尋找 Tomcat 啟動檔,並在文字編輯器中開啟它。在 Windows® 上,這是 <tomcat_for_rtc_install_directory>\bin\startup.bat。在 Linux®、AIX® 或 Linux for zSeries® 上,這是 <tomcat_for_rtc_install_directory>/bin/startup.sh
    4. 在啟動檔中,輸入下列文字,其中 <rtc_install_dir> 是您在步驟 9 解壓縮的目錄,而 <oracle_jar_dir> 則是步驟 12.a 中 Oracle .jar 檔的位置
      • 若為 Windows:(請將 <rtc_install_dir><oracle_jar_dir> 中的空格字元換成 %20):
        set ORACLE_JDBC=<oracle_jar_dir>
        set JAZZ_INSTALL_DIR=<rtc_install_dir>
        set JAVA_OPTS=-Djava.awt.headless=true -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>
        JAZZ_INSTALL_DIR=<rtc_install_dir>
        export JAVA_OPTS="-Djava.awt.headless=true -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"
  13. 編輯 Jazz™ 伺服器內容檔:
    1. <rtc_install_dir>/jazz/server/conf/jazz/ 目錄中尋找 teamserver.properties 檔,並重新命名為 teamserver.derby.properties
    2. <rtc_install_dir>/jazz/server/conf/jazz/ 目錄中尋找 teamserver.oracle.properties 檔,並重新命名為 teamserver.properties
    3. teamserver.properties 檔中,指定資料庫與連線內容:
      1. 在文字編輯器中開啟 teamserver.properties 檔。
      2. 尋找下列字行:
        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
      3. 編輯您 Oracle 伺服器位置的 com.ibm.team.repository.db.jdbc.location 值,以及生命週期的資料庫名稱:
        1. 以 Oracle 資料庫的使用者名稱(例如 RAMSCHEMA),取代 jazzDBUser
        2. 以 Oracle 資料庫的位置與埠,取代 @localhost:1521。如果位置不是 localhost,您必須在位置之前加上兩條(正)斜線 (//);例如 @//oracleserver.example.com:1521
        3. 以生命週期資料庫名稱(例如,rtcdb),取代 ORCL
      4. com.ibm.team.repository.db.jdbc.password 內容中,以您在上方指定的 Oracle 使用者密碼,取代 JazzDBpswd
        註: 請勿變更 com.ibm.team.repository.db.jdbc.location 內容中的 {password} 文字。
      5. 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>
  14. 建立 Rational Team Concert 的表格:
    1. 開啟指令行視窗,然後導覽至 <rtc_install_dir>/jazz/server/ 目錄。
    2. 執行下列指令:
      • 若為 Windows::
        repotools.bat -createTables teamserver.properties=conf\jazz\teamserver.properties com.ibm.team.repository.db.override.versioncheck=true
      • 若為 Linux:若為 AIX:若為 Linux for zSeries::
        ./repotools.sh -createTables teamserver.properties=conf/jazz/teamserver.properties com.ibm.team.repository.db.override.versioncheck=true
  15. 配置 Tomcat 伺服器的使用者安全。如果您打算使用 LDAP 安全,請先使用檔案型安全來配置應用程式, 然後在配置好應用程式之後,切換至 LDAP 鑑別(如需相關資訊,請參閱配置 Tomcat 的 LDAP 鑑別):
    1. 在文字編輯器中,開啟 <tomcat_install_directory>\conf\tomcat-users.xml 檔(針對 Rational Asset Manager 的伺服器)。
    2. 新增名稱為 admin 的使用者,然後指派其 adminmanager 的角色。 您可以在 <tomcat-users> 標籤之間複製並貼上下列內容:
      <user username="admin" password="" roles="admin,manager" />

      這個使用者的名稱必須admin

    3. 在文字編輯器中,開啟 <tomcat_for_rtc_install_directory>\conf\tomcat-users.xml 檔(針對 Rational Team Concert 的伺服器)。 同樣地, 如果您要將應用程式安裝到同一部 Tomcat 伺服器,這會是與步驟 15a 相同的檔案。
    4. <tomcat-users> 標籤之間貼入下列文字:
      <role rolename="JazzUsers"/>
      <role rolename="JazzAdmins"/>
      <role rolename="JazzDWAdmins"/>
      <role rolename="JazzGuests"/>
    5. 新增名稱為 admin 的使用者,然後指派其 adminmanagerJazzAdmins 的角色。您可以在 <tomcat-users> 標籤之間複製並貼上下列內容:
      <user username="admin" password="" roles="admin,manager,JazzAdmins" />

      如果您要在同一部伺服器上安裝應用程式,您可以新增 JazzAdmins 角色給您在步驟 13b 建立的使用者。

  16. 重新啟動 Tomcat 伺服器。
  17. 配置 Rational Team Concert 的管理使用者:
    1. 在 Web 瀏覽器中,啟動位於 https://<machine_name>:<secure_port>/jazz/admin/Rational Team Concert 管理 Web 使用者介面。 請注意 https;其必須是安全連線。
    2. 使用應用程式伺服器管理者的使用者 ID密碼登入。 如果您看到關於「提取伺服器狀態資訊」的錯誤, 請關閉再重新啟動資料庫伺服器和 Tomcat 伺服器,然後再重新登入。
    3. 按一下使用者管理 請忽略關於未配置外部登錄的任何錯誤。
    4. 按一下建立使用者
    5. 輸入下列詳細資料:
      1. 使用者名稱:Tomcat 伺服器管理者的使用者 ID
      2. 使用者 ID:Tomcat 伺服器管理者的使用者 ID
      3. 電子郵件位址:Tomcat 伺服器管理者的有效電子郵件位址
    6. 在「用戶端存取授權」區段中,選取 Rational Team Concert - 開發人員,將開發人員授權指派給該使用者。
    7. 按一下儲存
    8. 登出,然後以應用程式伺服器的管理者身分,登入回「管理 Web 使用者介面」。
  18. 將生命週期程序範本匯入至 Rational Team Concert
    1. Rational Team Concert 管理 Web 使用者介面中,按一下程序範本管理 如果您未看到程序範本管理鏈結, 請登出,然後再登入回「管理 Web 使用者介面」。
    2. 按一下匯入範本,並瀏覽至 <archive_extract_location>/DatabaseScripts/ 資料夾中的 com.ibm.ram.lifecycle.zip 檔。然後按一下確定 這時會顯示 RAM 生命週期範本。
  19. Rational Team Concert 中建立新的專案區域:
    1. Rational Team Concert 管理 Web 使用者介面,按一下專案區域管理 如果您未看到專案區域管理鏈結, 請登出,然後再登入回「管理 Web 使用者介面」。
    2. 按一下建立專案區域
    3. 輸入下列有關專案區域的詳細資料:
      • 專案名稱RAM 生命週期
      • 摘要「Rational Asset Manager 生命週期」控制專案區域
      • 說明這個區域用來管理 Rational Asset Manager 的生命週期
    4. 按一下儲存
  20. 為專案區域指派適當的成員資格與程序角色:
    1. 在「專案區域管理」頁面中,按一下 RAM 生命週期專案區域。
    2. 在「管理者」區段中,按一下新增;然後搜尋並選取您所建立的管理者。
    3. 在「成員」區段中,按一下新增;然後搜尋並選取您所建立的管理者。
    4. 在您新增管理者之後,請按一下管理者名稱旁的程序角色圖示。
    5. 從「編輯程序角色」對話框的可用角色清單中,選取管理,並按一下新增
    6. 按一下完成
    7. 按一下儲存
  21. 停止,然後重新啟動 Tomcat 伺服器。
  22. 在 Web 瀏覽器中開啟 Rational Asset Manager。如果應用程式檔案使用了建議的名稱, 則 URL 會是 http://localhost:8080/ram/home.faces; 如果是透過 Web 伺服器,則 URL 會是 http://<Web_server_address>:<port>/ram/home.faces 這時會開啟 Rational Asset Manager Web 用戶端。
下一步
接著,請配置 Rational Asset Manager Web 應用程式。如需相關資訊,請參閱配置 Rational Asset Manager 伺服器應用程式

意見