Rational Asset Manager 伺服器應用程式部署在 Tomcat 5.5 上

您可以手動將 IBM® Rational® Asset Manager 安裝在 Apache Tomcat 安裝架構上。

開始之前

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

執行這項作業之前,請先完成下列作業:
  1. 擷取應用程式檔案
  2. 建立資產資料庫
  3. 建立生命週期資料庫
您必須知道資料庫伺服器的下列 JDBC .jar 檔的位置:
  • 若為 IBM DB2:db2jcc_license_cu.jardb2jcc.jar
  • 若為 Oracle:ojdbc5.jar。如果您使用 Oracle 10,仍舊使用 Oracle 11 的 ojdbc5.jar 檔。您可以從 Oracle 下載檔案。
  • 若為 Microsoft SQL Server:sqljdbc.jar。您可以從 Microsoft 下載檔案。

關於這項作業

您可以增進 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 伺服器上,這些目錄會相同。

註: 如果您打算將 Rational Asset Manager 與隨附的 Rational Team Concert 部署在相同機器的不同 Tomcat 伺服器應用程式上,請確定您已配置不同的 Tomcat 伺服器來使用不同的安全與非安全埠,以免發生衝突。如需 Tomcat 5.5 中各埠的相關資訊,請參閱 Apache Tomcat 說明文件。

程序

  1. 驗證所有的儲存庫伺服器皆設定成相同的現行日期、時間與時區。
  2. 擷取適合 Tomcat 和您作業系統的保存檔中的應用程式檔案。這些應用程式檔案位於 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. 若為 Windows: 若為 Linux:若為 AIX: 將 Rational Licensing Key Server 8.1.2 版的程式庫檔案解壓縮到 tomcat_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_install_directory\shared\lib 目錄。
  5. 若為 Windows: 若為 Linux:若為 AIX: 修改 Rational Asset Manager 的 Tomcat 伺服器啟動 Script:
    重要: 如果您要安裝在 Linux for zSeries 上,請勿完成這個步驟
    1. 尋找 Tomcat 啟動檔,並在文字編輯器中開啟它。在 Windows 上,這個檔案是 tomcat_install_directory\bin\startup.bat。在 Linux、AIX® 或 Linux for zSeries 上,這是 tomcat_install_directory/bin/startup.sh
    2. 在啟動檔案中,輸入下列文字:
      • 若為 Windows:
        set JAVA_OPTS=-Djava.library.path="tomcat_install_directory\shared\lib"
      • 若為 Linux:若為 AIX:
        export JAVA_OPTS="-Djava.library.path=tomcat_install_directory/shared/lib"
  6. 將下列檔案從 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
    • ramhelp.war
    • rmcabdgovernprocess.war
  7. 如果要變更應用程式的環境定義路徑,請重新命名 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 服務應用程式
    ramhelp.war ram.help.war ram.help Rational Asset Manager 說明和使用者輔助應用程式
    rmcabdgovernprocess.war ram.process.war ram.process 資產型開發和控管程序的說明文件應用程式
  8. 配置 Rational Asset Manager 的 Tomcat 伺服器,以存取您的資料庫:
    1. 在文字編輯器中,開啟 tomcat_install_directory\conf\server.xml 檔。
    2. server.xml 中找出開頭為 <Connector,以及包含 port="8080"port="8009" 的任何字行。將這些字行的開頭全變更為 <Connector URIEncoding="UTF-8"
    3. 在廣域 JNDI 資源 <GlobalNamingResources></GlobalNamingResources> 的開頭和結尾標籤之間,針對您的 Tomcat 版本輸入下列文字:
      註: 針對 your_usernameyour_password 值,請使用對資料庫有完整管理存取權的使用者 ID 與密碼。例如,"url" 屬性可能看起來像 jdbc:db2://localhost:50000/RAMDB
    針對您的資料庫伺服器輸入此文字,並取代下列變數:
    • usernamepassword 屬性中,以具備資料庫伺服器完整管理存取權的使用者名稱與密碼,取代 your_usernameyour_password
    • url 屬性中,以您資料庫的伺服器位址與埠號,取代 fully_qualified_database_server_namedatabase_port_number,並且以資產的資料庫名稱,取代 Rational_Asset_Manager_database_name。例如,若為 DB2,url 屬性可能看起來像 jdbc:db2://localhost:50000/RAMDB
    • maxWaitmaxActivemaxIdle 屬性顯示的值為範例值,可根據您的效能需求加以調整。
    • 若為 IBM DB2:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="com.ibm.db2.jcc.DB2Driver"
      username="your_username"
      password="your_password"
      url="jdbc:db2://fully_qualified_database_server_name:database_port_number/Rational_Asset_Manager_database_name"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
    • 若為 Oracle:
      <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_database_server_name:database_port_number:Rational_Asset_Manager_database_name"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
    • 若為 Microsoft SQL Server:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="com.microsoft.jdbc.sqlserver.SQLServerDriver"
      username="your_username"
      password="your_password"
      url="jdbc:microsoft:sqlserver://fully_qualified_database_server_name:database_port_number:Rational_Asset_Manager_database_name"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
  9. 配置 Tomcat 伺服器,讓所有應用程式採取單一登入:
    1. 在文字編輯器中,開啟 tomcat_install_directory\conf\server.xml 檔。
    2. 搜尋下列文字:
      <!--
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
      -->
    3. 解除註解 <Valve> 元素:
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
  10. 將下列 JAR 檔複製到 tomcat_install_directory\common\lib 資料夾:
    • 若為 IBM DB2:
      • db2jcc_license_cu.jar
      • db2jcc.jar
    • 若為 Oracle:
      • ojdbc5.jar(您可以從 Oracle 下載這個檔案。如果您使用 Oracle 10,請下載 Oracle 11 的套件,以找出 ojdbc5.jar 檔。)
    • 若為 Microsoft SQL Server:
    這些檔案皆可從資料庫提供者取得,並且很有可能是位於資料庫安裝架構的 /java/ 資料夾。
  11. 配置 Tomcat 伺服器的使用者安全。如果您打算使用 LDAP 安全,請先使用檔案型安全來配置應用程式,並在配置應用程式之後,切換至 LDAP 鑑別。如需相關資訊,請參閱配置 Tomcat 的 LDAP 鑑別
    1. 在文字編輯器中,開啟 tomcat_install_directory\conf\tomcat-users.xml 檔。
    2. 新增名稱為 admin 的使用者,然後指派 adminmanager 的角色給該使用者。如果要新增這個使用者,您可以複製下列文字,並貼到 <tomcat-users> 標籤之間:
      <user username="admin" password="" roles="admin,manager" />

      這個使用者的名稱必須admin

  12. 視您的設定而定,請部署或配置 Rational Team Concert

意見