在 WebSphere Application Server 上從舊版升級

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

開始之前

重要:

由於 Rational Asset Manager 7.5.2 版及更新版本不支援內嵌式 WebSphere Application Server,也不支援 WebSphere Application Server 7.0 版之前的版本,如果您是在內嵌式 WebSphere Application ServerWebSphere Application Server 7.0 版之前的版本執行 Rational Asset Manager,必須先將現有的 Rational Asset Manager 版本重新安裝在支援的 WebSphere Application Server 7.0 版或更新的版本上。然後遵循這個主題中的步驟,升級至 Rational Asset Manager 7.5.2 版或更新的版本。

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

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

您也可以將現有的 Rational Team Concert 伺服器配置成使用 Rational Asset Manager。伺服器設定應用程式會處理此配置。您必須知道 Rational Team Concert 伺服器管理者的使用者名稱與密碼。

如果您擁有網際網路存取權,可以使用 IBM Installation Manager,直接從 IBM 更新儲存庫尋找並安裝 Rational Asset Manager 的更新項目。

重要: 安裝 Rational Asset Manager 時,它的更新儲存庫的位置會自動內嵌在 Installation Manager 中。 為了讓 Installation Manager 搜尋預設儲存庫位置,必須在「儲存庫」喜好設定頁面中選取在安裝和更新期間搜尋鏈結的儲存庫喜好設定;依預設會選取這項喜好設定。

如果要從不同的儲存庫位置安裝修正套件(例如,更新項目是在共用磁碟機或 HTTP 或 HTTPS 伺服器上),請在 Installation Manager 中新增儲存庫位置。 如果要新增儲存庫位置,請參閱在 Installation Manager 中設定安裝儲存庫喜好設定

如果要使用 Installation Manager,您必須使用圖形使用者介面 (GUI)。 如果您無法存取 GUI,您必須利用回應檔,透過指令行來進行無聲自動安裝。 如需相關資訊,請參閱 IBMInstallation Manager 線上說明利用 Installation Manager 進行無聲自動安裝

關於這項作業

此概要顯示您要升級至最新版 Rational Asset Manager 所必須執行的動作:
  1. 建立備份並配置應用程式伺服器,以準備升級:步驟 15
  2. 如果您使用 Oracle,請複製其他的 JDBC .jar 檔:步驟 67
  3. 將授權伺服器升級至 Rational Common Licensing 8.1.2 版:步驟 8
  4. 擷取最新版 Rational Asset Manager 的應用程式檔案,並部署伺服器設定應用程式:步驟 910
  5. 使用伺服器設定應用程式來更新其他的 Rational Asset Manager 應用程式:步驟 1114
  6. 重新啟動應用程式伺服器:步驟 17
  7. 登入 Rational Asset Manager Web 用戶端並移轉儲存庫:步驟 1920
  8. (選用)更新 Rational Asset Manager Eclipse 應用程式:步驟 21

