在 Tomcat 上從舊版升級

請使用本手冊,在 Apache Tomcat 上從舊版 IBM® Rational® Asset Manager 升級。

開始之前

重要: 如果您是從 Rational Asset Manager 7.1.1.1 版或更舊的版本升級,您必須安裝 IBM Rational Team Concert,這需要另一個資料庫和安全憑證來用於 Tomcat 伺服器。

您必須升級授權伺服器,並提出取得更新授權金鑰的要求。如需必要的 Rational License Server 版本的相關資訊,請參閱安裝 Rational License Key Server

此外,必須停止再重新啟動應用程式伺服器數次。

您可以增進 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 最新版本的必要動作:
  1. 準備升級並備份重要的檔案與資料庫:步驟 14
  2. 擷取 Rational Asset Manager 最新版本的應用程式檔案:步驟 5
  3. 如果您是從 7.1.1.1 版或更舊的版本升級,請建立其他的資料庫:步驟 6
  4. 關閉 Tomcat 伺服器:步驟 7
  5. 將授權伺服器升級到 Rational Common Licensing 8.1.2:步驟 8
  6. 複製 Rational Asset Manager 和 Rational Common Licensing 8.1.2 的新共用程式庫檔案,並據此修改 Tomcat 伺服器的啟動檔案:步驟 911
  7. 配置 Tomcat 伺服器以進行單一登入:步驟 12
  8. 擷取隨附的 Rational Team Concert 的現行應用程式檔案:步驟 1314
  9. 如果您是從 7.1.1.1 版或更舊的版本升級,並且需要 Rational Team Concert,請將 Rational Team Concert 安裝在應用程式伺服器上:步驟 1724
  10. 如果您是從 7.1.1.1 版或更舊的版本升級,請配置 Rational Team Concert:步驟 2531
  11. 如果您是從 7.2 版或更新的版本升級,請升級隨附的 Rational Team Concert:步驟 33
  12. 移除 Rational Asset Manager 的現有應用程式檔案,並且安裝新版本的應用程式:步驟 3439
  13. 登入 Rational Asset Manager,並且移轉儲存庫:步驟 40
  14. 如果您是從 7.1.1.1 版或更舊的版本升級,請將 Rational Asset Manager 配置成連接 Rational Team Concert:步驟 42
  15. 將設定修改成連接新的 Rational Common Licensing 伺服器:步驟 43
  16. 升級任何 Eclipse 用戶端:步驟 44

程序

  1. 升級之前,請按照建立 Rational Asset Manager 儲存庫的備份的指示,為您的儲存庫、資料庫、資產檔案,以及應用程式伺服器設定,建立完整備份。
  2. 如果您在更新 Rational Asset Manager 伺服器之前修改了佈景主題或電子郵件訊息,請下載現行佈景主題和電子郵件訊息檔(位於管理 > 工具頁面),接著在更新伺服器之後,重新套用佈景主題和訊息。如需相關資訊, 請參閱移轉佈景主題
  3. 驗證所有的儲存庫伺服器皆設定成相同的現行日期、時間與時區。
  4. 如果您使用 Rational Asset Manager 7.0.0.2 版或更舊的版本,請確認已啟用工作伺服器。如果要啟用工作伺服器,請執行下列動作:
    1. 以儲存庫管理者身分登入 Rational Asset Manager Web 用戶端。
    2. 按一下管理
    3. 在「儲存庫管理」資訊看板中,按一下工具
    4. 在瀏覽器的位址列中,將 tools.faces 取代為 advancedConfiguration.faces,然後移至這個位址。 例如,http://example.com:9080/com.ibm.ram.repository.web/admin/repository/advancedConfiguration.faces
    5. 在「進階設定」頁面的「工作選項」區段中,選取啟用工作伺服器
    6. 按一下儲存
    7. 重新啟動應用程式伺服器。
  5. 擷取適合 Tomcat 和您作業系統的保存檔中的應用程式檔案。這些應用程式檔案位於 archive_extract_location/apps/tomcat/ 資料夾。
  6. 如果您是從 7.1.1.1 版或更舊的版本升級:建立資產生命週期的資料庫:
  7. 停止一或多部 Tomcat 伺服器。 您的儲存庫以及伺服器上的其他任何應用程式現在都會離線。
  8. 若為 Windows:若為 Linux:若為 AIX: 將 Rational Licensing Server 移轉至 Rational Common Licensing 8.1.2 版或更新版本。 如需相關資訊,請參閱從 Rational Licensing Server 7.1.x 版或更舊版本移轉至 Rational Common Licensing

    Rational License Key Server 隨附在 Rational Asset Manager 安裝媒體中。您也可以透過您的 Passport Advantage 帳戶或透過 Rational Download Center,擷取最新版本的 Rational License Server。

    這項程序需要您關閉所有使用 Rational Licensing Server 的應用程式、解除安裝現有的 Rational Licensing Server、更新授權檔,以及安裝 Rational Common Licensing 伺服器。如果是 Windows,請參閱配置 Windows 授權伺服器;如果是 AIX® 或 Linux,請參閱配置 UNIX 授權伺服器。

    如果是 Linux for zSeries®,請繼續使用 Rational License Server for UNIX 和 Linux 7.0.0.1。
  9. 將共用程式庫檔案解壓縮到 Tomcat 伺服器的 \shared\lib 資料夾:
    1. 找出並解壓縮 archive_extract_location\apps\tomcat\sharedLib.zip 檔。
    2. 將解壓縮之 sharedLib.zip 檔的整個內容,複製到 tomcat_install_directory\shared\lib 目錄。
  10. 若為 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 目錄。
  11. 若為 Windows:若為 Linux:若為 AIX: 修改 Rational Asset Manager 的 Tomcat 伺服器啟動 Script
    1. 尋找 Tomcat 啟動檔,並在文字編輯器中開啟它。在 Windows 上,這個檔案是 tomcat_install_directory\bin\startup.bat。在 Linux、AIX 或 Linux for zSeries 上,這是 tomcat_install_directory/bin/startup.sh
    2. 搜尋包含 JAVA_OPTS= 的字行。
      • 如果已設定 JAVA_OPTS 環境變數,請新增下列選項和值:
        • 若為 Windows:
          -Djava.library.path="tomcat_install_directory\shared\lib"
        • 若為 Linux:若為 AIX:
          -Djava.library.path=tomcat_install_directory/shared/lib
      • 如果未設定 JAVA_OPTS 環境變數,請輸入下列文字:
        • 若為 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"
  12. 配置 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" />
  13. 在安裝媒體中尋找 archive_extract_location/apps/tomcat/RTC-server.zip 檔。
  14. RTC-server.zip 解壓縮至您硬碟上的一個位置,在這些指示中,它稱為 rtc_install_dir
  15. 視您的情況而定,請安裝及配置或更新 Rational Team Concert
    • 如果您是從 7.1.1.1 版或更舊的版本升級:請安裝及配置隨附的 Rational Team Concert。繼續步驟 16
    • 如果您是從 7.2 版或更新的版本升級:請更新隨附的 Rational Team Concert。 繼續步驟 33
  16. 視您的情況而定,請安裝及配置或僅配置 Rational Team Concert
    • 如果您需要安裝及配置 Rational Team Concert:請繼續進行步驟 17
    • 如果您具備現有的 Rational Team Concert 應用程式,並且想將它配置成使用 Rational Asset Manager:請繼續進行步驟 25
  17. 尋找 rtc_install_dir/jazz/server/ramjazz_war.ear 檔並解壓縮它。如果要解壓縮 .ear 檔,您可以使用像 7-Zip 之類的免費公用程式。從解壓縮的 ramjazz_war.ear 套件,將 ramjazz.war 檔複製到 tomcat_for_rtc_install_directory/webapps/ 目錄。
  18. 在 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 配置參考手冊》。

  19. 若為 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 資料夾):
  20. 配置 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 選項。
  21. 尋找適當的 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
  22. 在文字編輯器中,開啟 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
  23. 建立 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
  24. 配置隨附的 Rational Team Concert 使用者授權。
    • 針對檔案型安全:
      1. 在文字編輯器中,開啟 tomcat_for_rtc_install_directory\conf\tomcat-users.xml 檔。
      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 伺服器上,請為現有的管理使用者,新增 JazzAdmins 角色。

    • 針對 LDAP 鑑別:請配置 Tomcat 伺服器使用 LDAP 鑑別,然後配置四個 LDAP 群組,且其名稱和上述四種角色相同。另外,您也可以依照「技術提示」TN0030:Tomcat 中的使用者管理中的說明,使現有的 LDAP 群組與 Jazz 伺服器角色相關聯。遵循將 Tomcat 中的 Rational Team Concert 配置成使用 LDAP 主題小節中的步驟 23 進行。
  25. 啟動 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
  26. 在 Web 瀏覽器中,啟動位於 https://machine_name:secure_port/jazz/admin/ 的「Rational Team Concert 管理 Web 介面」。 請注意 https;連線必須是安全的。
  27. 使用 Rational Team Concert 管理者的使用者 ID 與密碼登入。 如果之前無人登入 Rational Team Concert,請使用應用程式伺服器管理者的使用者 ID 與密碼。
  28. 如果您使用新的 Rational Team Concert 安裝架構:請配置 Rational Team Concert 的管理使用者:
    1. 如果您看到關於「提取伺服器狀態資訊」的錯誤,請關閉再重新啟動資料庫伺服器和應用程式伺服器,然後再重新登入。
    2. 在「Rational Team Concert 管理 Web 介面」中,按一下使用者管理 請忽略關於未配置外部登錄的任何錯誤。
    3. 按一下建立使用者
    4. 輸入下列詳細資料:
      1. 使用者名稱:應用程式伺服器管理者的使用者 ID
      2. 使用者 ID:應用程式伺服器管理者的使用者 ID
      3. 電子郵件位址:應用程式伺服器管理者的有效電子郵件位址
    5. 在「用戶端存取授權」區段中,選取 Rational Team Concert - 開發人員,將開發人員授權指派給該使用者。
    6. 按一下儲存
    7. 登出,然後以應用程式伺服器的管理者身分,登入回「管理 Web 介面」。
  29. 將生命週期程序範本匯入至 Rational Team Concert
    1. 在「Rational Team Concert 管理 Web 介面」中,按一下程序範本管理 如果您看不到程序範本管理鏈結,請登出再登入回「管理 Web 介面」。
    2. 按一下匯入範本,並瀏覽至 archive_extract_location/DatabaseScripts/ 資料夾中的 com.ibm.ram.lifecycle.zip 檔。然後按一下確定 這時會顯示 RAM 生命週期範本。
  30. Rational Team Concert 中建立一個專案區域:
    1. 在「Rational Team Concert 管理 Web 介面」,按一下專案區域管理 如果您看不到專案區域管理鏈結,請登出再登入回「管理 Web 介面」。
    2. 按一下建立專案區域
    3. 輸入下列有關專案區域的詳細資料:
      • 專案名稱RAM 生命週期
      • 摘要「Rational Asset Manager 生命週期」控制專案區域
      • 說明這個區域用來管理 Rational Asset Manager 的生命週期
    4. 按一下儲存
  31. 為專案區域指派適當的成員資格與程序角色:
    1. 在「專案區域管理」頁面中,按一下 RAM 生命週期專案區域。
    2. 在「管理者」區段中,按一下新增。搜尋並選取您所建立的管理使用者。如果您使用現有的 Rational Team Concert 應用程式,也可以選取不同使用者來作為這個專案區域的管理者。
    3. 在「成員」區段中,按一下新增;然後搜尋並選取您選取作為專案區域管理者的同一位使用者。
    4. 在您新增管理者之後,請按一下管理者名稱旁的程序角色圖示。
    5. 在「編輯程序角色」視窗的可用角色清單中,選取管理,並按一下新增
    6. 按一下完成
    7. 按一下儲存
  32. 如果您是從 7.1.1.1 版或更舊的版本升級:繼續進行步驟 34
  33. 如果您是從 7.2 版或更新的版本升級,升級隨附的 Rational Team Concert
    1. 從安裝媒體中,將 RTC-Server.zip 檔解壓縮到硬碟上的新位置 (在以下指示中稱為 new_rtc_install_dir)。
    2. 從舊的 rtc_install_dir/jazz/server/conf/jazz/ 資料夾中,將 teamserver.properties 檔複製到新的 new_rtc_install_dir/jazz/server/conf/jazz/ 資料夾。

      您可以在 Tomcat 啟動檔中找到現有的 rtc_install_dir 位置。在啟動檔中,搜尋包含 JAZZ_INSTALL_DIR= 的字行;JAZZ_INSTALL_DIR 變數的值是現行 Rational Team Concert 檔的位置。

    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. 在 Tomcat 啟動檔中,搜尋包含 JAZZ_INSTALL_DIR= 的這一行。編輯下列每一個項目的值,其中 new_rtc_install_dir 是步驟 33.a 中的解壓縮目錄:
      • 若為 Windows:(請以 %20 取代 new_rtc_install_dir 中的空格字元):
        set JAZZ_INSTALL_DIR=new_rtc_install_dir
      • 若為 Linux:若為 AIX:若為 Linux for zSeries::
        JAZZ_INSTALL_DIR=new_rtc_install_dir
    5. 啟動 Tomcat 伺服器。
    6. 在 Web 瀏覽器中,輸入下列 URL:https://host:secure_port/jazz/admin?internal,其中 host 是 IP 位址或伺服器名稱,而 secure_port 是 Tomcat 伺服器的安全埠。
    7. 以應用程式伺服器管理者身分登入。
    8. 在資訊看板的內部工具之下,按一下重設伺服器
    9. 按一下要求重設伺服器
    10. 停止,然後重新啟動 Tomcat 伺服器。 這時會更新隨附的 Rational Team Concert 應用程式。
  34. 停止 Rational Asset Manager 的 Tomcat 伺服器。
  35. 移除安裝在 Tomcat 上的舊 Rational Asset Manager .war Web 應用程式檔案:
    1. 導覽至 tomcat_install_directory/webapps/ 目錄。
    2. 記下任何 Rational Asset Manager Web 應用程式的資料夾和檔名。 在舊版 Rational Asset Manager 中,針對這些資料夾建議使用的名稱如下(換句話說,是應用程式的環境定義路徑):
      • /com.ibm.ram.repository.web.tomcat_runtime
      • /com.ibm.ram.repository.web.ws.tomcat_runtime
      • /help/
      • /abdprocess/
    3. 刪除下列應用程式檔案:
      • com.ibm.ram.repository.web.tomcat_runtime.war
      • com.ibm.ram.repository.web.ws.tomcat_runtime.war
      • ramhelp.war
      • rmcabdgovernprocess.war
      根據您在伺服器中安裝應用程式的方式,檔名可能與清單中的名稱不同。
    4. 刪除這些應用程式關聯的資料夾。
  36. 將下列檔案從 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
  37. 如果要變更應用程式的環境定義路徑,請重新命名 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 資產型開發和控管程序的說明文件應用程式
  38. 清除 Tomcat 伺服器的快取。刪除 tomcat_install_directory/work/ 目錄。
  39. 重新啟動 Rational Asset Manager 的 Tomcat 伺服器。
  40. Rational Asset Manager 儲存庫移轉至最新版本:
    1. 在 Web 瀏覽器中,開啟 Rational Asset Manager Web 用戶端。 升級之後,您第一次開啟 Web 用戶端時,會顯示一則訊息,指出您必須移轉儲存庫。
    2. 必要的話,請以具備儲存庫管理者權限的使用者 ID 登入。
      註: 若為 SQL Server,如果現有的 Rational Asset Manager 資料庫沒有將對照設定為結尾為 _BIN2 的序列(例如,Latin1_General_BIN2),則會出現「需要手動配置」頁面,並附有一則訊息。您可以重建資料庫,並將對照選項設為區分大小寫以正確使用 Rational Asset Manager,也可以接受可能會有非預期的區分大小寫衝突。
    3. 請按一下移轉 在大型儲存庫上,移轉可能會花費數分鐘;在移轉完成之前,部分的儲存庫相關資訊可能無法使用。
    4. 在移轉程序完成之後,請按一下首頁
  41. 移轉儲存庫之後,請停止再重新啟動您的應用程式伺服器。
  42. 如果您是從 7.1.1.1 版或更舊的版本升級:配置設定,以便從 Rational Asset Manager 連接至 Rational Team Concert
    1. Rational Asset Manager Web 用戶端中,按一下管理
    2. 按一下配置
    3. 在內部 Rational Team Concert 路徑區段中,輸入下列資訊:
      1. 路徑:您所配置之 Rational Team Concert 伺服器的安全 URL。例如,https://localhost:9443/ramjazz。 請注意 https 連線以及安全埠號。
      2. 使用者:在 Rational Team Concert 中,作為「RAM 生命週期」專案區域管理者之使用者的使用者名稱。
      3. 密碼:作為「RAM 生命週期」專案區域管理者的使用者密碼。
      4. 逾時:容許 Rational Asset Manager 連接 Rational Team Concert 的時間量(以秒為單位)。預設值是 120
  43. 如果要升級,您必須提出取得新授權金鑰的要求。您必須獲得新伺服器授權,及新使用者獲授與的授權。 造訪 Rational License Key Center:http://www-01.ibm.com/software/rational/support/licensing/ 如果您看到 Rational License Server 的相關錯誤,請調整授權配置:
    1. 按一下管理
    2. 在「管理」頁面中,按一下配置
    3. 在「授權與版本」區段中,如果要選取此儲存庫要使用的伺服器授權類型,請選取標準版企業版
    4. 在頁面底端,按一下儲存
    5. 您可能會再次見到「授權伺服器」錯誤。 請按一下重試授權伺服器連線
  44. 利用曾安裝 Rational Asset Manager Eclipse 應用程式的相同方法來更新它。 如需安裝 Eclipse 用戶端的相關資訊,請參閱安裝 Rational Asset Manager Eclipse 用戶端
    註: 在安裝 Rational Asset Manager Eclipse 用戶端的最新版本之前,請先解除安裝 Rational Asset Manager Eclipse 用戶端外掛程式。

    如果您當初利用 Installation Manager,將 Rational Asset Manager 7.0.0.2 版 Eclipse 用戶端安裝到現有的 Eclipse 3.3 版應用程式中,請利用 Installation Manager 來解除安裝用戶端。 您無法利用「Eclipse 配置管理程式」來解除安裝 Eclipse 用戶端中的 Rational Asset Manager

    如果您當初利用 Eclipse 更新管理程式來安裝 Rational Asset Manager Eclipse 用戶端外掛程式,在您安裝 Rational Asset Manager 的最新版本之前,請先利用 Eclipse 配置管理程式來移除任何名稱為 Rational Asset Manager 的特性。 如果要在 Eclipse 中使用 Eclipse 配置管理程式,請按一下說明 > 軟體更新項目 > 管理配置


意見