程序

  1. 升級之前,請按照建立 Rational Asset Manager 儲存庫的備份的指示,為您的儲存庫、資料庫、資產檔案,以及應用程式伺服器設定,建立完整備份。
  2. 若為 Linux:若為 AIX:若為 Linux for zSeries:在 Linux、AIX® 或 Linux for zSeries® 中,將程序一次所能開啟的檔案描述子數目,增加到至少 65535:
    1. 如果要檢視一次所能開啟的現行描述子數目,請在指令行中輸入:ulimit -n
    2. 如果限制並非至少有 65535,請使用下列指令來增加限制:ulimit -n 65535
  3. 如果您在更新 Rational Asset Manager 伺服器之前修改了佈景主題或電子郵件訊息,請下載現行佈景主題和電子郵件訊息檔(位於管理 > 工具頁面),接著在更新伺服器之後,重新套用佈景主題和訊息。如需相關資訊,請參閱移轉佈景主題
  4. 若為 WebSphere:配置 WebSphere Application Server 的應用程式安全和鑑別設定:
    1. 在 Web 瀏覽器中,登入 WebSphere Application Server 管理主控台。 依預設,位置如下:
      • WebSphere Application Serverhttp://localhost:9060/ibm/console
    2. 按一下安全
    3. 按一下廣域安全
    4. 在「管理安全」區段中,如果已選取啟用管理安全勾選框,請選取啟用應用程式安全勾選框。
    5. 按一下套用
    6. 在「訊息」視窗中,按一下直接儲存到主要配置
    7. 停止伺服器,然後重新啟動。
  5. 驗證所有的儲存庫伺服器皆設定成相同的現行日期、時間與時區。
  6. 若為 Oracle: 如果您使用 Oracle,請將 ojdbc6.jar 檔複製到您應用程式伺服器的 WebSphere_install_directory/profiles/profile_name/config/cells/cell_name/ram_jdbc 目錄。 您可以從 Oracle 下載適當的 .jar 檔。如果您使用 Oracle 10g,請下載 Oracle 11 的套件,以取得適當的 .jar 檔。
  7. 如果您是使用 Oracle,並且使用 AIX、Linux 或 Linux for zSeries,請按照讓非 root 使用者具備資料庫連線功能(Linux 和 AIX)中的說明,為新的 JDBC .jar 檔設定適當的許可權。Rational Asset Manager 存取 Oracle 資料庫的使用者,必須獲授予適當的專用權才能完成移轉。
    • 如果您是使用 RAMSCHEMA 使用者,請授予 CREATE VIEW 專用權給 RAMSCHEMA 使用者。 範例:GRANT CREATE VIEW TO RAMSCHEMA
    • 如果您使用的是不同的使用者,請授予 CREATE ANY VIEW 專用權給使用者。範例:GRANT CREATE ANY VIEW TO User
  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. 擷取適當的 Rational Asset Manager 應用程式:
    • 如果您使用 WebSphere Application Server,而且使用 Installation Manager 將 Rational Asset Manager 部署至伺服器,請使用 Installation Manager 進行升級程序。請參閱利用 Installation Manager 來安裝 Rational Asset Manager 伺服器的指示,並注意這些差異:
      1. 啟動 Installation Manager。在 Windows Vista 上,以管理者身分執行 Installation Manager(用滑鼠右鍵按一下程式捷徑,並選取以管理者身分執行)。
      2. Installation Manager 可能需要更新成較新的版本。 如果要配置 Installation Manager,讓它檢查是否有更新項目:在「啟動」頁面上,按一下檔案 > 喜好設定;然後按一下更新項目。 在「更新項目」頁面中,選取搜尋 Installation Manager 的更新項目
      3. 在 Installation Manager 的「啟動」頁面上,按一下更新
      4. 如果有更新的 Installation Manager 版本,這時會出現一個要求更新的視窗。 按一下。更新程序完成之後,請按一下確定來重新啟動 Installation Manager,然後再按一下更新
      5. 在「更新套件」頁面上,選取 IBM Rational Asset Manager;然後按下一步。 展開及選取 Rational Asset Manager 伺服器的最新版本,然後按下一步
      6. 遵循「更新」精靈中的指示。
        1. 環境定義根目錄頁面中,Installation Manager 會偵測現行 Rational Asset Manager Web 應用程式的環境定義根目錄。 請注意 Rational Asset Manager 設定伺服器的環境定義根目錄;您需要環境定義根目錄,才能存取伺服器設定應用程式。 然後按下一步
        2. 如果已啟用應用程式伺服器安全(很可能是如此),或是 WebSphere Application Server 的安全設定自您安裝產品後曾變更,請在「特性」區段的管理安全頁面上選取,然後輸入應用程式伺服器管理者的使用者名稱和密碼。 然後按下一步
      7. 在更新程序完成之後:
        1. 如果您使用現有的 WebSphere Application Server,則已更新伺服器設定應用程式 .ear 檔。移至步驟 11
        2. 如果您使用現有的 WebSphere Application Server ND 叢集,請前往步驟 11。如果您是從 7.5 版或更新的版本升級,且該版本是您所安裝的第一個產品版本,則您原先安裝產品時所指定的應用程式伺服器上的伺服器設定應用程式已更新。如果您安裝的是 7.5 版以前的任何版本,將會更新您 Cell 之「部署管理程式」伺服器上的伺服器設定應用程式。
    • 如果您將 Rational Asset Manager .ear.war 檔部署至應用程式伺服器,請擷取最新版的 Rational Asset Manager 應用程式檔案。如需相關資訊,請參閱直接從安裝媒體擷取伺服器應用程式檔案。有了應用程式檔案之後,請繼續步驟 10
  10. Rational Asset Manager 伺服器設定應用程式部署到您的應用程式伺服器:
    • 如果您使用的是 WebSphere Application Server 叢集,並將伺服器設定應用程式部署至「部署管理程式」伺服器(這說明 7.5 版以前的叢集上的大部分環境),您必須使用 Script 來解除安裝現有的伺服器設定應用程式,然後安裝最新的伺服器設定應用程式。 如需使用 deployClusterSetup.pyUninstallSetup.py Script 的相關資訊,請參閱將伺服器設定應用程式部署到 WebSphere Application Server 叢集中的「部署管理程式」。或者,您可以將伺服器設定應用程式部署至叢集,而非直接部署至「部署管理程式」;如果您用這種方式部署應用程式,則不需要執行 Jython Script。將伺服器設定應用程式部署到「部署管理程式」之後,請前往步驟 11
    • 如果您已直接將 Rational Asset Manager 伺服器設定應用程式部署至應用程式伺服器,請將 com.ibm.ram.repository.setup.web.ear 更新至您擷取的最新版本:
      1. 啟動 WebSphere Application Server 管理主控台,然後以管理者身分登入。
      2. 更新 Rational Asset Manager 伺服器設定應用程式:
        1. 按一下應用程式 > 應用程式類型
        2. 按一下 WebSphere 企業應用程式
        3. 選取 com.ibm.ram.repository.setup.web.ear;然後按一下更新
        4. 瀏覽至 Rational Asset Manager 伺服器設定企業保存檔 (com.ibm.ram.repository.setup.web.ear),或輸入它的路徑和檔名。
        5. 在以下三個頁面中,按下一步
        6. 在「摘要」頁面中,按一下完成
        7. 在安裝 com.ibm.ram.repository.setup.web.ear 檔時,請按一下儲存至主要配置。這時已更新和部署伺服器設定應用程式。 您使用伺服器設定應用程式來更新其他的所有應用程式。 移至步驟 11
    • 如果您使用 WebSphere Application Server,但是未部署伺服器設定應用程式 (com.ibm.ram.repository.setup.web.ear),請完成將伺服器設定應用程式部署到 WebSphere Application Server 中的指示來部署 com.ibm.ram.repository.setup.web.ear 應用程式。 如果您是部署到叢集中,請參閱將伺服器設定應用程式部署至 Websphere Application Server 叢集您使用伺服器設定應用程式來更新其他的所有應用程式。部署伺服器設定應用程式之後,請移至步驟 11
  11. 部署伺服器設定應用程式的最新版本之後,請在 Web 瀏覽器中,利用下列 URL 來開啟伺服器設定應用程式:http://host:port/setup-server-context-root。 伺服器設定應用程式的預設環境定義根目錄是 ram.setup。如果已在應用程式伺服器上啟用安全,請輸入應用程式伺服器管理者的使用者 ID 與密碼。
  12. 在「步驟 1:尋找安裝檔」區段中,按一下提供伺服器上包含下列檔案的目錄,然後輸入新的 Web 應用程式檔案所在的檔案系統目錄(此目錄位於正在執行伺服器設定應用程式的伺服器中)。 如果您使用 Installation Manager 中的「更新」精靈,則檔案位於 package_group_location/ram/apps/was 目錄中。 這些檔案必須在該目錄中:
    • com.ibm.ram.repository.web_runtime.ear
    • RTC-Server_401.zip
    • RTC-Server_3013.zip
    • ramhelp_war.ear
    • rmcabdgovernprocess_war.ear

    請注意,rlsclients_rlsibmratl_812.zip 檔位於 package_group_location/ram/SharedLibs 目錄。

    如果您將伺服器設定應用程式部署至屬於叢集一部分的應用程式伺服器,而且您正在存取該應用程式伺服器,則如果要將檔案上傳至執行伺服器設定應用程式的伺服器,請按一下將檔案上傳至伺服器;然後按一下瀏覽並選取每一個所需的檔案。

  13. 如果要驗證所有必要的應用程式檔案皆位於目錄中,或者要將它們上傳到伺服器,請按一下驗證安裝檔案 如果您上傳了應用程式檔案,伺服器設定應用程式會將它們儲存至暫存目錄。 會有一則訊息確認是否所有的所需檔案都存在。
  14. 按一下更新 伺服器設定應用程式會將其他的所有 Rational Asset Manager 應用程式檔案更新至最新版本,並保留其環境定義根目錄,這項程序可能花費數分鐘。伺服器設定應用程式也會移除 Rational Team Concert 2.0.0.2 版。 這時會開啟「簡介」頁面。如果是部署到叢集,且您選擇使用 RAM 隨附的內部 Rational Team Concert,則必須將 Rational Team Concert 安裝到只具有一個應用程式伺服器的另外一個叢集。建立此叢集(如果尚未建立)。然後,登出伺服器設定應用程式再登入,即可從 Rational Team Concert 部署清單中選取叢集。按下一步以開啟「部署」頁面。按一下部署應用程式來部署 Rational Team Concert CCM 及 JTS 應用程式(這些是 Rational Team Concert 伺服器的元件)。此程序會解壓縮 Rational Team Concert 3.0.1.3 和 Rational Team Concert 4.0.1,可能需要幾分鐘的時間。請注意,需要 Rational Team Concert 3.0.1.3 才能將 Rational Team Concert 2.0.0.2 資料庫移轉至 Rational Team Concert 4.0.1。資料庫會先移轉至 Rational Team Concert 3.0.1.3,再移轉至 Rational Team Concert 4.0.1。伺服器設定過程會在稍後進行此移轉作業。
  15. 配置 Rational Team Concert 資料庫。 在「配置資料庫」區段的第一頁,選取您需要建立或修改的資料庫。需要三個資料庫:一個用於管理「資產」,另外兩個資料庫用於管理生命週期。從 7.5.1.2 之前的版本升級時,您通常會選取您需要建立 RTC 的 JTS 資料庫Rational Team Concert 4 需要 Jazz Team Server (JTS) 資料庫。遵循伺服器設定應用程式中的指示,為您的特定資料庫伺服器軟體建立資料庫。如果要進一步瞭解建立 JTS 資料庫,請參閱建立資產生命週期的資料庫下的主題。建立資料庫之後,將 Rational Team Concert 資料庫從 Rational Team Concert 2.0.0.2 移轉至 Rational Team Concert 4.0.1。指定正確的資訊之後,按一下移轉。這可能需要很久的時間,可能長達數小時,視資產、生命週期及原則而定。當伺服器設定應用程式執行指令時,進度視窗會指出正在執行的步驟。
  16. 繼續透過伺服器設定應用程式來配置或調整您的資料庫和應用程式伺服器設定,直到出現「第 4 篇:配置 Java 虛擬記憶體資料堆設定」為止。選取
  17. 按一下重新啟動伺服器
  18. 在「配置生命週期管理設定」頁面中,輸入 Rational Team Concert 應用程式的路徑和登入資訊:
    1. 在步驟 1 中,於 Rational Team Concert 伺服器 欄位中,輸入 Rational Team Concert 位置的路徑。 在 Jazz Team Server 欄位中,輸入 Jazz Team Server 位置的路徑。您必須使用安全 (https://) 連線。依預設,這些值如下:
      • 若為現有的 WebSphere Application Serverhttps://server_host:9443/ramccm,而 Jazz Team Server 為 https://server_host:9443/ramjts
      • 若為外部 Rational Team Concert 伺服器:https://url:port/ccm,而 Jazz Team Server 為 https://url:port/jts
    2. 在步驟 2 中,於 Jazz 管理者 ID 欄位中輸入 Rational Team Concert 伺服器管理者的使用者 ID (預設值是 admin);然後在密碼欄位中,輸入該使用者的密碼(依預設,這是 admin)。 如果您剛使用伺服器設定應用程式安裝 Rational Team Concert,請輸入應用程式伺服器管理者的使用者名稱與密碼。
    3. 在步驟 3 中,於專案區域名稱欄位中,輸入將建立給生命週期的敘述性專案區域名稱 (例如 Rational Asset Manager lifecycles)。接著,在專案區域管理者 ID 欄位中,輸入要成為專案區域管理者之使用者的使用者 ID。然後輸入該使用者的密碼 如果您是使用外部 Rational Team Concert 伺服器,「專案區域」管理者可能與 Jazz 伺服器管理者不同。如果您要安裝新的 Rational Team Concert,伺服器設定應用程式會建議您使用「Jazz 管理者 ID」作為「專案區域管理者 ID」。
    4. 按一下配置伺服器 這項程序可能需要數分鐘。 在配置之後,即出現「摘要」頁面。
  19. 在「摘要」頁面上,按一下利用 Rational Asset Manager 來啟動。或者,按一下完成 即開啟 Web 用戶端。
  20. 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. 在移轉程序完成之後,請按一下首頁
  21. 選擇性的: 利用曾安裝 Rational Asset Manager Eclipse 應用程式的相同方法來更新它。 如需安裝 Eclipse 用戶端的相關資訊,請參閱安裝 Rational Asset Manager Eclipse 用戶端
    註: 在安裝 Rational Asset Manager Eclipse 用戶端的最新版本之前,請先解除安裝 Rational Asset Manager Eclipse 用戶端外掛程式。

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

下一步

Rational Asset Manager 7.5.1 版及更新的版本中,內部 Rational Team Concert 伺服器的 URL 已經從 https://host:port/jazz 改成 https://host:port/ramjazz。 如果您是從比 Rational Asset Manager 7.5.1 版更舊的版本升級,請修訂 URL 參照,並告知您的使用者必須做的變更。

更新這些位置的 URL:
  • 使用舊 URL 的 Rational Team Concert Eclipse IDE 儲存庫連線。如果要更新儲存庫連線:
    1. 開啟「團隊構件」視圖。
    2. 展開儲存庫連線
    3. 用滑鼠右鍵按一下 Rational Asset Manager 連線並選取內容
    4. 選取 Jazz 儲存庫連線
    5. 在 URI 位置,將 URL 改成 http://host_name/ramjazz
    6. 按一下確定
  • Rational Team Concert伺服器中使用舊 URL 的進階內容。如果要更新進階內容:
    1. 用修訂過的 URL 在 Web 瀏覽器上開啟 Rational Asset Managerhttp://host_name/ramjazz/admin
    2. 以管理者身分登入。
    3. 按一下伺服器 > 配置 > 進階內容
    4. 更新內含舊 URL 的內容。例如:com.ibm.ram.repository.service.internal.RepositoryRemoteService
  • 儲存在 Web 瀏覽器書籤裡的 Rational Asset Manager鏈結。

意見回饋