IBM Rational Application Developer for Windows 和 Linux 6.0 版安裝手冊


目錄

第 1 章 簡介

第 2 章 Rational Application Developer 的安裝需求

  • 硬體需求
  • 軟體需求
  • 作業系統
  • 其他軟體需求
  • 第 3 章 IBM Rational Software Development Platform

    第 4 章 安裝和解除安裝 Rational Application Developer for Windows

  • 移轉、升級和共存性問題
  • 從 CD-ROM 安裝
  • 從電子影像安裝
  • 建立網路安裝影像
  • 呼叫無聲自動安裝
  • 設定本端影像
  • 在預設目錄中無聲自動安裝預設特性
  • 無聲自動安裝至不同目錄
  • 無聲自動安裝其他 Rational Application Developer 特性
  • 啟動 Rational Application Developer
  • 解除安裝 Rational Application Developer
  • 無聲自動解除安裝 Rational Application Developer
  • 已知的問題和限制
  • 失敗安裝的復原
  • 無法安裝 WebSphere Application Server 6.0 版整合測試環境
  • 無法在 Windows Server 2003 中解除安裝 WebSphere Application Server 6.0 版整合測試環境
  • 取消安裝合併已安裝的產品後,再嘗試重新安裝可能會無法適當地安裝產品。
  • 第 5 章 安裝及解除安裝 Rational Application Developer for Linux

  • 移轉、升級和共存性問題
  • 從 CD-ROM 安裝
  • 從電子影像安裝
  • 建立網路安裝影像
  • 呼叫無聲自動安裝
  • 設定本端影像
  • 在預設目錄中無聲自動安裝預設特性
  • 無聲自動安裝至不同目錄
  • 無聲自動安裝其他 Rational Application Developer 特性
  • 增加可用的檔案控點數目
  • 啟動 Rational Application Developer
  • 解除安裝 Rational Application Developer
  • 無聲自動解除安裝 Rational Application Developer
  • 已知的問題和限制
  • 磁碟限制
  • 無法安裝 WebSphere Application Server 6.0 版整合測試環境
  • 取消安裝合併已安裝的產品後,再嘗試重新安裝可能會無法適當地安裝產品。
  • 第 6 章 安裝 Agent Controller

  • 硬體需求
  • 支援的平台
  • 支援的 JVM
  • 尋找安裝檔
  • 在工作站(AIX、HP-UX、Linux、Windows、Solaris)安裝 Agent Controller
  • 解除安裝舊版 Agent Controller
  • 安裝 Agent Controller
  • 無聲自動安裝 Agent Controller
  • 在 Windows 工作站中啟動和停止 Agent Controller
  • 在非 Windows 工作站中啟動和停止 Agent Controller
  • 在 Windows 工作站中解除安裝 Agent Controller
  • 在非 Windows 工作站中解除安裝 Agent Controller
  • 在 OS/400 (iSeries) 中安裝 Agent Controller
  • 解除安裝舊版 Agent Controller
  • 安裝 Agent Controller
  • 在 OS/400 (iSeries) 啟動及停止 Agent Controller
  • 在 OS/400 (iSeries) 解除安裝 Agent Controller
  • 在 OS/390 (z/OS) 安裝 Agent Controller
  • 解除安裝舊版 Agent Controller
  • 安裝 Agent Controller
  • 在 OS/390 (z/OS) 中啟動和停止 Agent Controller
  • 在 OS/390 (z/OS) 中解除安裝 Agent Controller
  • 使用 Agent Controller 安全特性
  • 已知的問題和限制
  • Agent Controller 可能無法在非 Windows 平台中啟動
  • 安裝和解除安裝期間發生其他錯誤
  • 第 7 章 設定 Rational Application Developer 在團隊環境中工作

  • 支援的軟體
  • IBM Rational ClearCase
  • IBM Rational ClearQuest
  • 安裝 Rational ClearCase LT
  • 下載 Rational ClearCase LT
  • 尋找版本注意事項和安裝指示
  • 安裝 Rational ClearCase LT
  • 配置 Rational ClearCase LT 授權
  • 搭配 Rational Application Developer 使用 Rational ClearCase
  • 更正預先存在的圖解元素類型
  • 解除安裝 Rational ClearCase LT
  • 第 8 章 將 WebSphere Application Server 5.x 安裝成整合測試環境

    第 9 章 安裝 WebSphere 5.x 版測試環境的傳訊和佇列作業支援

  • 在 Windows 中安裝及解除安裝傳訊和佇列作業支援
  • 從 CD-ROM 安裝
  • 解除安裝傳訊和佇列作業支援
  • 在 Linux 安裝及解除安裝傳訊和佇列作業支援
  • 安裝傳訊和佇列作業支援
  • 解除安裝傳訊和佇列作業支援
  • 第 10 章 安裝 WebSphere Portal 測試環境 5.0 版

    第 11 章 安裝 WebSphere Portal 測試環境 5.1 版

    第 12 章 安裝 Crystal Enterprise

    第 13 章 安裝更新項目

    第 14 章 版權和注意事項


    第 1 章 簡介

    這份安裝手冊提供安裝和解除安裝 Rational(R) Application Developer、選用特性和 Rational Application Developer 所提供的其他產品的指示。

    請參閱移轉手冊,以取得從 WebSphere(R) Studio 移轉的相關資訊。

    請參閱 Readme 檔,以取得產品問題和限制的相關資訊。

    請參閱 http://www.ibm.com/developerworks/rational,以取得更新的文件和疑難排解資訊。


    第 2 章 Rational Application Developer 的安裝需求


    硬體需求

    您必須先安裝下列硬體,才能安裝 Rational Application Developer:


    軟體需求

    作業系統

    您必須先安裝下列軟體,才能安裝 Rational Application Developer:

    其他軟體需求


    第 3 章 IBM Rational Software Development Platform

    IBM(R) Rational Software Development Platform 是下列產品所共用的共用開發環境:

    如果您安裝任何這些產品,都會將 Rational Software Development Platform 自動安裝成產品的一部分。如果您安裝了其中的多項產品,開發平台只會安裝一次。 所有這些產品都有相同的使用者介面,稱為工作台,每項產品都會藉著提供外掛程式而在工作台中加入新功能。外掛程式是將功能加入現有程式或應用程式中的軟體模組。

    啟動一起安裝在 Windows 中的 Rational 軟體產品

    當您開啟開始功能表時,不論您安裝了哪一項產品,最上層的功能表一律都是 IBM Rational

    依據您安裝的產品數目而定,最上層功能表中將提供您一或多個子資料夾(一項產品一個子資料夾)。比方說,如果您同時安裝了 Rational Function Tester 和 Rational Application Developer,這兩項產品將分別有一個子資料夾。 這些子資料夾將包含產品專用資訊的鏈結(如 Readme 檔),以及使用者介面的啟動點。 啟動點將採用產品的名稱(如 Rational Application Developer),但實際上是啟動共用使用者介面。

    您也可以按一下 IBM Rational 功能表下的 Rational Software Development Platform 選項來啟動共用使用者介面。

    啟動一起安裝在 Linux 中的 Rational 軟體產品

    當您在 Red Hat Enterprise Linux 中工作,您可以在程式設計下的主功能表中找到產品啟動點。 使用產品名稱(如:Rational Application Developer)的啟動點和 Rational Software Development Platform 啟動點,都會啟動共用使用者介面。若要找出產品特定的資訊(如:Readme 檔), 請瀏覽至您在其中安裝 Rational Software Development Platform 的產品特定目錄(如:rad_prod 表示 Rational Application Developer)。

    當您在 SuSE Linux Enterprise Server (SLES) 中工作, 您可以在 IBM Rational 下的主功能表中找到產品啟動點。 使用產品名稱(如:Rational Application Developer)的啟動點和 Rational Software Development Platform 啟動點,都會啟動共用使用者介面。若要找出產品特定的資訊(如:Readme 檔), 請瀏覽至您在其中安裝 Rational Software Development Platform 的產品特定目錄(如:rad_prod 目錄表示 Rational Application Developer)。

    移轉和共存性

    下圖說明您試圖將多個 Rational Software Development Platform 常用的產品安裝在相同機器時會發生什麼。 (下圖中的垂直軸代表已安裝的產品,水平軸代表您試圖安裝的產品):


    試圖安裝 Rational Software Modeler Rational Web Developer Rational Application Developer Rational Software Architect Rational Functional Tester Rational Performance Tester
    Rational Software Modeler N/A 共用 共用 升級 共用 共用
    Rational Web Developer 共用 N/A 升級 升級 共用 共用
    Rational Application Developer 共用 阻擋 N/A 升級 共用 共用
    Rational Software Architect 阻擋 阻擋 阻擋 N/A 共用 共用
    Rational Functional Tester 共用 共用 共用 共用 N/A 共用
    Rational Performance Tester 共用 共用 共用 共用 共用 N/A

    定義:

    解除安裝

    註:
    使用者介面會安裝在您安裝的第一個基於 Rational Software Development Platform 之產品的安裝目錄中。 它不會隨著任何其他產品而重新安裝,因此,如果您升級第一項產品,在升級完成之後,您不應移除第一個安裝目錄,因為它仍會包含使用者介面內容。

    第 4 章 安裝和解除安裝 Rational Application Developer for Windows

    這一節包含在 Windows 中安裝 Rational Application Developer 的相關資訊。 您可以從 CD-ROM 或下載的電子影像來安裝 Rational Application Developer。 您可以利用所提供的安裝精靈,也可以依照這份文件稍後所說明,在命令提示字元之下安裝 Rational Application Developer,或執行無聲自動安裝。

    安裝程式也可以在互動式主控台模式下執行,這比較適合需要協助工具的使用者。 協助工具模式指令行選項:

    -accessibility

    會使螢幕讀取器程式更容易使用執行時期主控台模式精靈。 如果要執行主控台模式,請從第一片 Rational Application Developer 安裝 CD 的 \setup 目錄執行這個指令:

    setup.exe -is:javaconsole -log @NONE -accessibility
    

    請遵循提示來完成安裝。請注意,當指定 -accessibility 選項時,-is:javaconsole 選項非常重要。 如果您未指定這個選項,安裝程式就會當掉。-log @NONE 選項會關閉記載功能,以消除命令提示字元視窗中所列出的日誌資訊。如果您在安裝期間遇到任何問題, 您可能要拿掉這個選項,以收集日誌資訊。


    移轉、升級和共存性問題

    您不能從 WebSphere Studio Site Developer 或 WebSphere Studio Application Developer 4.x.x 版或 5.0.x 版移轉至 Rational Application Developer。 不過,Rational Application Developer 可以與這些產品並存。必要的話, 您可以從 Rational ClearCase(R)、Clear Case LT 和 CVS 中,將工作區、成品和專案手動移轉至 Rational Application Developer

    您可以從 WebSphere Studio 5.1.x 移轉至 Rational Application Developer,也可以選擇共存。請參閱移轉手冊,以取得 Rational Application Developer 更多移轉資訊。

    請參閱第 3 章, "IBM Rational Software Development Platform",以取得關於 IBM Rational Software Development Platform,以及其他產品以這個開發平台為基礎的共存性的詳細資訊。

    如果您有舊版的 Agent Controller 或從 Hyades Data Collection Engine 衍生而來的任何軟體,請先將它停止、解除安裝,以及清除遺留的檔案,之後,再安裝這個版本的 Agent Controller。 如果需要詳細資訊,請參閱第 6 章, "安裝 Agent Controller"


    從 CD-ROM 安裝

    在安裝產品之前,請確認下列各項:

    如果要從第一片產品安裝 CD 安裝 Rational Application Developer,請遵循下列步驟:

    1. 在您開始安裝程序之前,請先閱讀"移轉、升級和共存性問題"
    2. 確定您使用的使用者 ID 含雙位元組字元。
    3. 將 CD 插入您的光碟機中。
    4. 如果系統已啟用自動執行,就會自動開啟安裝啟動程式。如果系統停用了自動執行功能,請從第一片安裝 CD 的根目錄執行 launchpad.exe 來顯示「Rational Application Developer 安裝啟動程式」視窗。

      要訣:

    5. 從 Rational Application Developer 安裝啟動程式中,選取安裝 IBM Rational Application Developer 6.0 版
    6. 等安裝精靈開啟之後,再按下一步繼續安裝。
    7. 遵循畫面的作業指示,如閱讀授權合約和指定目標安裝目錄。
    8. 在「特性」視窗中,您可以選擇要安裝的 Rational Application Developer 特性。 您可以返回安裝精靈,稍後再安裝選用特性。
      1. 依預設,安裝程式會將整合開發環境及選用的 WebSphere Application Server 6.0 版安裝成測試執行時期環境。
      2. 如果您要安裝英文以外受支援之國家語言的使用者介面和文件,請選擇安裝語言套件。 如果您的系統語言環境是英文,依預設,不會啟用這項特性。如果您的系統語言是其他支援的國家語言之一,就會選取它。

        支援的國家語言有巴西葡萄牙文、法文、德文、義大利文、日文、韓文、簡體中文、西班牙文和繁體中文。

        附註:如果您選擇安裝選用的「語言套件」特性,之後,又緊接著在複製檔案時取消安裝,後續的安裝便會有些異常。 在後續安裝中,「特性」畫面會將「語言套件」特性的狀態顯示為(已安裝),即使組成語言套件的檔案並沒有安裝也一樣。 您可以選擇重新安裝「語言套件」特性,這會將適當的檔案複製到您的磁碟中。 在這個狀況下,安裝結束時,可能會出現一則訊息指出在取代檔案期間,發生一或多個錯誤。您可以放心忽略這個錯誤訊息。

      3. 依預設,不會安裝 Enterprise Generation Language (EGL) 特性。EGL 是一個用來建立複雜商業應用程式的高階且功能強大的語言。 它會解決複雜的基礎技術(如資料庫存取、訊息佇列和 J2EE 等),因此,應用程式開發人員可以全心處理他們旳商業邏輯。 如果要安裝 EGL 外掛程式,請選取 Enterprise Generation Language (EGL) 勾選框。
      4. 依預設,不會安裝「入口網站工具」特性。如果要安裝「入口網站工具」特性,請選取入口網站工具勾選框。
      5. 依預設,不會安裝開發 Eclipse 外掛程式的範例。 這些範例適用於想要建立自己的外掛工具來延伸工作台的開發人員。 如果要安裝 Eclipse 外掛程式開發的範例,請選取 Eclipse 外掛程式開發勾選框。
    9. 下一步來顯示 Rational Application Developer 安裝的摘要資訊。

      註:
      所顯示的磁碟空間需求是所有檔案所需的總位元組數。 您可以將實際需要的磁碟空間設想成大一些。 尤其是,如果您的磁碟格式是 FAT32,由於 FAT32 所用的磁碟區塊架構,許多小檔案的磁碟空間運用效率可能會不好。
    10. 下一步來安裝 Rational Application Developer。
    11. 如果安裝結束時出現警告,指出授權登錄發生問題,請遵循下列步驟:
      1. 移至安裝目錄下的 \logs 子目錄。
      2. 利用文字編輯器來開啟 license.log。
      3. 如果 license.log 含有下面幾行:

        486604803  要求的授權已過期
        486604805 所有授權的開始日期都還沒到
        
        請確定系統時鐘設定正確,再啟動 Rational Application Developer。
    12. 安裝程式要花一些時間來設定開發環境和起始設定 Eclipse。 最後,會出現一則確認安裝已經完成的訊息。 按下一步來完成安裝。
    13. 下一畫面會提供選項,供您啟動 Agent Controller 的安裝程序。 在使用 Rational Application Developer 的側寫、執行時期分析和記載特性之前,您必須先安裝 Agent Controller。 請參閱第 6 章, "安裝 Agent Controller",以取得詳細資料。如果您目前不想安裝 Agent Controller,請取消選取這個選項。

      這個畫面也會有一則訊息,建議您利用 Rational Product Updater 來檢查所安裝之特性的更新項目。 (請參閱第 13 章, "安裝更新項目",以取得詳細資訊。) 請按一下完成來關閉安裝視窗。

    14. 如果您要開發在其他應用程式伺服器中執行的應用程式,您可以選擇性地選擇隨著 Rational Application Developer 而安裝其他執行時期測試環境。如果需要詳細資訊,請參閱第 8 章, "將 WebSphere Application Server 5.x 安裝成整合測試環境"
    15. 在利用 Rational Application Developer 的側寫、執行時期分析和記載特性來收集遠端資料之前,您必須先將 Agent Controller 安裝在本端和遠端主機上。 請參閱第 6 章, "安裝 Agent Controller",以取得詳細資料。
    16. 如果您要對 WebSphere Application Server 6.0 版測試傳訊和 Web 服務應用程式,預設傳訊提供者的支援會自動可用,因此您不應該安裝內嵌傳訊用戶端和伺服器支援。不過,如果您要使用 WebSphere 5.x 版測試環境,您必須個別安裝內嵌傳訊用戶端和伺服器特性。 如果需要詳細資訊,請參閱第 9 章, "安裝 WebSphere 5.x 版測試環境的傳訊和佇列作業支援"

      重要事項:如果已安裝 MQSeries(R),請安裝傳訊和佇列作業用戶端與伺服器,因為它們是 MQSeries 的功能子集。

    17. 如果您要使用 Rational ClearCase 作為軟體配置管理 (SCM) 系統,您可以現在或稍後再安裝 Rational ClearCase LT 特性。如果需要 Rational ClearCase 的詳細資訊,請參閱第 7 章, "設定 Rational Application Developer 在團隊環境中工作"
    18. 如果您要安裝入口網站測試環境 5.0 版,您可以在安裝好 Rational Application Developer 之後再安裝它。 如果需要詳細資訊,請參閱第 10 章, "安裝 WebSphere Portal 測試環境 5.0 版"
    19. Crystal Enterprise 是一個專為了整合現有的資料、Web 和應用程式之投資而設計的資料存取和報告基礎架構。 它是以 Crystal Reports 為基礎。Rational Application Developer 包括 Crystal Enterprise Embedded Edition 和 Crystal Enterprise Professional Edition(這是 Embedded Edition 的超集)。如果需要安裝它們的詳細資訊,請參閱第 12 章, "安裝 Crystal Enterprise"

    註:

    從電子影像安裝

    請參閱產品 Readme 檔,以取得您需要下載的電子影像的說明。

    在安裝產品之前,請確認下列各項:

    如果要下載和建立電子安裝影像,請執行下列動作:

    1. 將所有必要的組件和想要的選用組件下載到相同的暫時目錄中。 如果稍後需要任何選用的組件,在開始安裝之前,請先下載這些附加的選用組件,重新執行解壓縮工具。
      註:
      當利用電子影像,從 Rational Software Development Platform 產品升級至另一產品時,請確定為了新產品而下載和解壓縮的影像,是您為了原有產品而下載和解壓縮的同一組影像。 安裝在原有產品中的相同元件,會自動安裝在升級的產品中。

      比方說,如果原先安裝了語言套件,當升級時,您必須將語言套件下載和解壓縮至新產品安裝影像中。

    2. 啟動位在暫時目錄中的 extractor.exe 檔。這會啟動建立安裝影像的精靈。
    3. 遵循精靈中的指示來指定要建立影像的位置及要併入哪些特性。
    4. 建立好影像之後,如果您要立即安裝產品,請按一下完成。 另外,您也可以取消選取啟動安裝精靈勾選框,稍後再從建立安裝影像的目錄啟動 disk1\launchpad.exe 來執行安裝程式。
    5. 請遵循"從 CD-ROM 安裝"一節中所說明的指示。

    建立網路安裝影像

    您可以將一份安裝影像放在網路磁碟機中,讓使用者能夠通過網路來安裝。

    如果要從網路磁碟機執行安裝程式,您必須使用 Rational Application Developer 的下載電子影像,或依照下列說明來複製 CD 的內容。

    您需要大約 6 GB 磁碟空間來將 CD 內容儲存在磁碟中。如果要從 CD 中複製檔案,請執行下列動作:

    1. 將第一片 Rational Application Developer 安裝 CD 插入光碟機中。
    2. 在您要儲存影像的網路磁碟機中,建立一個暫時目錄(如 network_drive:\install_image)。
    3. 在暫時目錄下,建立稱為 disk1 的子目錄。這個子目錄必須稱為 disk1,且必須是小寫。
    4. 將第一片安裝 CD 中的所有檔案和目錄複製到暫時目錄的 disk1 子目錄中。
    5. 重複第 3 和 4 步驟,將另兩片 CD 的內容複製到稱為 disk2disk3 的子目錄中。

    這些都是核心安裝檔案。 如果您需要任何選用特性的安裝檔案:

    1. Agent Controller
    2. 內嵌傳訊用戶端和伺服器
    3. Rational ClearCase LT
    4. WebSphere 5.x 版測試環境
    5. WebSphere Portal 測試環境 5.0 版
    6. Crystal Enterprise V10 Professional Edition
    7. Crystal Enterprise V10 Embedded Edition

    請將適當 CD 的內容複製到暫時目錄中。

    附註(R)


    呼叫無聲自動安裝

    如果您不要與安裝精靈交談,Rational Application Developer 安裝程式採無聲方式來執行。

    設定本端影像

    在無聲自動安裝 Rational Application Developer 之前,您必須先設定本端影像:

    1. 在您開始安裝程序之前,請先閱讀"移轉、升級和共存性問題"
    2. 確定您使用的使用者 ID 含雙位元組字元。
    3. 依照"建立網路安裝影像"中所說明來建立本端或網路安裝影像。 如果您只要安裝 Rational Application Developer,您只需要複製前三片 CD 中的資訊。

    在預設目錄中無聲自動安裝預設特性

    當無聲自動安裝 Rational Application Developer 時,依預設,會安裝下列特性:

    如果要在預設目錄 system_drive:\Program Files\IBM\Rational\SDP\6.0 中,無聲地安裝只含有預設所選特性的 Rational Application Developer,請執行下列動作:

    1. 如果您還沒有依照"設定本端影像"所說明來複製影像,請執行這個動作。
    2. 從指令行中,切換至上一節所建立的暫時目錄中之 \disk1\setup 目錄(如 network_drive:\install_image\disk1\setup)。
    3. 執行下列指令:
      setup.exe -silent 
      
    4. 無聲自動安裝 Rational Application Developer 可能需要好一會兒才能完成。如果要確定安裝完成的時間,您可以定期監視預設安裝目錄中的 \logs 目錄。如果出現 license.log 檔,就表示無聲自動安裝已經完成。

    無聲自動安裝至不同目錄

    您可以變更 installLocation 參數,將 Rational Application Developer 安裝在不同目錄中。比方說,如果您要使 "d:\my softdev" 成為安裝目錄,請遵循剛才所說明的相同步驟,但執行下列指令:

    setup.exe -silent -P installLocation="d:\my softdev"
    

    (在這個範例中,只會安裝預設特性。)

    無聲自動安裝其他 Rational Application Developer 特性

    Rational Application Developer 提供一個無聲自動安裝所有預設特性的範例回應檔。 這個回應檔稱為 responsefile.txt,在 \disk1\util 目錄中。 如果您要變更回應檔來安裝其他特性,建議您先建立 responsefile.txt 的備份。

    您可以更新回應檔來安裝一或多個選用的 Rational Application Developer 特性。下表顯示回應檔選項及它們在回應檔中的對應項目。


    表 1. 回應檔選項清單。

    特性 回應檔項目
    產品安裝目錄 installLocation
    WebSphere Application Server 6.0 版 feature_was6_win32.active
    語言套件 feature_lang_pack_rad_win32.active
    企業產生語言 (EGL) feature_egl_win32.active
    入口網站工具 feature_portal_win32.active
    Eclipse 外掛程式開發的範例 feature_examples_win32.active

    如果要無聲自動安裝任何選用特性,請執行下列動作:

    1. 將 responsefile.txt 複製到新檔案中,如 myresponsefile.txt。
    2. 編輯回應檔的複本。
    3. 找出有上表所顯示安裝特性名稱的行。 比方說,如果您要安裝開發 Eclipse 外掛程式的範例,您要在回應檔中找出 # -P feature_examples_win32.active=<value> 這一行。
    4. 將這一行變更如下:
      1. 移除第一直欄中的 #。
      2. <value> 改成 true

      在這個範例中,這一行會改成:

         -P feature_examples_win32.active=true
      
    5. 儲存變更。
    6. 如果您還沒有依照"設定本端影像"所說明來複製影像,請執行這個動作。
    7. 從指令行中,切換至上一節所建立的暫時目錄中之 \disk1\setup 目錄(如 network_drive:\install_image\disk1\setup)。
    8. 當您執行回應檔時,請如下所示,加入 -options 參數及完整定義的回應檔名稱:
      setup.exe -silent -options "Your_directory\myresponsefile.txt"
      

      其中 Your_directory 是回應檔所在的完整目錄名稱。

      註:
      如果要確認正在使用您的回應檔,請先執行不設定 -silent 選項的這個指令(也就是說,在執行無聲自動安裝之前),並確認您的設定登錄在安裝精靈中。 如果沒有登錄它們,就表示回應檔設定或指令語法發生問題。
    9. 無聲自動安裝 Rational Application Developer 可能需要好一會兒才能完成。如果要確定安裝完成的時間,您可以定期監視安裝目錄中的 \logs 子目錄。如果出現 license.log 檔,就表示無聲自動安裝已經完成。

    啟動 Rational Application Developer

    如果要啟動 Rational Application Developer,請執行下列動作:

    1. 選取開始 > 程式集 > IBM Rational > IBM Rational Application Developer 6.0 > Rational Application Developer。 您也可以選取開始 > 程式集 > IBM Rational > Rational Software Development Platform 來啟動產品。
    2. 當您第一次啟動 Rational Application Developer 時,會開啟一個對話框,其中已指定預設的 workspace 目錄。依預設,您的工作會儲存在 C:\Documents and Settings\youruserid\IBM\rationalsdp6.0 下名稱為 workspace 的目錄中。 如果您要將工作儲存在其他位置,您可以變更 workspace 的名稱和位置。
    3. 依預設,會取消選取請用這個作為預設值,以後不要再問我勾選框。 如果您保留預設值,您每次啟動 Rational Application Developer 時,都會開啟一個對話框,讓您切換工作區。 比方說,如果您選擇不同專案要維護不同的工作區,您可以保留這個預設值。

      要訣:如果選取請用這個作為預設值,以後不要再問我勾選框,就不會再開啟這個對話框,Rational Application Developer 會利用上一階段作業的工作區來啟動。您可以在啟動產品之後,在視窗 > 喜好設定 > 工作台 > 啟動和關閉頁面中變更這個預設值。

    4. 然後按一下確定。在建立工作區結構時,會有一次延遲。

    工作台首先會開啟一系列的歡迎使用頁面來提供產品概觀和新增功能的相關資訊,以及通往指導教學、範例和外部 Web 資源的鏈結。 請花些時間來探索這些選項。 另外,也請注意「說明」功能表所提供的資訊來源。


    解除安裝 Rational Application Developer

    如果要解除安裝 Rational Application Developer,請執行下列動作:

    1. 關閉 Rational Application Developer。
    2. 開啟「控制台」,然後開啟「新增/移除程式」視窗。選取 IBM Rational Application Developer 6.0,然後按一下變更/移除來解除安裝。
    3. 任何 plug-ins 或 features 目錄中的所有檔案都會自動刪除,任何這些目錄中的使用者資料和協力廠商外掛程式都包括在內。不會刪除含有您的工作的工作區目錄。 會保留部分其他目錄:

    如果您試圖局部解除安裝一或多項 Rational Application Developer 必要特性,您會收到一則類似下列錯誤訊息:

    選項無效:
    無法解除安裝 ide_required:沒有設定解除安裝的 root
    

    如果要暫時解決這個問題,請選取解除安裝產品勾選框。這會重新起始設定解除安裝畫面,因此,您現在可以解除安裝整個 Rational Application Developer,也可以取消選取您要解除安裝的特性。

    無聲自動解除安裝 Rational Application Developer

    如果要無聲自動解除安裝 Rational Application Developer,請從命令提示字元下進入安裝目錄,然後輸入:

    rad_prod\_uninst\uninstall.exe -silent
    

    已知的問題和限制

    這一節包含在 Windows 中安裝和解除安裝 Rational Application Developer 時,已知的問題和限制。請參閱 Readme 檔或線上說明,以取得會影響產品實際用法之問題和限制的相關資訊。

    失敗安裝的復原

    如果安裝作業失敗,您必須移除所有已安裝的 Rational Application Developer 檔案。如果您要安裝 Rational Application Developer 的目錄是空的,就表示安裝程序已移除所有已安裝的檔案,您可以刪除這個空目錄。

    無法安裝 WebSphere Application Server 6.0 版整合測試環境

    如果您在安裝 Rational Application Developer 時選擇安裝 WebSphere Application Server 6.0 版整合測試環境,且安裝失敗,您會見到下列訊息:

    WebSphere Application Server 6.0 版整合測試環境安裝失敗。
    仍會執行 IBM Rational Software Development Platform,
    但無法使用 WebSphere Application Server 6.0 版整合測試環境。
    

    如果需要 WebSphere Application Server 6.0 版疑難排解安裝的相關資訊,請參閱 http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tins_trouble.html

    請注意,依預設,WebSphere Application Server 6.0 版整合測試環境是安裝在 Rational Application Developer 安裝目錄的 \runtimes\base_v6 子目錄中。

    無法在 Windows Server 2003 中解除安裝 WebSphere Application Server 6.0 版整合測試環境

    在 Windows Server 2003 中,如果已安裝和配置終端機伺服器,當您解除安裝 Rational Application Developer 時,無法移除 WebSphere Application Server 6.0 版整合測試環境。 如果要移除它,請從產品的安裝目錄中執行下列指令(如 C:\Program Files\IBM\Rational\SDP\6.0):

    \runtimes\base_v6\_uninst\uninstall.exe -silent
    

    取消安裝合併已安裝的產品後,再嘗試重新安裝可能會無法適當地安裝產品。

    如果您在檔案已開始複製到系統之後取消安裝,且您要在其中安裝的機器已有另一個 Software Development Platform 產品, 則該產品的後續安裝可能會失敗。您可能不會收到任何錯誤,但新安裝的產品可能會無法使用。即使產品的開始功能表項目存在,預期的說明和產品功能表也可能不會存在。在產品內,您可能會看到一些已登錄的外掛程式, 但新的產品會無法使用。

    如果您在取消合併安裝之後遇到問題,您需要根據您的狀況,採取下列其中一項的一連串動作:

    1. 如果您在開始複製檔案之前取消安裝, 您可以重新開始安裝,而不需要遵循以下說明的任一暫行解決方法。
    2. 這個問題的暫行解決方法會根據您所處的安裝程序位置而定。 如果您尚未開始第二次安裝,您可以編輯下列清單中適用於您系統的檔案:

      移除等號 (=) 之後的任何內容,其含有 3 個字母的代碼表示要安裝的產品。這些代碼如下:

      在編輯檔案之後,重新開始安裝,且不要在開始複製檔案之後取消安裝。

    3. 如果您已完成產品安裝,您必須執行解除安裝再重新安裝,且不要在開始複製檔案之後取消安裝。

    第 5 章 安裝及解除安裝 Rational Application Developer for Linux

    本節包含在 Linux 安裝 Rational Application Developer 的相關資訊。您可以從 CD-ROM 或下載的電子影像來安裝 Rational Application Developer。 您可以利用所提供的安裝精靈,但也可以依照這份文件稍後所說明,在命令提示字元之下安裝 Rational Application Developer,或執行無聲自動安裝。

    安裝注意事項:

    重要事項 - 在使用這項產品之前:


    移轉、升級和共存性問題

    您可以從 WebSphere Studio 5.1.x 版移轉至 Rational Application Developer,也可以選擇與 Rational Application Developer 共存。請參閱移轉手冊,以取得 Rational Application Developer 更多移轉資訊。

    您不能從 WebSphere Studio Site Developer 或 WebSphere Studio Application Developer 4.x.x 版或 5.0.x 版移轉至 Rational Application Developer。 不過,Rational Application Developer 可以與這些產品共存。必要的話, 您可以從 Rational ClearCase、Clear Case LT 和 CVS 中,將工作區、成品和專案手動移轉至 Rational Application Developer。

    請參閱第 3 章, "IBM Rational Software Development Platform",以取得關於 IBM Rational Software Development Platform,以及其他產品以這個開發平台為基礎的共存性的詳細資訊。

    如果您有舊版的 Agent Controller 或從 Hyades Data Collection Engine 衍生而來的任何軟體,請先將它停止、解除安裝,以及清除遺留的檔案,之後,再安裝這個版本的 Agent Controller。 如果需要詳細資訊,請參閱第 6 章, "安裝 Agent Controller"


    從 CD-ROM 安裝

    在安裝產品之前,請確認下列各項:

    如果要從產品安裝 CD 安裝 Rational Application Developer,請遵循下列步驟:

    1. 在您開始安裝程序之前,請先閱讀"移轉、升級和共存性問題"
    2. 以 root 使用者身分登入。
    3. 啟動一個終端機階段作業。
    4. 輸入 Umask 0022,使 root 以外的使用者也能夠使用這項產品。
    5. 將 CD 插入光碟機中。

      在安裝期間,您必須插入下一片 CD。 如果您無法開啟 CD-ROM 來插入下一片 CD,請檢查下列是否有下列情況:

      如果在插入下一片 CD 時仍有問題,請遵循下列步驟:

      1. 如果安裝程式仍在執行中,請按一下取消
      2. 以 root 使用者身分登入。
      3. 如果還沒有將 Linux 程式模組散布 CD 中的 psmisc RPM 套件安裝在您的機器上,請安裝它。
      4. 啟動安裝程式。
      5. 如果仍有問題,請從另一個終端機輸入 /sbin/fuser CD_device 來顯示使用 CD-ROM 的程序。
      6. 如果要取得程序的詳細資料,請輸入:ps <process_id>
    6. 如果沒有裝載 CD-ROM,請輸入下列指令來裝載它:
      mount CD_device
      
    7. 輸入 CD_device/launchpad.bin 來顯示「Rational Application Developer 安裝啟動程式」視窗。

      要訣:

    8. 從 Rational Application Developer 安裝啟動程式中,選取安裝 IBM Rational Application Developer 6.0 版
    9. 等安裝精靈開啟之後,再按下一步繼續安裝。
    10. 遵循畫面的作業指示,如閱讀授權合約和指定目標安裝目錄。
    11. 在「特性」視窗中,您可以選擇要安裝的 Rational Application Developer 特性。

      1. 依預設,安裝程式會將整合開發環境及選用的 WebSphere Application Server 6.0 版安裝成測試執行時期環境。
      2. 如果您要安裝英文以外受支援之國家語言的使用者介面和文件,請選擇安裝語言套件。 如果您的系統語言環境是英文,依預設,不會啟用這項特性。如果您的系統語言是其他支援的國家語言之一,就會選取它。

        支援的國家語言有巴西葡萄牙文、法文、德文、義大利文、日文、韓文、簡體中文、西班牙文和繁體中文。

        附註:如果您選擇安裝選用的「語言套件」特性,之後,又緊接著在複製檔案時取消安裝,後續的安裝便會有些異常。 在後續安裝中,「特性」畫面會將「語言套件」特性的狀態顯示為已安裝,即使組成語言套件的檔案並沒有安裝也一樣。您可以選擇重新安裝「語言套件」特性,這會將適當的檔案複製到您的磁碟中。 在這個情況下,安裝結束時,可能會出現一則訊息指出在取代檔案期間,發生一或多個錯誤。您可以放心忽略這個錯誤訊息。

      3. 依預設,不會安裝 Enterprise Generation Language (EGL) 特性。EGL 是一個用來建立複雜商業應用程式的高階且功能強大的語言。 它會解決複雜的基礎技術(如資料庫存取、訊息佇列和 J2EE 等),因此,應用程式開發人員可以全心處理他們旳商業邏輯。 如果要安裝 EGL 外掛程式,請選取 Enterprise Generation Language (EGL) 勾選框。
      4. 依預設,不會安裝「入口網站工具」特性。如果要安裝「入口網站工具」特性,請選取入口網站工具勾選框。
      5. 依預設,不會安裝開發 Eclipse 外掛程式的範例。 這些範例適用於想要建立自己的外掛工具來延伸工作台的開發人員。 如果要安裝 Eclipse 外掛程式開發的範例,請選取 Eclipse 外掛程式開發勾選框。
    12. 下一步來顯示 Rational Application Developer 安裝的摘要資訊。
    13. 下一步繼續安裝 Rational Application Developer。
    14. 當系統要求下一片 CD 時,請遵循下列步驟:
      1. 如果要開啟 CD-ROM,請輸入 eject CD_device
      2. 將下一片 CD 插入 CD-ROM 中。
      3. 如果沒有選取自動裝載,請輸入下列指令來裝載 CD-ROM:mount CD_device
      4. 按一下確定,繼續安裝。
    15. 如果安裝結束時出現警告,指出授權登錄發生問題,請遵循下列步驟:
      1. 移至安裝目錄下的 /logs 子目錄。
      2. 利用文字編輯器來開啟 license.log。
      3. 如果 license.log 含有下面幾行:

        486604803  要求的授權已過期
        486604805 所有授權的開始日期都還沒到
        
        請確定系統時鐘設定正確,再啟動 Rational Application Developer。
    16. 安裝好 Rational Application Developer 之後,按下一步來完成安裝作業。
    17. 下一畫面會提供選項,供您啟動 Agent Controller 的安裝程序。 在使用 Rational Application Developer 的側寫、執行時期分析和記載特性之前,您必須先安裝 Agent Controller。 請參閱第 6 章, "安裝 Agent Controller",以取得詳細資料。如果您目前不想安裝 Agent Controller,請取消選取這個選項。

      這個畫面也會有一則訊息,建議您利用 Rational Product Updater 來檢查所安裝之特性的更新項目。 (請參閱第 13 章, "安裝更新項目",以取得詳細資訊。) 請按一下完成來關閉安裝視窗。

    18. 如果您要開發在其他應用程式伺服器中執行的應用程式,您可以選擇性地選擇隨著 Rational Application Developer 而安裝其他執行時期測試環境。如果需要詳細資訊,請參閱第 8 章, "將 WebSphere Application Server 5.x 安裝成整合測試環境"
    19. 在利用 Rational Application Developer 的側寫、執行時期分析和記載特性來收集遠端資料之前,您必須先將 Agent Controller 安裝在本端和遠端主機上。 請參閱第 6 章, "安裝 Agent Controller",以取得詳細資料。
    20. 如果您要對 WebSphere Application Server 6.0 版測試傳訊和 Web 服務應用程式,預設傳訊提供者的支援會自動可用,因此您不應該安裝內嵌傳訊用戶端和伺服器支援。不過,如果您要使用 WebSphere 5.x 版測試環境,您必須個別安裝內嵌傳訊用戶端和伺服器特性。 如果需要詳細資訊,請參閱第 9 章, "安裝 WebSphere 5.x 版測試環境的傳訊和佇列作業支援"

      重要事項:如果已安裝 MQSeries,請安裝傳訊和佇列作業用戶端與伺服器,因為它們是 MQSeries 的功能子集。

    21. 如果您要使用 Rational ClearCase 作為軟體配置管理 (SCM) 系統,您可以現在或稍後再安裝 Rational ClearCase LT 特性。如果需要 Rational ClearCase 的詳細資訊,請參閱第 7 章, "設定 Rational Application Developer 在團隊環境中工作"
    22. Crystal Enterprise 是一個專為了整合現有的資料、Web 和應用程式之投資而設計的資料存取和報告基礎架構。 它是以 Crystal Reports 為基礎。如果需要安裝它的詳細資訊,請參閱第 12 章, "安裝 Crystal Enterprise"

    註:

    從電子影像安裝

    請參閱產品 Readme 檔,以取得您需要下載的電子影像的說明。

    在安裝產品之前,請確認下列各項:

    如果要下載和建立電子安裝影像,請執行下列動作:

    1. 將所有必要的組件和想要的選用組件下載到相同的暫時目錄中。 如果稍後需要任何選用的組件,在開始安裝之前,請先下載這些附加的選用組件,重新執行解壓縮工具。
      註:
      當利用電子影像,從 Rational Software Development Platform 產品升級至另一項產品時,請確定為了新產品而下載和解壓縮的影像,是您為了原有產品而下載和解壓縮的同一組影像。 安裝在原有產品中的相同元件,會自動安裝在升級的產品中。

      比方說,如果原先安裝了語言套件,當升級時,您必須將語言套件下載和解壓縮至新產品安裝影像中。

    2. 輸入下列指令來修改這個暫時目錄中之 extractor.bin 檔的許可權:
      chmod +x extractor.bin
      
    3. 輸入 ./extractor.bin 來執行檔案
    4. 遵循精靈中的指示來指定要建立影像的位置及要併入哪些特性。
    5. 建立好影像之後,如果您要立即安裝產品,請按一下完成。 另外,您也可以取消選取啟動安裝精靈勾選框,稍後再從建立安裝影像所在的目錄啟動 disk1/launchpad.bin 來執行安裝程式。
    6. 請遵循"從 CD-ROM 安裝"一節中所說明的指示。

    建立網路安裝影像

    您可以將一份安裝影像放在網路磁碟機中,讓使用者能夠透過網路來安裝。

    如果要從網路磁碟機執行安裝程式,您必須使用 Rational Application Developer 的下載電子影像,或依照下列說明來複製 CD 的內容。

    您需要大約 6 GB 磁碟空間來將 CD 內容儲存在磁碟中。 如果要從 CD 中複製檔案,請執行下列動作:

    1. 以 root 使用者身分登入。
    2. 在您要儲存影像的網路磁碟機中,建立一個目錄(如 install_image)。
    3. 將第一片 Rational Application Developer 安裝 CD 插入光碟機中。
    4. 在暫時目錄下,建立稱為 disk1 的子目錄。這個子目錄必須稱為 disk1,且必須是小寫。
    5. 將第一片安裝 CD 中的所有檔案和目錄複製到暫時目錄的 disk1 子目錄中。
    6. 重複第 3、4 和 5 步驟,將另兩片 CD 的內容複製到稱為 disk2disk3 的子目錄中。

    這些都是核心安裝檔案。 如果您需要下列中任何選用特性的安裝檔案:

    1. Agent Controller
    2. 內嵌傳訊用戶端和伺服器
    3. Rational ClearCase LT
    4. WebSphere 5.x 版測試環境
    5. WebSphere Portal 測試環境 5.0 版
    6. Crystal Enterprise V10 Professional Edition
    7. Crystal Enterprise V10 Embedded Edition

    請將適當 CD 的內容複製到暫時目錄中。

    註:
    如果從網路安裝影像安裝時,您的機器進入待命模式,安裝可能會失敗。

    呼叫無聲自動安裝

    如果您不要與安裝精靈交談,Rational Application Developer 安裝程式採無聲方式來執行。

    設定本端影像

    在無聲自動安裝 Rational Application Developer 之前,您必須先複製本端影像:

    1. 在您開始安裝程序之前,請先閱讀"移轉、升級和共存性問題"
    2. 依照"建立網路安裝影像"中所說明來建立本端或網路安裝影像。 如果您只要安裝 Rational Application Developer,您只需要複製前三片 CD 中的資訊。

    在預設目錄中無聲自動安裝預設特性

    當無聲自動安裝 Rational Application Developer 時,依預設,會安裝下列特性:

    如果要在預設目錄 /opt/IBM/Rational/SDP/6.0 中,無聲自動安裝只含有預設所選特性的 Rational Application Developer,請執行下列動作:

    1. 以 root 使用者身分登入。
    2. 如果您還沒有依照"設定本端影像"所說明來複製影像,請執行這個動作。
    3. 從指令行中,切換至上一節所建立的暫時目錄之 /disk1/setup 目錄(如 /tmp/install_image/disk1/setup)。
    4. 執行下列指令:
      ./setup.bin -silent 
      
    5. 無聲自動安裝 Rational Application Developer 可能需要好一會兒才能完成。 如果要確定安裝完成的時間,您可以定期監視安裝目錄中的 /logs 子目錄。如果出現 license.log 檔,就表示無聲自動安裝已經完成。

    無聲自動安裝至不同目錄

    您可以變更 installLocation 參數,將 Rational Application Developer 安裝在不同目錄中。 比方說,如果您要使 "/my_softdev" 成為安裝目錄,請遵循剛才所說明的相同步驟,但執行下列指令:

    ./setup.bin -silent -P installLocation="/my_softdev"
    

    在這個範例中,只安裝預設特性。

    無聲自動安裝其他 Rational Application Developer 特性

    Rational Application Developer 提供一個範例回應檔。 這個回應檔稱為 responsefile.txt,在 /disk1/util 目錄中。 如果您要變更回應檔來安裝其他特性,建議您先建立 responsefile.txt 的備份。

    您可以更新回應檔來安裝一或多個選用的 Rational Application Developer 特性。下表顯示回應檔選項及它們在回應檔中的對應項目。


    表 2. 回應檔選項清單。

    特性 回應檔項目
    產品安裝目錄 installLocation
    WebSphere Application Server 6.0 版 feature_was6_linux.active
    語言套件 feature_lang_pack_rad_linux.active
    企業產生語言 (EGL) feature_egl_linux.active
    入口網站工具 feature_portal_linux.active
    Eclipse 外掛程式開發的範例 feature_examples_linux.active

    如果要無聲自動安裝任何選用特性,請執行下列動作:

    1. 將 responsefile.txt 複製到新檔案中,如 myresponsefile.txt。
    2. 編輯回應檔的複本。
    3. 找出有上表所顯示安裝特性名稱的行。 比方說,如果您要安裝 Eclipse 外掛程式的開發範例,您會在回應檔中找到下面這一行:

      # -P feature_examples_linux.active=<value>

    4. 將這一行變更如下:
      1. 移除第一直欄中的 #。
      2. <value> 改成 true

      在這個範例中,這一行會改成:

         -P feature_examples_linux.active=true
      
    5. 儲存變更。
    6. 以 root 使用者身分登入。
    7. 如果您還沒有依照"設定本端影像"所說明來複製影像,請執行這個動作。
    8. 從指令行中,切換至上一節所建立的暫時目錄之 /disk1/setup 目錄(如 /tmp/install_image/disk1/setup)。
    9. 當您執行回應檔時,請依照下列範例所示,加入 -options 參數及完整定義的回應檔名稱:
      ./setup.bin -silent -options "Your_directory/myresponsefile.txt"
      

      其中 Your_directory 是回應檔所在的完整目錄名稱。

      註:
      如果要確認正在使用您的回應檔,請先執行不設定 -silent 選項的這個指令(也就是說,在執行無聲自動安裝之前),並確認您的設定登錄在安裝精靈中。 如果沒有登錄它們,就表示回應檔設定或指令語法發生問題。
    10. 無聲自動安裝 Rational Application Developer 可能需要好一會兒才能完成。 如果要確定安裝完成的時間,您可以定期監視安裝目錄中的 /logs 子目錄。如果出現 license.log 檔,就表示無聲自動安裝已經完成。

    增加可用的檔案控點數目

    在使用產品之前,建議使用者要求管理者超出每個程序 1024 個檔案控點的預設限制,提供更多檔案控點給 Rational Application Developer 使用者。

    當在 Linux 中,利用下列步驟來增加檔案描述子時,請特別小心。 如果沒有適當遵循指示,機器可能無法適當啟動。 最好是請系統管理者來執行這個動作。

    如果要增加檔案描述子,請執行下列動作:

    1. 以 root 身分登入。如果您沒有最高存取權,您必須先取得最高存取權,才能繼續作業。
    2. 切換至 etc 目錄。
    3. 利用 vi 編輯器來編輯 etc 目錄中的 initscript 檔。如果這個檔案不存在,請輸入 vi initscript 來建立它。
      註:
      如果您決定要增加檔案控點的數目,請勿將空的 initscript 檔留在機器中,否則,下次會無法啟動機器。
    4. 在第一行中,輸入 ulimit -n 4096(這裡的重點是數目要大於大部分 Linux 機器的預設值 1024)。 小心:請勿將這個值設得太高,因為它可能會嚴重影響系統層面的效能。
    5. 在第二行中,輸入 eval exec "$4"
    6. 確定您已完成第 4 和 5 步驟之後,儲存和關閉檔案。
      註:
      請確定您已正確遵循這些步驟,因為如果沒有正確執行這項作業,機器將無法啟動。
    7. (選用)修改 etc/security 目錄中的 limits.conf 檔來限制使用者或群組。 依預設,SuSE Linux Enterprise Server (SLES) 第 9 版和 Red Hat Enterprise Linux 3.0 版會有這個檔案。 如果您為了某個原因而沒有這個檔案,您可以考慮在第 4 步驟中使用更穩當的數字(如 2048)。 您必須執行這個動作,使大部分使用者在每個程序允許開啟的檔案數目上有合理的低限。 如果您在第 4 步驟中使用相當低的數字,這個動作就比較不重要。 不過,如果您選擇在第 4 步驟中設定較高的數字,沒有執行這個動作就可能會影響機器效能。

      以下是範例 limits.conf 檔的可能外觀,它會限制所有使用者,之後,再設定其他使用者的不同限制。這個範例假設您在上面第 4 步驟中使用 8192。
      * soft nofile 1024
      * hard nofile 2048
      root soft nofile 4096
      root hard nofile 8192
      user1 soft nofile 2048
      user1 hard nofile 2048

      請注意,上述範例中的 * 用來先設定所有使用者的限制。這些限制低於下面的限制。root 使用者允許開啟的描述子數目比較高,user1 在兩者之間。 請務必閱讀和瞭解 limits.conf 檔內所包含的文件,再進行修改。

    如果需要 ulimit 指令的詳細資訊,請參閱 ulimit 的操作說明。


    啟動 Rational Application Developer

    如果要啟動 Rational Application Developer,請遵循下列步驟:

    1. 如果要從指令行啟動 Rational Application Developer,請移至安裝目錄來執行下列指令:./rationalsdp.bin
    2. 如果您在 Gnome(Red Hat 的預設值)中作業,產品捷徑會在主功能表的程式設計 > Rational Software Development Platform 之下。 如果您在 KDE(SuSE 預設值)中作業,產品捷徑就是 IBM Rational > Rational Software Development Platform
    3. 當您第一次啟動 Rational Application Developer 時,會開啟一個對話框,其中已指定預設的工作區目錄。 依預設,您的工作會儲存在 $HOME/IBM/rationalsdp6.0 目錄下名為 workspace 的目錄中。
    4. 依預設,會取消選取請用這個作為預設值,以後不要再問我勾選框。 如果您保留預設值,您每次啟動 Rational Application Developer 時,都會開啟一個對話框,讓您切換工作區。 比方說,如果您選擇不同專案要維護不同的工作區,您可以保留這個預設值。

      要訣:如果選取請利用這個作為預設值,且以後不要再問我勾選框,就不會再開啟這個對話框,Rational Application Developer 會利用上一階段作業的工作區來啟動。您可以在啟動產品之後,在視窗 > 喜好設定 > 工作台 > 啟動和關閉頁面中變更這個預設值。

    工作台首先會開啟一系列的歡迎使用頁面來提供產品概觀和新增功能的相關資訊,以及通往指導教學、範例和外部 Web 資源的鏈結。 請花些時間來探索這些選項。 另外,也請注意「說明」功能表所提供的資訊來源。


    解除安裝 Rational Application Developer

    如果要在 Linux 中解除安裝 Rational Application Developer,請遵循下列步驟:

    1. 以 root 使用者身分登入。
    2. 移至安裝目錄中的 rad_prod/_uninst/ 子目錄。
    3. 輸入下列指令來解除安裝 Rational Application Developer:./uninstall.bin。如果您正在檔案管理員中工作,您可以按一下這個檔案來啟動解除安裝程式。
    4. 任何 plug-ins 或 features 目錄中的所有檔案或特性都會自動刪除,任何這些目錄中的使用者資料和協力廠商外掛程式都包括在內。不會刪除含有您的工作的工作區目錄。 會保留部分其他目錄:

    如果您試圖局部解除安裝一或多項 Rational Application Developer 必要特性,您會收到一則類似下列錯誤訊息:

    選項無效:
    無法解除安裝 ide_required:沒有設定解除安裝的 root
    

    如果要暫時解決這個問題,請選取解除安裝產品勾選框。這會重新起始設定解除安裝畫面,因此,您現在可以解除安裝整個 Rational Application Developer,也可以取消選取您要解除安裝的特性。

    無聲自動解除安裝 Rational Application Developer

    如果要無聲自動解除安裝 Rational Application Developer,請從命令提示字元下進入安裝目錄,然後輸入:

    rad_prod\_uninst\uninstall.bin -silent
    

    已知的問題和限制

    這一節包含在 Linux 中安裝和解除安裝 Rational Application Developer 時,已知的問題和限制。 請參閱 Readme 檔,以取得會影響產品實際用法的問題和限制的相關資訊。

    磁碟限制

    無法安裝 WebSphere Application Server 6.0 版整合測試環境

    如果您在安裝 Rational Application Developer 時選擇安裝 WebSphere Application Server 6.0 版整合測試環境,且安裝失敗,您會見到下列訊息:

    WebSphere Application Server 6.0 版整合測試環境安裝失敗。
    仍會執行 IBM Rational Software Development Platform,
    但無法使用 WebSphere Application Server 6.0 版整合測試環境。
    

    如果需要 WebSphere Application Server 6.0 版疑難排解安裝的相關資訊,請參閱 http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tins_trouble.html

    請注意,依預設,WebSphere Application Server 6.0 版整合測試環境是安裝在 Rational Application Developer 安裝目錄的 /runtimes/base_v6 子目錄中。

    取消安裝合併已安裝的產品後,再嘗試重新安裝可能會無法適當地安裝產品。

    請參閱"取消安裝合併已安裝的產品後,再嘗試重新安裝可能會無法適當地安裝產品。"


    第 6 章 安裝 Agent Controller

    Agent Controller 是一個常駐程式,可讓用戶端應用程式啟動及管理本端或遠端應用程式,並提供執行應用程式的相關資訊給其他應用程式。您必須先個別安裝 Agent Controller,才能使用下列工具:

    附註:


    硬體需求


    支援的平台

    Linux 附註:Agent Controller 的 Hyades Data Collection Engine 特性是利用 libstdc++-libc6.2-2.so.3 共用程式庫來編譯的。 請確定這個共用程式庫存在 /usr/lib 目錄下。如果不存在,您必須安裝作業系統安裝媒體所附的 RPM 套件 compat-libstdc++。

    Agent Controller 已通過下列平台的測試:

    Agent Controller 尚未在下列平台上測試,但應該可以在這些平台上執行:

    Agent Controller 不適用於下列平台:


    支援的 JVM

    一般而言,Agent Controller 可以搭配使用 JVM 1.4 版或更新的版本。 以下是 Agent Controller 已通過測試的 JVM 版本(Java 完整版本):


    尋找安裝檔

    Agent Controller 安裝檔在選用軟體磁碟的下列目錄中:


    在工作站(AIX、HP-UX、Linux、Windows、Solaris)安裝 Agent Controller

    解除安裝舊版 Agent Controller

    如果您有舊版的 Agent Controller 或從 Hyades Data Collection Engine 衍生而來的任何軟體,請先將它停止、解除安裝,以及清除遺留的檔案,之後再安裝這個版本的 Agent Controller。 解除安裝之後可能遺留下列檔案:

    Windows:

    %RASERVER_HOME%\*.*(Agent Controller 的安裝目錄)
    %SystemRoot%\system32\piAgent.dll(Windows 的 system32 目錄)
    %SystemRoot%\system32\LogAgent.dll
    %SystemRoot%\system32\hcbnd.dll
    %SystemRoot%\system32\hcclco.dll
    %SystemRoot%\system32\hccldt.dll
    %SystemRoot%\system32\hccls.dll
    %SystemRoot%\system32\hcclserc.dll
    %SystemRoot%\system32\hcclsert.dll
    %SystemRoot%\system32\hcclsm.dll
    %SystemRoot%\system32\hcjbnd.dll
    %SystemRoot%\system32\hclaunch.dll
    %SystemRoot%\system32\hcthread.dll
    %SystemRoot%\system32\piAgent.dll
    %SystemRoot%\system32\rac.dll
    %SystemRoot%\system32\sysperf.dll
    

    Linux、AIX、HP-UX、Solaris:

    $RASERVER_HOME/*(Agent Controller 的安裝目錄)
    /usr/lib/libpiAgent.so(HP-UX 上的副檔名為 .sl)
    /usr/lib/libLogAgent.so
    /usr/lib/libhcbnd.so
    /usr/lib/libhcclco.so
    /usr/lib/libhccldt.so
    /usr/lib/libhccls.so
    /usr/lib/libhcclserc.so
    /usr/lib/libhcclsert.so
    /usr/lib/libhcclsm.so
    /usr/lib/libhcjbnd.so
    /usr/lib/libhclaunch.so
    /usr/lib/libhcthread.so
    

    安裝 Agent Controller

    1. 以管理者(或 root)身分登入。
    2. 切換至適當平台的安裝媒體所在目錄。
    3. 執行 setup.exe 程式。如果是非 Windows 平台,請執行 setup.bin
    4. 在歡迎畫面上按下一步以繼續。
    5. 繼續進行安裝之前,請先關閉所有的 Eclipse 平台。按下一步以繼續。
    6. 閱讀授權合約。
    7. 選取核准,然後按下一步以繼續。
    8. 這時會通知您將移除任何現有的 Agent Controller。按下一步以繼續。
    9. 指定 Agent Controller 的安裝路徑,再按下一步繼續作業。
    10. 選取您要安裝的 Agent Controller 特性:

      下一步以繼續。

    11. 指定 Agent Controller 應該使用之 Java Runtime Environment (JRE) 執行程式 java.exe 或 java 的路徑。Agent Controller 將使用這裡所輸入的 JRE 來啟動 Java 應用程式。因此,您可以變更安裝程式預先填入的 JRE 路徑。
      註:
      您在這時提供的 JRE 將用來執行 Agent Controller,以及供 Agent Controller 用來啟動 Java 應用程式。不過,您可以稍後將 Agent Controller 配置成使用不同的 JRE 分別處理這兩項功能。如果需要詳細資料,請參閱 Agent Controller 說明主題將應用程式配置成由 Agent Controller 啟動
    12. 選用:如果選取了「WebSphere Application Server 的遠端支援」,請指定 IBM WebSphere Application Server 5.0 版(只限 Windows)和 5.1 版的路徑。
    13. 指定哪些主機可以存取 Agent Controller。其選項如下:

      下一步以繼續。

    14. 如果在前述步驟 9 中選取了「安全」:請選擇安全設定。

      下一步以繼續。

    15. 在摘要畫面上按下一步以繼續。
    16. 在檔案轉送完成後,按一下完成

    無聲自動安裝 Agent Controller

    您可以在安裝指令中使用下列參數來無聲執行安裝程序:


    參數 說明
    必要參數  
    -silent
    
    指示安裝程式以無聲自動方式執行
    -P installLocation
    
    指定安裝路徑
    -W javaHome_win.path
    
    (Windows) 指定 java.exe 執行檔的完整路徑
    -W javaHome_unix.path
    
    (非 Windows)指定 java 執行檔的完整路徑
    -W hostList.type
    
    指定用戶端可以如何連接 Agent Controller(ALL、LOCAL、CUSTOM)
    • ALL:允許任何用戶端
    • LOCAL:只允許本端主機
    • CUSTOM:允許用戶端清單(也需要指定 -W hostList.hosts 參數)
    -W security.type
    
    指定是否應該開啟安全(true、false)
    • true:啟用安全(也需要指定 "-W security.users" 選用參數)
    • false:停用安全
       
    選用參數  
    -W wasHome_win.was510path
    
    (Windows) 指定 IBM WebSphere Application Server 5.1 的安裝位置
    -W wasHome_unix.was510path
    
    (非 Windows)指定 IBM WebSphere Application Server 5.1 的安裝位置
    -W wasHome_win.was500path
    
    (Windows) 指定 IBM WebSphere Application Server 5.0 的安裝位置
    -W wasHome_unix.was500path
    
    (非 Windows)指定 IBM WebSphere Application Server 5.0 的安裝位置
    -W hostList.hosts
    
    指定用戶端主機名稱,以逗點分隔(如果 hostList.type="CUSTOM")
    -W security.users
    
    指定哪些使用者可以連接 Agent Controller(如果 security.type = "true")
    -P hyadesdc_ibm_runtimeAnalysis_feature.active=false
    
    指定不要安裝執行時期分析特性(依預設,無聲自動安裝過程中會安裝這項特性)
    註:
    如果您透過不安全的連線來無聲自動安裝 Agent Controller,請使用 security.type.="false" 參數。

    Windows 範例:

    setup.exe
      -silent
    -P installLocation="D:\IBM\AgentController"
    -W javaHome_win.path="d:\jdk1.4.1\jre\bin\java.exe"
    -W wasHome_win.was510path="d:\WebSphere5.1\AppServer"
    -W wasHome_win.was500path="d:\WebSphere5.0\AppServer"
    -W hostList.type="CUSTOM"
    -W hostList.hosts="host1,host2"
    -W security.type="true"
    -W security.users="user1,user2"
     
    

    非 Windows 範例:

    setup.bin
      -silent
      -P installLocation="/opt/IBM/AgentController"
      -W javaHome_unix.path="/opt/java1.4.1/jre/bin/java"
      -W wasHome_unix.was510path="/opt/WebSphere5.1/AppServer"
      -W wasHome_unix.was500path="/opt/WebSphere5.1/AppServer"
    -W hostList.type="CUSTOM"
    -W hostList.hosts="host1,host2"
    -W security.type="true"
    -W security.users="user1,user2"
     
    

    使用回應檔

    您可以建立回應檔(如 setup.rsp)來儲存上述所有參數,而不必在指令行中指定它們:

    # Start of response file
    -P installLocation="D:\IBM\AgentController"
    -W javaHome_win.path="d:\jdk1.4.1\jre\bin\java.exe"
    -W wasHome_win.was510path="d:\WebSphere5.1\AppServer"
    -W wasHome_win.was500path="d:\WebSphere5.0\AppServer"
    -W hostList.type="CUSTOM"
    -W hostList.hosts="host1,host2"
    -W security.type="true"
    -W security.users="user1,user2"
    # End of response file
    

    如果要利用回應檔進行安裝,請執行下列動作:

    Windows:setup.exe -silent -options d:\temp\setup.rsp

    非 Windows:setup.bin -silent -options /tmp/setup.rsp

    在 Windows 工作站中啟動和停止 Agent Controller

    在非 Windows 工作站中啟動和停止 Agent Controller

    在 Windows 工作站中解除安裝 Agent Controller

    在非 Windows 工作站中解除安裝 Agent Controller

    1. 從安裝位置的 _uninst 目錄(如 /opt/IBM/AgentController/_uninst)中,執行 uninstall.bin 程式。
    2. 遵循畫面中的指示完成解除安裝。
    3. 如果要執行無聲自動解除安裝,請使用 uninstall.bin -silent 指令。

    在 OS/400 (iSeries) 中安裝 Agent Controller

    解除安裝舊版 Agent Controller

    如果您有舊版的 Agent Controller 或從 Hyades Data Collection Engine 衍生而來的任何軟體,請先將它停止和解除安裝,之後再安裝這個版本。

    安裝 Agent Controller

    1. 在 iSeries 主機中,建立一個名稱為 HYADESDC 的程式庫和另一個稱為 IBMRAC 的程式庫:

      CRTLIB HYADESDC
      CRTLIB IBMRAC
      
    2. 在 iSeries 主機的 HYADESDC 程式庫中,建立一個稱為 HYADES400.SAVF 的空保存檔:
      CRTSAVF HYADESDC/HYADESDC
      
    3. 在 iSeries 主機的 IBMRAC 程式庫中,建立一個稱為 IBMRAC.SAVF 的空保存檔:
      CRTSAVF IBMRAC/IBMRAC
      
    4. 在 iSeries 主機的 IBMRTA 程式庫中,建立一個稱為 IBMRTA.SAVF 的空保存檔:
      CRTSAVF IBMRAC/IBMRTA
      
    5. 利用 FTP 將安裝 CD 中的 IBMRAC.SAVF 檔新增至採用 BINARY 模式轉送之 iSeries 主機的 IBMRAC 程式庫中。
    6. 利用 FTP 將安裝 CD 中的 HYADESDC.SAVF 檔新增至採用 BINARY 模式轉送之 iSeries 主機的 HYADESDC 程式庫中。
    7. 利用 FTP 將安裝 CD 中的 IBMRTA.SAVF 檔新增至採用 BINARY 模式轉送之 iSeries 主機的 IBMRAC 程式庫中。
    8. 輸入下列指令,將在 iSeries 主機的保存檔 HYADESDC.SAVF 還原到 HYADESDC 程式庫中:

      RSTOBJ OBJ(*ALL) SAVLIB(HYADESDC) DEV(*SAVF) SAVF(HYADESDC/HYADESDC)
      
    9. 輸入下列指令,將在 iSeries 主機的保存檔 IBMRAC.SAVF 還原到 IBMRAC 程式庫中:

      RSTOBJ OBJ(*ALL) SAVLIB(IBMRAC) DEV(*SAVF) SAVF(IBMRAC/IBMRAC)
      
    10. 輸入下列指令,將在 iSeries 主機的保存檔 IBMRTA.SAVF 還原到 IBMRAC 程式庫中:

      RSTOBJ OBJ(*ALL) SAVLIB(IBMRAC) DEV(*SAVF) SAVF(IBMRAC/IBMRTA)
      
    11. 啟動 QShell,在整合式檔案系統 (IFS) 中建立 /opt/hyadesdc 目錄。
    12. 將 HYADESDC 中的保存檔 HYADESIFS.SAVF 還原到 IFS 目錄 /opt/hyadesdc 中。例如:

      RST DEV('/QSYS.LIB/HYADESDC.LIB/HYADESIFS.FILE') OBJ('/opt/hyadesdc/*')
      
    13. 將 IBMRAC 中的保存檔 IBMRACIFS.SAVF 還原到 IFS 目錄 /opt/hyadesdc 中。比方說,在一行中輸入以下指令:

      RST DEV('/QSYS.LIB/IBMRAC.LIB/IBMRACIFS.FILE') OBJ('/opt/hyadesdc/*') ALWOBJDIF(*ALL)
      
    14. 將 IBMRAC 中的保存檔 IBMRTAIFS.SAVF 還原到 IFS 目錄 /opt/hyadesdc 中。 比方說,在一行中輸入以下指令:

      RST DEV('/QSYS.LIB/IBMRAC.LIB/IBMRTAIFS.FILE') OBJ('/opt/hyadesdc/*') ALWOBJDIF(*ALL)
      
    15. 安裝好 Agent Controller 之後,請將目錄切換至安裝位置的 bin 目錄 /opt/hyades/bin,再輸入下列指令來執行安裝 Script:

      ./SetConfig.sh
      
    16. 遵循畫面中的提示來配置 Agent Controller。

    在 OS/400 (iSeries) 啟動及停止 Agent Controller

    1. 如果要啟動 Agent Controller,請將 HYADESDC 和 IBMRAC 程式庫新增至程式庫清單中:

      ADDLIBLE HYADESDC
      ADDLIBLE IBMRAC
      
    2. 輸入下列指令來送出 RAStart 工作:

      SBMJOB CMD(CALL RASERVER) JOBD(RASTART)
      
    3. 如果要停止 Agent Controller,請輸入下列指令來終止 RAStart 工作:

      ENDJOB JOB(RASTART)
      

    在 OS/400 (iSeries) 解除安裝 Agent Controller

    1. 移除 HYADESDC 和 IBMRAC 程式庫。
    2. 移除 IFS 目錄 /opt/hyadesdc(包括所有子目錄和檔案)。

    在 OS/390 (z/OS) 安裝 Agent Controller

    解除安裝舊版 Agent Controller

    如果您有舊版的 Agent Controller 或從 Hyades Data Collection Engine 衍生而來的任何軟體,請先將它停止和解除安裝,之後再安裝這個版本。

    安裝 Agent Controller

    1. 在 UNIX(R) 系統服務 Shell 中,移至您要安裝 Agent Controller 的目錄。 建議您將它安裝在 /usr/lpp/ 目錄中。
    2. 將安裝影像 ibmrac.os390.pax ibmrta.os390.pax 轉送至安裝目錄。
    3. 發出下列指令來擷取 Agent Controller 檔:

      pax -ppx -rf ibmrac.os390.pax
      
    4. 將目錄切換至安裝目錄 /usr/lpp/IBM/AgentController,再輸入下列指令來解壓縮執行時期分析延伸規格:

      pax -ppx -rf ../../ibmrta.os390.pax
      
    5. 將目錄切換至安裝 bin 目錄 /usr/lpp/IBM/AgentController/bin,再輸入下列指令來執行 makelinks Script:

      ./createLinks.sh
      
    6. 在 UNIX(R) 系統服務 Shell 中發出下列指令來控制 Agent Controller 共用物件檔程式:

      extattr +p /usr/lpp/IBM/AgentController/lib/*.so
      

      extattr +p /usr/lpp/IBM/AgentController/plugins/com.ibm.rational.pd.probekit/lib/*.so
      
    7. 安裝好 Agent Controller 之後,請將目錄切換至安裝位置的 bin 目錄 /usr/lpp/IBM/AgentController/bin,再輸入下列指令來執行安裝 Script:

      ./SetConfig.sh
      
    8. 遵循畫面中的提示來配置 Agent Controller。

    z/OS 中的資料通道用法:

    如果要在 serviceconfig.xml 檔中設定大的 dataChannelSize,您可能需要增加機器中的共用記憶體區段大小上限設定。 如果要這麼做,請增加 BPXPRMxx parmlib 中的 IPCSHMMPAGES 值。 這個值是資料通道所能採用的 4K 頁數上限。 比方說,如果您要將 dataChannelSize 設為 32M,您必須將 IPCSHMMPAGES 值設為大於 8192。

    如果要讓 Agent Controller 同時與大量代理程式通訊,您必須將 BPXPRMxx parmlib 成員中的 IPCSHMNSEGS 值設為適當的值。 這個值指定每個位址空間所連接的共用記憶體區段數上限。 預設值是 10,因此,您應該將這個值增加至 50。

    如果需要 Agent Controller 使用的資料通道的詳細資訊,請參閱 Agent Controller 的線上說明資訊。

    如果需要 z/OS BPXPRMXX parmlib 成員及如何更新它們的詳細資訊,請參閱 IBM z/OS MVS(TM) Initialization and Tuning Reference

    在 OS/390 (z/OS) 中啟動和停止 Agent Controller

    附註:RAServer 需要將包含執行檔程式庫(例如 libjvm.so)的 JRE 目錄新增至 LIBPATH 環境變數中。比方說,如果您使用 IBM JRE 1.4.1,LIBPATH 變數會設定如下:

    export LIBPATH=/usr/lpp/java/IBM/J1.4/bin/classic:/usr/lpp/java/IBM/J1.4/bin:$LIBPATH
    

    在 OS/390 (z/OS) 中解除安裝 Agent Controller


    使用 Agent Controller 安全特性

    下列清單包含在所有平台中使用 Agent Controller 安全特性的提示和要訣:


    已知的問題和限制

    這一節討論關於安裝和解除安裝 Agent Controller 的已知問題和限制。除非另有說明,否則,下列資訊適用於支援使用 Agent Controller 的所有作業系統。

    Agent Controller 可能無法在非 Windows 平台中啟動

    Agent Controller 可能無法在非 Windows 平台中啟動,且會出現下列訊息:

    無法啟動 RAServer。
    

    這個失敗通常是在 TCP/IP 埠 10002 無法使用時造成的。 依預設,Agent Controller 會利用這個埠來接聽。 可能是 Agent Controller 啟動時,系統中所執行的其他程序正在使用這個埠,也可能是 Agent Controller 剛停止, 又在埠釋出之前重新啟動。

    如果 Agent Controller 無法啟動,您可以依照下列方式來啟動它:

    安裝和解除安裝期間發生其他錯誤

    如果您在安裝或解除安裝期間發生錯誤,這可能是因為執行中的程序已載入 Agent Controller 的物件檔。 如果要確保這些物件檔是可修改的,請執行下列動作:

    1. 關閉 Rational Application Developer。
    2. 終止所有含 Java 側寫代理程式或 J2EE 要求側寫程式的 java.exe 程序。

    第 7 章 設定 Rational Application Developer 在團隊環境中工作

    依預設,Rational Application Developer 會自動安裝 Rational ClearCase SCM 配接器外掛程式,以支援利用 Rational ClearCase 作為您的軟體配置管理 (SCM) 系統。 如果需要 Rational ClearCase 的詳細資訊,請參閱 www.ibm.com/software/awdtools/clearcase/

    Rational Application Developer 也會自動安裝並行版本系統 (CVS) 外掛程式來支援利用 CVS 作為您的 CSM 系統。您可以從下列網站取得 CVS 伺服器最新的版本:www.cvshome.org。您不需要安裝 CVS 用戶端來使用 CVS,只要安裝 CVS 伺服器就行了。 如果需要安裝和使用 CVS 的詳細資訊,請參閱團隊線上說明。

    Rational ClearCase SCM 配接器和 CVS 外掛程式都必須先啟用,之後才能使用。 如果要啟用外掛程式,請執行下列動作:

    1. 從 Rational Application Developer 功能表中,選取視窗 > 喜好設定
    2. 在「喜好設定」頁面的「工作台」下,按一下功能
    3. 在「功能」視窗中,捲至團隊,再按一下您想啟用之配接器的勾選框。
    4. 按一下套用,再按一下確定

    當共用專案時,您也可以選取所需要的團隊儲存庫提供者來啟用外掛程式。

    不管是 Rational ClearCase 用戶端或伺服器,還是 CVS 伺服器都不會自動安裝。您必須在 Rational Application Developer 之外,個別安裝它們。

    如果需要安裝 ClearCase LT 用戶端的詳細資訊,請參閱"安裝 Rational ClearCase LT"

    如果要搭配其他可用的 SCM 系統來使用 Rational Application Developer,您會需要 SCM 產品的特定配接器。SCM 配接器通常是由 SCM 產品供應商提供。IBM 不為其他 SCM 配接器提供任何保證或背書。 如果需要其他 SCM 產品之配接器的支援或進一步的資訊,請直接洽詢產品供應商。


    支援的軟體

    IBM Rational ClearCase

    Rational ClearCase SCM 配接器需要至少含有下表所列出的必要基本修補程式的 ClearCase v2002 或更新的版本(完整的 ClearCase 或 ClearCase LT):


    表 3. Windows

    必要的 ClearCase 版本和基本修補程式
    IBM Rational ClearCase v2002.05.00 和 p2002.05.00.NT-32
    IBM Rational ClearCase LT v2002.05.00 和 clearcase_lt_p2002.05.00.NT-11
    IBM Rational ClearCase v2003.06.13
    IBM Rational ClearCase LT v2003.06.13


    表 4. Linux

    必要的 ClearCase 版本和基本修補程式
    IBM Rational ClearCase v2002.05.00 和 clearcase_p2002.05.00-38
    IBM Rational ClearCase LTv2002.05.00 和 clearcase_lt_p2002.05.00-17
    IBM Rational ClearCase v2003.06.00 和 clearcase_p2003.06.00-11
    IBM Rational ClearCase LT v2003.06.00 和 clearcase_lt_p2003.06.00-6

    小心: 安裝好 Rational ClearCase(或 ClearCase LT)和 Rational Application Developer 之後,您必須確定您的 ClearCase 用戶端和伺服器環境已利用最新的適當修補程式更新過。 您需要這個修補程式,才能提供比較及合併統一建模語言 (UML) 圖檔的適當支援。 當使用 Rational Application Developer 時,如果您未以最新的適當修補程式來更新 Rational ClearCase(或 ClearCase LT),當比較及合併 UML 圖檔時,模型可能會毀損。

    如果要取得 Rational ClearCase 版本和修補程式,請造訪 www.ibm.com/software/awdtools/clearcase/support/index.html 或電洽 IBM Rational 支援中心:1-800-IBM-SERV (1-800-426-7378)。

    IBM Rational ClearQuest

    Rational Application Developer 支援下列 Rational ClearQuest(R) 版本:

    Rational ClearQuest 是一個很靈活的問題和變更追蹤系統,它將送出、指派、追蹤、測試和釋出變更要求時所涉及的程序組織起來,且會自動執行它們。 如果需要 Rational ClearQuest 的詳細資訊,請造訪 www.ibm.com/software/awdtools/clearquest/。Rational ClearQuest Client for Eclipse 提供了 ClearQuest 和 Eclipse 平台之間的緊密整合,Rational Software Development Platform 也包括在內。

    如果要使用 Rational ClearQuest Client for Eclipse,您必須先執行下列動作:

    請造訪 www.ibm.com/support/docview.wss?uid=swg24007802,以取得下載 Rational ClearQuest Client for Eclipse 的相關資訊。請參閱這個 URL 所提供的 Readme 檔來取得完整的安裝指示。


    安裝 Rational ClearCase LT

    下載 Rational ClearCase LT

    Rational ClearCase LT 是小型專案團隊的配置管理工具。 ClearCase LT 是 IBM Rational ClearCase 產品系列的一部分,從小型專案工作群組至分散式全球企業都在其範圍內。

    您購買的 IBM Rational Software Development Platform 產品授予您 Rational ClearCase LT 的免費授權。

    如果您沒有 ClearCase LT 產品媒體, 您必須下載和安裝 ClearCase LT 的最新支援版本。

    如果您已有 ClearCase LT v2002.05 或 ClearCase LT v2003.06 產品媒體,您必須下載和安裝最新的 ClearCase LT 修補程式來支援與 IBM Rational Software Development Platform 產品的 ClearCase LT 整合。

    如果需要如何取得 ClearCase LT 的最新支援版本及 IBM Rational Software Development Platform 所支援的最新的必備修補程式的指示, 請移至 IBM Rational Support Technote 編號 1188585:www.ibm.com/support/docview.wss?uid=swg21188585。 或者,請移至 www.ibm.com,並在「搜尋」框中輸入 1188585。

    尋找版本注意事項和安裝指示

    在安裝 Rational ClearCase LT 之前,建議您閱讀產品的版本注意事項和安裝文件。請造訪 IBM Publications Center,以在線上取得這份文件,網址如下:www.ibm.com/shop/publications/order。您也可以參照 www.ibm.com/software/rational/support/documentation/。 如果要開啟 Acrobat PDF 檔,您必須已安裝 Adobe Reader 軟體,您可以從 www.adobe.com/products/acrobat/readstep2.html 下載它。

    Windows 請從 IBM Publications Center 下載最新的 IBM Rational ClearCase LT Release Notes for Windows 以及 Rational Software Desktop Products Installation GuideRational Software Server Products Installation Guide for Windows,如下所示:

    1. 在 Publications Center 的 Welcome 頁面選取您的國家/地區。
    2. 按一下 "Search for Publications" 鏈結。這時會開啟 Quick Publications Center 搜尋頁面。
    3. 若要下載 Rational Software Desktop Products Installation Guide for Windows 2003.06.13 版,請執行下列動作:
      1. 在「出版品號碼」欄位中輸入 S126-5304-01,然後按 Enter 鍵。
      2. 在產生的頁面中,選擇您偏好的下載文件方法。
    4. 若要下載 Rational Software Server Products Installation Guide for Windows 2003.06.13 版,請執行下列動作:
      1. 在「出版品號碼」欄位中輸入 S126-5300-01,然後按 Enter 鍵。
      2. 在產生的頁面中,選擇您偏好的下載文件方法。
    5. 若要下載 Rational ClearCase LT Release Notes for Windows,請執行下列動作:
      1. 在「出版品號碼」欄位中輸入 GI11-4669-03,然後按 Enter 鍵。
      2. 在產生的頁面中,選擇您偏好的下載文件方法。

    Linux 請從 IBM Publications Center 下載最新的 Rational ClearCase LT Release Notes 以及 Rational ClearCase LT Installation Guide for Linux,如下所示:

    1. 在 Publications Center 的 Welcome 頁面選取您的國家/地區。
    2. 按一下 "Search for Publications" 鏈結。這時會開啟 Quick Publications Center 搜尋頁面。
    3. 若要下載 UNIX 版的 ClearCase LT Installation Guide 2003.06.00 版和更新的版本,請執行下列動作:
      1. 在「出版品號碼」欄位中輸入 S126-5310-00,然後按 Enter 鍵。
      2. 在產生的頁面中,選擇您偏好的下載文件方法。
    4. 若要下載 Rational ClearCase LT Release Notes for UNIX,請執行下列動作:
      1. 在「出版品號碼」欄位中輸入 GI11-6232-00,然後按 Enter 鍵。
      2. 在產生的頁面中,選擇您偏好的下載文件方法。

    安裝 Rational ClearCase LT

    這一節的安裝指示協助您安裝 Rational ClearCase LT 的用戶端和伺服器程式碼。 當安裝產品時,您應該參閱 Rational ClearCase LT Installation Guide 中的完整安裝指示。

    如果要瞭解最新版 Rational ClearCase LT 的變更,請參閱 Rational ClearCase LT Release Notes。請參閱前文,以取得如何尋找 Windows 和 Linux 之版本注意事項的指示。

    如果您是在日文系統上安裝 ClearCase LT,請參閱 Rational ClearCase LT Release Notes 中的 "Guidelines for Using ClearCase on Japanese Systems" 一節。

    在 Windows 中安裝 Rational ClearCase LT

    1. 請參閱 ClearCase LT Desktop Products Installation Guide,以取得如何準備安裝產品的詳細資料。
    2. 從已下載的安裝影像的根目錄中,執行 setup.exe。
    3. 這時會開啟 Rational 安裝精靈。按下一步以繼續。
    4. 在「選取產品」畫面中,選取 Rational ClearCase LT
    5. 選擇下列其中一個安裝和配置的部署方法: 請參閱 Desktop Products Installation Guide,以瞭解如何選取部署類型。
    6. 如果是企業部署,請執行下列動作:

      1. 遵循對話框中的指示來完成配置程序。
      2. 完成所有配置步驟之後,選取完成
    7. 如果是從 CD 影像進行桌面安裝,請執行下列動作:
      1. 選取安裝用戶端和伺服器軟體,或只安裝用戶端軟體。按下一步以繼續。
      2. 這時會開啟安裝精靈。請按「下一步」,繼續作業。
      3. 在下一畫面中,將會出現下列訊息:「這次安裝有某些特定產品警告:請停止!繼續執行安裝程序之前,請先關閉所有應用程式並停用防毒軟體。」 依照指示,在繼續安裝程序之前,請參閱警告訊息所提供的 URL (http://ibm.com/support/docview.wss?rs=203&context=SW000&q1=1135295&uid=swg21135295)。請閱讀文件,採取防止系統毀損的任何必要步驟,再繼續安裝。按下一步以繼續。
    8. 遵循畫面指示來完成配置程序。 依預設,Rational ClearCase LT 會安裝在 system_drive:\Program Files\Rational\ 目錄中。 完成配置步驟之後,請選取完成
    9. 選取安裝來開始安裝。

    在 Linux 中安裝 Rational ClearCase LT

    ClearCase LT 目前不支援 Unicode 語言環境,因此您必須將語言環境明確設為非 Unicode 設定,ClearCase LT 才能正確運作。Red Hat Enterprise 依預設,Linux 3.0 和 SuSE Linux Enterprise Server (SLES) 第 9 版會將語言環境設為 Unicode 語言環境(US 安裝架構為 en_US.UTF-8),國際安裝架構也可能如此。 如果您是在這些平台之一執行 ClearCase,您可以依下列方式變更語言環境設定:

    若要在 Linux 安裝 Rational ClearCase LT 2003.06.00 版,請執行下列動作:

    1. 輸入下列指令,以 root 使用者身分登入:su
    2. 從您下載 Rational ClearCase LT 的目錄中,將 ClearCase LT 下載檔的內容解壓縮到釋放區中,如下所示:

      1. 輸入指令 mkdir /usr/ccase_lt_rls 來建立釋放區目錄。請注意,以下的指示假設您使用了 /usr/ccase_lt_rls 作為釋放目錄。如果您指定了不同的名稱,您需要使用它來取代 /usr/ccase_lt_rls。
      2. 執行指令 uncompress <cclt_filename.Z>,其中 <cclt_filename.Z> 是已壓縮之 ClearCase LT 下載 tar 檔的名稱。產生檔案的副檔名是為 .tar 而非 .tar.Z。比方說,如果檔案的名稱為 C54UANA.tar.Z,則指令 uncompress C54UANA.tar.Z 會產生名稱為 C54UANA.tar 的檔案。
      3. 輸入指令 tar xvf <cclt_filename> -C /usr/ccase_lt_rls 將 tar 檔展開到釋放區目錄,其中 <cclt_filename> 是未經壓縮之 ClearCase LT tar 檔的名稱。

      註:
      解壓縮的檔案包括產品文件。 請先參閱版本注意事項ClearCase LT 安裝手冊,再繼續進行安裝程序。
      如果需要釋放區用途的說明,請參閱 ClearCase LT 安裝手冊
    3. 執行 site_prep 準備您的釋放區,然後遵循下列指示:


      cd /usr/ccase_lt_rls/rational_clearcase_lt/rhat_x86/clearcase/install
      ./site_prep

    4. 根據您的每一需求,輸入提示畫面的值。當系統提示您提供 ClearCase LT 授權主機時,請指定機器的主機名稱。請參閱 Rational ClearCase LT 安裝手冊,以取得執行 site_prep 的其他詳細資料。
    5. 執行 install_release 來安裝 ClearCase,再遵循指示:


      ./install_release
      根據您的每一需求,輸入提示畫面的值。以下是 SuSE Linux Enterprise Server (SLES) 第 9 版上 ClearCase LT Client 安裝架構的範例。

      1. 選擇「本端安裝」。
      2. 接受軟體合約。
      3. 選擇「標準安裝」。
      4. 選擇「3. ClearCase LT Client 安裝架構」。
      5. install_release 程式結束時,應該會顯示已完成且沒有錯誤的訊息。該訊息也會提供日誌檔的位置和名稱。
      請參閱 Rational ClearCase LT 安裝手冊,以取得執行 install_release 的其他詳細資料。
    6. 將 ClearCase 執行檔新增至搜尋路徑中。

      比方說,如果您正在使用 Bourne Shell,則可以執行下列指令來修改您的路徑:
      PATH=${PATH}:/opt/rational/clearcase/bin
      export PATH

      請參閱安裝手冊,以取得詳細指示,以及自訂 ClearCase LT 之用戶端主機環境的其他資訊。

    7. 如果您尚未安裝 Rational Application Developer,請在這時安裝它。
    8. 如果要確認 ClearCase 已正確安裝,請利用非 root 使用者 ID 執行下列指令。 如果指令順利完成,主機便能取得 ClearCase LT 授權。 如果傳回錯誤訊息,請參閱 ClearCase LT 文件。


      cleartool hostinfo -long

    9. 啟動 Rational Development 平台,並確定您可以連接 ClearCase。
    註:
    依預設,釋放區就是解壓縮安裝檔的位置,其中包括解除安裝程式的檔案。 如果您刪除這個目錄,您將無法執行解除安裝程式。

    配置 Rational ClearCase LT 授權

    當您將 Rational Application Developer 和 Rational ClearCase LT 安裝在同一台電腦之後,您就不需要配置 Rational ClearCase LT 授權。 不過,如果您安裝 Rational ClearCase LT 但未安裝 Rational Application Developer,您就需要配置 ClearCase LT 授權。 如果需要如何配置授權的詳細資料,請參閱 ClearCase LT 安裝手冊。

    Rational Application Developer 所附的 Rational ClearCase LT 授權並包含 Rational ClearCase Web 介面的授權。 如果您要使用 Rational ClearCase Web 介面,您必須向 IBM Rational Software 購買其他 Rational ClearCase 或 ClearCase LT 授權。 如果需要取得授權的詳細資訊,請電洽 IBM Rational 支援中心:1-800-IBM-SERV (1-800-426-7378)。


    搭配 Rational Application Developer 使用 Rational ClearCase

    如果需要使用 Rational ClearCase 的相關資訊,請參閱 ClearCase 線上說明。


    更正預先存在的圖解元素類型

    如果在依照上述說明來修補或設定環境之前,圖檔已移入 ClearCase 環境的版本化物件庫 (VOB) 中,請執行下列指令來變更 VOB 中之元素的檔案類型,使它們能夠適當地合併:

    cleartool find . -name *.emx -exec 『cleartool chtype -force xtools2 %CLEARCASE_PN%』
    

    解除安裝 Rational ClearCase LT

    Windows 要在 Windows 中解除安裝 Rational ClearCase LT,請執行下列動作:

    1. 關閉 Rational Application Developer。
    2. 開啟「控制台」,然後開啟「新增/移除程式」視窗。請選取 Rational ClearCase LT,按一下變更/移除來解除安裝。
    3. 遵循精靈中的指示來解除安裝產品。

    Linux 要在 Linux 中解除安裝 Rational ClearCase LT:

    1. 輸入下列指令,以 root 使用者身分登入:su
    2. 從釋放區目錄執行 install_release。 比方說,如果釋放區在 /usr/ccase_lt_rls 目錄,請輸入:

        cd /usr/ccase_lt_rls/rhat_x86/clearcase/install
      ./install_release
      
    3. 選取本端解除安裝來移除本端電腦中的軟體。

    第 8 章 將 WebSphere Application Server 5.x 安裝成整合測試環境

    依預設,WebSphere Application Server 6.0 會隨著 Rational Application Developer 而自動安裝。如果您要開發在 5.x 應用程式伺服器中執行的應用程式,您可以選擇性地安裝其他執行時期測試環境。

    您必須先安裝 Rational Application Developer,之後,才能安裝其他執行時期測試環境。

    您可以選擇安裝下列整合測試環境:

    如果要安裝一或多種舊版整合測試環境,請遵循下列步驟:

    1. 從 Rational Application Developer 啟動程式中,按一下安裝 WebSphere 測試環境 5.x 版。這時會開啟 IBM Rational 5.x 整合測試環境安裝程式。
    2. 下一步
    3. 接受授權合約,然後按下一步
    4. 選取您要安裝的整合測試環境。按下一步
    5. 檢視摘要資訊,然後按下一步開始安裝。這項摘要安裝會包括測試環境的安裝位置。
    6. 安裝好之後,按一下完成以結束安裝程式。
    註:
    如果您安裝內嵌傳訊和佇列作業支援特性,您必須先解除安裝內嵌傳訊和佇列作業特性, 才能解除安裝 WebSphere 5.x 版測試環境。



    若要在 Windows 解除安裝 5.x 版測試環境,請遵循下列步驟:

    1. 開啟控制台。
    2. 按一下新增/移除程式
    3. 按一下 IBM Rational 5.x 舊式整合測試環境,再按一下變更/移除
    4. 這時會開啟 IBM Rational 5.x 測試環境解除安裝程式。按下一步
    5. 選取您要解除安裝的測試環境,按下一步
    6. 檢視摘要資訊,按下一步
    7. 解除安裝好測試環境之後,按一下完成來結束解除安裝程式。


    Linux
    若要在 Linux解除安裝舊式測試環境,請遵循下列步驟:

    1. 以 root 使用者身分登入。
    2. 移至安裝目錄中的 lte_prod/_uninst 子目錄。
    3. 輸入下列指令來解除安裝 5.x 版測試環境:./uninstall.bin。 如果您正在檔案管理員中工作,您可以按一下這個檔案來啟動解除安裝程式。
    4. 這時會開啟 IBM Rational 5.x 測試環境解除安裝程式。按下一步
    5. 選取您要解除安裝的測試環境,按下一步
    6. 檢視摘要資訊,按下一步
    7. 解除安裝好測試環境之後,按一下完成來結束解除安裝程式。

    第 9 章 安裝 WebSphere 5.x 版測試環境的傳訊和佇列作業支援

    重要事項:您必須先安裝 Rational Application Developer 和 WebSphere 5.x 版測試環境,才能安裝傳訊和佇列作業支援特性。

    如果下列中的任何條件是 true,您不需要安裝這項特性:

    如果您要在 WebSphere 5.x 版測試環境中(這些單元測試環境內含在 Rational Application Developer 中),利用內嵌傳訊來測試 JMS 應用程式,您必須安裝這項產品內含的其他傳訊功能。這是 IBM WebSphere V5.x Application Server 所提供的相同內嵌傳訊特性。您只需要從 Rational Application Developer 或 WebSphere Application Server 5.x 版安裝內嵌傳訊特性。若安裝兩種版本,則會以後來的安裝改寫先前的安裝。

    您至少需要 200 MB 的磁碟空間才能順利安裝傳訊和佇列作業特性。


    在 Windows 中安裝及解除安裝傳訊和佇列作業支援

    當您從 Rational Application Developer 安裝 CD 中安裝傳訊和佇列作業支援時,也會同時安裝 WebSphere MQ 以及WebSphere 傳訊發佈和訂閱。

    限制:

    即使沒有安裝傳訊和佇列作業支援,您啟動伺服器時,仍可能出現「只安裝 Embedded Messaging Client」訊息。 這則訊息是指 Java 開發人員專用 MQ 模擬器的內建用戶端程式碼,而不是傳訊和佇列作業支援程式碼。 您可以放心忽略這個訊息。

    從 CD-ROM 安裝

    若要安裝內嵌傳訊特性與 WebSphere 5.x 版測試環境一起使用,請執行下列動作:

    1. 如果已啟動 Rational Application Developer,請將它停止。
    2. 插入 Rational Application Developer 安裝 CD。
    3. 如果系統停用了自動執行功能,請從安裝 CD 的根目錄執行 launchpad.exe。
    4. 從「安裝啟動程式」視窗中,選取安裝內嵌傳訊用戶端和伺服器,再遵循畫面中的指示。如果尚未安裝 5.x 版測試執行時期環境,安裝不會繼續進行。

      預設目標安裝目錄為 system_drive:\Program Files\IBM\WebSphere MQ\(其中 system_drive 是安裝 Windows 的硬碟機)。

    5. 當安裝好傳訊和佇列作業支援時,請按一下完成來關閉安裝視窗。
    6. 如果要確認安裝已順利完成,請執行下列動作:

    呼叫無聲自動安裝

    如果要無聲自動安裝內嵌傳訊特性,請執行下列動作:

    1. 如果已啟動 Rational Application Developer,請將它停止。
    2. 插入內嵌傳訊用戶端安裝 CD。
    3. 從安裝 CD 的 IBM_Embedded_MQ 目錄下,在單行中輸入下列指令:
      java -cp setup.jar -Dis.media.home="<cd_rom>\IBM_Embedded_MQ\setup"
       -Dis.external.home="<cd_rom>\IBM_Embedded_MQ" run -silent
      

      其中 cd_rom 是 CD-ROM 的磁碟機字母。 接著按 Enter 鍵。

      註:
      當執行 Windows 傳訊和佇列作業支援的無聲自動安裝時,安裝程式不會在安裝完成時通知您。 如果要更正這個問題,請在指令行中輸入下列指令之一:
       RA_installdir\runtimes\base_v5\java\bin\java -cp setup.jar 
      

       RA_installdir\runtimes\base_v51\java\bin\java -cp setup.jar 
      

      其中 RA_installdir 是 Rational Application Developer 的安裝目錄

    4. 如果要確認安裝已順利完成,請執行下列動作:

    解除安裝傳訊和佇列作業支援

    限制:WebSphere 5.x 版測試環境必須存在且未解除安裝,才能解除安裝內嵌傳訊和佇列作業特性。解除安裝內嵌傳訊和佇列作業特性會移除所有 MQ 使用者資料。

    如果要解除安裝內嵌傳訊特性,請執行下列動作:

    1. 如果已啟動 Rational Application Developer,請將它停止。
    2. 從「新增/移除程式」視窗中,選取內嵌傳訊用戶端和伺服器,再按一下移除
    3. 遵循畫面中的指示來移除內嵌傳訊特性。

    在 Linux 安裝及解除安裝傳訊和佇列作業支援

    當您從 Rational Application Developer 安裝 CD 中安裝傳訊和佇列作業支援時,也會同時安裝 WebSphere MQ 以及WebSphere 傳訊發佈和訂閱。

    限制:

    即使沒有安裝傳訊和佇列作業支援,您啟動伺服器時,仍可能出現「只安裝 Embedded Messaging Client」訊息。 這個訊息是指 Java 開發人員專用 MQ 模擬器的內建用戶端程式碼,而不是傳訊和佇列作業支援程式碼。 您可以放心忽略這個訊息。

    安裝傳訊和佇列作業支援

    如果是第一次將傳訊和佇列作業支援安裝在機器中,請依照下一節所說明來設定使用者群組。

    設定使用者群組

    在第一次安裝傳訊和佇列作業支援之前,您必須先建立兩個使用者群組(mqm 和 mqbrkrs),再新增預設使用者至每個群組中,再新增 root 至每個群組中:

    1. 以 root 使用者身分登入。
    2. 在終端機視窗中,輸入下列指令來建立 mqm 使用者群組:
      groupadd mqm
      
    3. 建立 mqbrkrs 使用者群組:
      groupadd mqbrkrs
      
    4. 以預設群組 mqm 建立使用者 ID mqm:
      useradd mqm -g mqm
      
    5. 以預設群組 mqbrkrs 建立使用者 ID mqbrkrs:
      useradd mqbrkrs -g mqbrkrs
      
    6. 將 root 使用者和要執行 JMS 應用程式的非 root 使用者加入 mqm 和 mqbrkrs 使用者群組:
      1. 編輯 /etc/group 檔。
      2. 找出 mqm 群組行。(如 mqm:x:101:mqm。在您的 etc/group 檔中,這一行可能會稍有不同)。 請加入 'root' 延伸來編輯這一行。 在這個範例中,它會是 mqm:x:101:mqm,root
      3. 找出 mqbrkrs 群組行。比方說,mqbrkrs:x:102:mqm。 在您的 etc/group 檔中,這一行可能會稍有不同。 請加入 'root' 延伸來編輯這一行。 在這個範例中,它會是 mqbrkrs:x:102:mqm,root
      4. 關閉檔案並儲存變更。
      5. 登出。

    安裝內嵌傳訊特性

    如果要安裝內嵌傳訊特性,請執行下列動作:

    1. 以 root 使用者身分登入。
    2. 如果已啟動 Rational Application Developer,請將它停止。
    3. 將 Rational Application Developer 安裝 CD 插入 CD-ROM 中。
    4. 如果沒有裝載 CD-ROM,請輸入下列指令來裝載它:
      mount CD_device
      

      其中 CD_device 的預設值是 /cdrom (SuSE) 和 /mnt/cdrom (Red Hat)。

    5. 如果要顯示「安裝啟動程式」視窗,請輸入:
      CD_device/launchpad.bin
      
    6. 選取內嵌傳訊用戶端和伺服器
    7. 這時會要求您插入內嵌傳訊用戶端和伺服器的 Rational Application Developer 安裝 CD。
    8. 遵循畫面中的指示。預設目標安裝目錄是 /opt/IBM/WebSphereMQ。
    9. 當安裝好傳訊和佇列作業支援時,請按一下完成來關閉安裝視窗。
    10. 如果要確認安裝已順利完成,請執行下列動作:

    呼叫無聲自動安裝

    如果要無聲自動安裝內嵌傳訊特性,請執行下列動作:

    1. 如果已啟動 Rational Application Developer,請將它停止。
    2. 如果您是第一次安裝 5.x 版測試環境的傳訊和佇列作業支援,請完成"設定使用者群組"中說明的步驟。
    3. 插入 Rational Application Developer 安裝 CD。
    4. 從內嵌傳訊用戶端安裝 CD 的 IBM_Embedded_MQ 目錄中,在單行中輸入下列指令:
      ./setup.bin -silent 
      
    5. 如果要確認安裝已順利完成,請執行下列動作:

    解除安裝傳訊和佇列作業支援

    限制:WebSphere 5.x 版測試環境必須存在且未解除安裝,才能解除安裝內嵌傳訊和佇列作業特性。解除安裝內嵌傳訊和佇列作業特性會移除所有 MQ 使用者資料。

    如果要解除安裝傳訊和佇列特性,請執行下列動作:

    1. 以 root 使用者身分登入。
    2. 移至安裝目錄(如 /opt/IBM/WebSphereMQ)。
    3. 輸入:
      ./_uninst/uninstaller.bin
      

    如果解除安裝傳訊和佇列作業支援失敗,請檢查日誌檔 (/tmp/EmbeddedMQ.log)。


    第 10 章 安裝 WebSphere Portal 測試環境 5.0 版

    「WebSphere Portal 測試環境」可讓您從工作台測試入口網站應用程式。它只適用於 Windows。

    您必須已安裝下列硬體,才能安裝 WebSphere Portal 測試環境:

    所有其他需求都和先前針對 Rational Application Developer 敘述的需求相同。

    如果要安裝入口網站測試環境,請遵循下列步驟:

    1. 如果您已安裝 WebSphere Application Server、WebSphere Portal、WebSphere Application Server 整合測試環境或 WebSphere Portal 整合測試環境,請確定它們全部已經停止,且務必停止任何 HTTP 伺服器。 否則,安裝可能會失敗。
    2. 從 Rational Application Developer 安裝啟動程式中,按一下安裝 WebSphere Portal 5.0 版測試環境。 這時會開啟「WebSphere Portal 測試環境」安裝程式。
    3. 下一步
    4. 接受授權合約,然後按下一步
    5. 這時入口網站測試環境會自動安裝在 Rational Application Developer 安裝目錄中。按下一步
    6. 在入口網站測試環境安裝好之後,按一下完成來結束精靈。

    使用 DB2(R) 或 Oracle 資料庫作為 WebSphere Portal 配置儲存庫

    依預設,WebSphere Portal 5.0 版測試環境會安裝及使用 Cloudscape(TM) 資料庫,來儲存用來存取入口網站資源之使用者身分、認證和許可權的相關資訊。Cloudscape 是一個 WebSphere Portal 內建 Java 資料庫,其非常適用於基本的入口網站環境。

    如果要安裝和配置 DB2 或 Oracle 資料庫,請參閱 WebSphere Portal 5.0.2 版 InfoCenter,網址如下:www.ibm.com/websphere/portal/library。您可以在 WebSphere Portal 5.0.2 版 InfoCenter 的「安裝 > 資料庫」之下找到指示。 在開始利用 DB2 或 Oracle 來配置 WebSphere Portal 的步驟之前,請注意,您必須將目錄切換至 Rational Application Developer 安裝目錄的 \runtimes\portal_base_v5\config 子目錄,再執行下列指令:

    WPSconfig.bat wpcpconfigure
    

    請注意,當參閱 InfoCenter 中的配置指示時,InfoCenter 中的 <wp_root> 對應於 Rational Application Developer 安裝目錄的 \runtimes\portal_v50 子目錄, <was_root> 對應於 Rational Application Developer 安裝目錄的 \runtimes\portal_base_v5 子目錄。 為了驗證資料庫連線,您會建立 WebSphere Portal 5.0 測試環境並啟動伺服器,而不是遵循 InfoCenter 所述的步驟。

    解除安裝 WebSphere Portal 測試環境 5.0

    如果要解除安裝,請遵循下列步驟:

    1. 開啟控制台
    2. 按一下新增/移除程式
    3. 選取 WebSphere Portal 5.0 版測試環境,再按一下變更/移除按鈕。
    4. 遵循畫面中的指示來解除安裝入口網站測試環境。

    在某些情況下(如安裝程序中止),解除安裝程式可能不是完整且可運作的程式。在這些情況下,請利用下列程序來手動解除安裝:

    1. 在命令提示字元之下,呼叫 regedit.exe 來編輯 Windows 系統登錄。

      請小心處理登錄:利用 regedit.exe 編輯器來檢視和編輯登錄內容時,很容易出錯。 編輯器不會發出編輯錯誤的警告,因此可能非常危險。 登錄毀損可能會破壞您的系統,使您不得不重新安裝 Windows 作業系統。

      1. 展開和選取 HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere Portal Server\5.0.0.0 機碼。
      2. 按一下功能表列中的編輯 > 刪除來刪除這個機碼。
      3. 當系統詢問您是否確認刪除這個機碼時,請按一下
      4. 完成之後,請按一下功能表列中的登錄 > 結束
    2. <rational_installdir>\runtimes 目錄中刪除下列目錄,包括任何子目錄:
      1. portal_base_v5
      2. portal_v50

      其中 <rational_installdir> 是 Rational Application Developer 的安裝目錄。


    第 11 章 安裝 WebSphere Portal 測試環境 5.1 版

    入口網站測試環境可讓您從工作台測試入口網站應用程式。5.1 版提供了 5.0 版所沒有的新功能,Rational Application Developer 的所有支援的 Windows 環境都支援這些新功能。Red Hat Enterprise Linux Workstation 3.0 版也支援這些功能。

    註:
    WebSphere Portal 測試環境 5.1 版會自動安裝 WebSphere Application Sever 5.1。

    您必須已安裝下列硬體,才能安裝 WebSphere Portal 測試環境:

    所有其他需求都和先前針對 Rational Application Developer 敘述的需求相同。

    從 CD-ROM 安裝

    您必須先安裝 Rational Application Developer,才能安裝入口網站測試環境。 建議您先停止 Rational Application Developer,再開始安裝入口網站測試環境。

    若要安裝 WebSphere Portal 測試環境 5.1,請遵循下列步驟:

    1. 如果您已安裝 WebSphere Application Server、WebSphere Portal、WebSphere Application Server 整合測試環境或 WebSphere Portal 整合測試環境,請確定它們全部已經停止,且務必停止任何 HTTP 伺服器。 否則,安裝可能會失敗。
    2. 插入 WebSphere Portal 5.1 的安裝 CD。(入口網站測試環境無法從主要 Rational Application Developer 安裝啟動程式安裝。)
    3. 在 Windows 系統中,安裝程式應該會自動啟動。如果沒有自動啟動,請從安裝 CD 的根目錄執行 install.bat 檔。 在 Linux 系統中,請從安裝 CD 的根目錄中執行 install.sh。
    4. 選取用來執行安裝程式的語言,再按一下確定來繼續作業。
    5. 閱讀安裝程式歡迎使用頁面中的資訊,按下一步
    6. 接受授權合約,再按下一步
    7. 選取測試環境圓鈕,然後按下一步
      註:
      視平台而定,您可能會收到一則錯誤訊息,指出作業系統必備項目檢查失敗。 這是因為有些作業系統(如 Red Hat Enterprise Linux Workstation 3.0 版)只在入口網站測試環境中才受到支援。 您可以放心忽略這則訊息 - 請按一下確定繼續安裝。
    8. 接受 WebSphere Application Server 5.1 版的預設安裝目錄,或瀏覽選取新的目錄,再按下一步。 預設安裝目錄是 C:\Program Files\Portal51UTE\AppServer (Windows) 和 opt/Portal51UTE/AppServer (Linux)。 除非您沒有足夠的空間,否則,建議您使用預設安裝目錄。
    9. 接受入口網站測試環境的預設安裝目錄,或瀏覽選取新的目錄,再按下一步。 預設安裝目錄是 C:\Program Files\Portal51UTE\PortalServer (Windows) 和 opt/Portal51UTE/PortalServer (Linux)。除非您沒有足夠的空間,否則,建議您使用預設安裝目錄。
    10. 指定要在入口網站測試環境中使用的使用者 ID 和密碼。按下一步
    11. 檢視摘要畫面中的資訊,再按下一步
    12. 當系統提示時,請插入適當的 WebSphere Portal 5.1 CD 及指定它的磁碟機位置。
    13. 安裝好之後,請按一下完成來關閉安裝程式。

    附註:

    請參閱線上說明檔「配置 WebSphere Portal 測試環境 5.1 版」,以取得配置入口網站測試環境 5.1 來使用 Rational Application Developer 的相關資訊。

    從電子影像安裝

    為了有助於軟體的安裝,請建立適當的目錄,再將每個檔案的內容下載和解壓縮到這個目錄中。

    註:
    您必須在影像支援的相同平台中,下載、解壓縮和執行影像。 比方說,如果影像的標題只列出 Windows,您就只能在 Windows 系統中下載、解壓縮和執行這個影像。

    WebSphere Portal 測試環境 5.1 版需要下列 CD 影像:

    請執行下列步驟來建立適當目錄和下載檔案:

    1. 建立您要下載的各影像的目錄。

      請在相同機器共用目錄下建立新目錄,根據標題中所提供的對應磁碟 ID 來命名新目錄,前面加上 cd 字元。 比方說,cdSetup、cd1-1、cd1-2,依此類推。

    2. 下載每個影像,將內容解壓縮。

      請將每個影像下載到它自己的目錄中。 下面顯示的這些步驟提供如何下載和解壓縮特定影像的指示。 這些步驟利用下列影像來作為範例:
      WebSphere Portal 5.1 版 - Windows 和 Linux 的安裝管理程式 - 巴西葡萄牙文、法文、德文、英文、義大利文、日文、韓文、簡體中文、西班牙文和繁體中文。


      檔名 C7003ML.zip

      如果要下載和解壓縮這個影像的內容,請執行下列步驟:

      1. 建立名稱為 cdSetup 的目錄。
      2. 將 C7003ML.zip 下載至 cdSetup 目錄中。
      3. 將 C7003ML.zip 中的檔案解壓縮到 cdSetup 目錄。
    3. 當您準備好安裝解壓縮的影像時,請參閱上面的「從 CD-ROM 安裝」一節。

    使用 DB2 或 Oracle 資料庫作為 WebSphere Portal 配置儲存庫

    依預設,WebSphere Portal 5.1 版測試環境會安裝和使用 Cloudscape 資料庫來儲存用來存取入口網站資源的使用者身分、認證和許可權的相關資訊。Cloudscape 是一個適用於基本入口網站環境的 WebSphere Portal 內建 Java 資料庫。

    如果要安裝和配置 DB2 或 Oracle 資料庫,請參閱 WebSphere Portal 5.1 版 InfoCenter,網址如下:www.ibm.com/websphere/portal/library。您可以在 WebSphere Portal 5.1 版 InfoCenter 的「配置 > 資料庫」之下找到指示。 請注意,當您參照 InfoCenter 中的配置指示時,InfoCenter 中的 <wp_root> 對應於 WebSphere Portal 5.1 測試環境的安裝目錄, InfoCenter 中的 <was_root> 對應於 WebSphere Application Server 5.1 版的安裝目錄(請參閱上文,以取得預設位置)。 另外,如果要驗證資料庫連線,您便要建立 WebSphere Portal 5.1 測試環境,再啟動伺服器,而不是遵循 InfoCenter 中的步驟。

    配置 WebSphere Portal 測試環境 5.1 版

    您必須依照下列方式配置入口網站測試環境 5.1 版來使用 Rational Application Developer:

    1. 啟動 Rational Application Developer。
    2. 從功能表中,選取視窗 >喜好設定 > 伺服器 > 已安裝的執行時期。這時會出現「已安裝的伺服器執行時期環境」頁面。
    3. 選取 WebSphere Portal 5.1 版 Stub,再選取編輯。這時會出現「編輯伺服器執行時期」頁面。
    4. 將名稱改成 WebSphere Portal 5.1 版,指定 WebSphere Portal 位置和 WebSphere Application Server 位置。 (比方說,分別是 C:\Program Files\Portal51UTE\PortalServer 和 C:\Program Files\Portal51UTE\AppServer)。
    5. 按一下完成,再按一下確定

    解除安裝 5.1 版入口網站測試環境

    如果要解除安裝入口網站測試環境,請遵循下列步驟:

    1. 移至入口網站測試環境的安裝目錄。
    2. 移至 PortalServer\uninstall 子目錄,再執行解除安裝應用程式。
    3. 遵循畫面中的指示。

    在某些情況下(如安裝程序中止),解除安裝程式可能不是完整且可運作的程式。在這些情況下,您需要手動完成解除安裝的程序。 請參閱 WebSphere Portal 5.1 版 InfoCenter,以取得手動解除安裝 WebSphere Portal 測試環境 5.1 版的詳細資料。


    第 12 章 安裝 Crystal Enterprise

    Crystal Enterprise 是資料存取、報告和資訊遞送的共用架構。 它的設計是為了與現有的資料、Web 和應用程式投資緊密地整合起來。Crystal Enterprise 以 Crystal Reports 為基礎,是一個調整資訊來配合數千使用者的有效解決方案。

    Crystal Enterprise Embedded Edition 包括一個隨需應變的 Web 應用程式報告伺服器,非常適合將報告內嵌在單一分部應用程式中。它只適用於 Windows。

    Crystal Enterprise Professional Edition 是一個集中式平台,用來透過 Web 或整合在企業內部網路、企業外部網路、網際網路和公司入口網站應用程式中,而進行複雜和互動式報告的管理和安全分送。Professional Edition 包括 Embedded Edition 的所有功能, 適用於 Windows 和 Linux。

    如果需要 Crystal Enterprise Embedded Edition 和 Professional Edition 的詳細比較,請參閱 www.businessobjects.com/global/pdf/products/reporting/crystalenterprise/ce10_editions.pdf。 (如果要開啟 Acrobat PDF 檔,您必須已安裝 Adobe Reader 軟體,您可以從 www.adobe.com/products/acrobat/readstep2.html 下載它。) 如果需要 Crystal Enterprise 的一般詳細資訊,請參閱 www.businessobjects.com/products/reporting/crystalenterprise/default.asp

    作為一項報告、分析和資訊遞送的整合套件,Crystal Enterprise 提供了既能增加一般使用者生產力、又能減少管理工作的解決方案。

    安裝 Crystal Enterprise V10 Embedded Edition

    如果要安裝 Crystal Enterprise V10 Embedded Edition,請遵循下列步驟:

    1. 插入 Crystal Enterprise V10 Embedded Edition 磁碟。
    2. 從 Rational Application Developer 安裝啟動程式中,按一下安裝 Crystal Enterprise V10 Embedded Edition。 這時會開啟 Crystal Enterprise 安裝程式。
    3. 下一步。接受授權合約,再按下一步
    4. 您可以選取完整安裝或自訂安裝。
      1. 預設安裝是完整安裝。這是建議的選項,會將所有預設元件安裝在下列位置:C:\Program Files\Crystal Decisions。
      2. 如果您要自訂安裝的任何事項,如它的位置,請選取自訂圓鈕,再按下一步。 請依照需要來自訂您的選項。 如果需要自訂安裝選項的詳細資訊,請參閱 Crystal Enterprise V10 Embedded Edition CD 之 en/docs 子資料夾中的 install.pdf 檔。
    5. 下一步,繼續作業,再按下一步來開始安裝。
    6. 安裝完成之後,請按下一步來註冊 Crystal Enterprise,或按一下以後註冊,以後再註冊本產品。
    7. 按一下完成來結束安裝精靈。

    您也可以安裝日文的 Crystal Enterprise V10 Embedded Edition。 請從 jp 子目錄執行 setup.exe 來啟動安裝精靈,遵循上面所列出的相同指示。

    解除安裝 Crystal Enterprise V10 Embedded Edition

    如果要解除安裝 Crystal Enterprise(英文或日文版),請遵循下列步驟:

    1. 開啟控制台
    2. 按一下新增/移除程式
    3. 選取 Crystal Enterprise 10 Embedded,按一下移除按鈕。

    這時會從您的系統中移除 Crystal Enterprise。

    安裝 Crystal Enterprise V10 Professional Edition

    Windows 若要在 Windows 安裝 Crystal Enterprise V10 Professional Edition,請遵循下列步驟:

    1. 插入 Windows 的 Crystal Enterprise V10 Professional Edition 磁碟。
    2. 從 Rational Application Developer 安裝啟動程式中,按一下安裝 Crystal Enterprise V10 Professional Edition。 這時會開啟 Crystal Enterprise 安裝程式。
    3. 下一步。接受授權合約,然後按下一步
    4. 您可以接受預設安裝目錄,或瀏覽選取新的安裝目錄。按下一步
    5. 可用的安裝類型有三種:全新擴充自訂
      1. 預設選項是全新安裝。這會安裝新的 Crystal Enterprise 系統。
      2. 如果您要擴充現有的 Crystal Enterprise 系統,請選取擴充圓鈕,按下一步。 您可以輸入現有的 CMS 名稱(其中 CMS 是您的 Crystal Management Server),選取您要新增至 Crystal Enterprise 系統中的伺服器。 如果需要擴充現有 Crystal Enterprise 系統的詳細資訊,請參閱 Crystal Enterprise V10 Professional Edition CD 中的 docs\install.pdf 檔。

      如果您要自訂要安裝的應用程式特性,請選取自訂圓鈕,再按下一步。 請選取您要安裝的特性。 如果需要自訂安裝的詳細資訊,請參閱 Crystal Enterprise V10 Professional Edition CD 中的 docs\install.pdf 檔。

    6. 下一步以繼續。
    7. 如果您並未安裝相容的 Web 伺服器,您會收到一則警告訊息。按下一步以繼續。
    8. 如果您選取全新安裝,且安裝程式偵測到 Microsoft(R) Data Engine (MSDE) 或 SQL Server,這時會開啟「Microsoft SQL Server 鑑別」對話框。 您必須提供您設給 Crystal Management Server (CMS) 的資料庫帳戶所對應的 ID 和密碼。 否則,如果安裝程式沒有偵測到現有的 MSDE 或 SQL Server 資料庫,這時會開啟「MSDE 安全配置」對話框。 您必須提供隨著 MSDE 而安裝的預設 SQL 管理者帳戶的 ID 和密碼。 如果需要 Crystal Management Server (CMS) 或 Microsoft Data Engine (MSDE) 的詳細資訊,請參閱 Crystal Enterprise V10 Professional Edition CD 中的 docs\install.pdf 檔。請按下一步繼續作業,再按下一步來開始安裝。
    9. 如果您選擇展開現有的 Crystal Enterprise 系統,且您選擇新增其他 CMS,這時會開啟「CMS 資料庫資訊」對話框。 請指定 CMS 必須用來連接現有 CMS 資料庫的資料庫連線類型。 請按下一步繼續作業,再按下一步來開始安裝。
    10. 如果您選取自訂安裝,這時會開啟「CMS 叢集作業」對話框。 除非這個新系統要與現有的系統形成叢集,否則,請選取,再按下一步來繼續作業。 如果安裝程式偵測到 Microsoft Data Engine (MSDE) 或 SQL Server,這時會開啟「Microsoft SQL Server 鑑別」對話框。 您必須提供您設給 Crystal Management Server (CMS) 的資料庫帳戶所對應的 ID 和密碼。 否則,如果安裝程式沒有偵測到現有的 MSDE 或 SQL Server 資料庫,這時會開啟「MSDE 安全配置」對話框。 您必須提供隨著 MSDE 而安裝的預設 SQL 管理者帳戶的 ID 和密碼。 如果需要 Crystal Management Server (CMS) 或 Microsoft Data Engine (MSDE) 的詳細資訊,請參閱 Crystal Enterprise V10 Professional Edition CD 中的 docs\install.pdf 檔。請按下一步繼續作業,再按下一步來開始安裝。
    11. 在安裝期間,系統可能會提示您重新開機。
    12. 安裝完成之後,請按下一步來註冊 Crystal Enterprise,或按以後註冊,以後再註冊本產品。
    13. 按一下完成來結束安裝精靈。

    您也可以安裝日文的 Crystal Enterprise V10 Professional Edition。 請移至 Windows CD 中 Crystal Enterprise V10 Professional Edition Japanese 的根目錄,然後執行 setup.exe 來啟動安裝精靈。請遵循上述相同的指示,不過,您必須從 Windows CD 的 Crystal Enterprise V10 Professional Edition Japanese 直接啟動日文安裝精靈。

    Linux 若要在 Linux 安裝 Crystal Enterprise V10 Professional Edition,請遵循下列步驟:

    1. 插入 Linux 的 Crystal Enterprise V10 Professional Edition 磁碟,然後裝載 CDROM。
    2. 開啟在安裝磁碟根目錄中的 install.html 檔。 這個檔案含有在 Linux 安裝 Crystal Enterprise V10 Professional Edition 的完整指示。您必須參閱這個檔案的指示來準備系統,以及完成安裝程序。 在安裝產品之前,您也應該檢視 release.htm 檔的「安裝」一節,這個檔案位在安裝磁碟的根目錄中。
    3. 查閱 install.html 檔的「設定 Linux 系統」一節,並執行所有必要的動作,再繼續執行安裝 Script。
    4. 在安裝產品之前,停用任何防毒軟體。
    5. 遵循 install.html 檔中的「執行安裝 Script」指示來完成安裝程序。 它會說明使用者的安裝程序。

      註:

      1. 「執行安裝 Script」指示告訴您將 licensetext 檔(在您的產品程式模組散布中)和包含 Crystal Enterprise 二進位檔的檔案複製到 HOME 目錄中。 這些檔案在安裝磁碟的 linux_x86 目錄中。

      2. 在「執行安裝 Script」中,有一個步驟指示您應該輸入產品啟動 keycode。您可以忽略這個步驟。
    6. 當安裝 Script 完成時,您必須部署 Crystal Enterprise Web 桌面及 Crystal Enterprise 啟動程式。 請參閱 install.html 檔中的「部署 Crystal Enterprise Web 桌面」一節。
    7. 如果需要部署 Web 元件配接器 (WCA) 的相關資訊,其中包括部署多重 WCA 的相關資訊,請參閱 install.html 檔中的「部署 Web 元件配接器」一節。
    8. 如果您在開始安裝之前停用防毒軟體,請啟用它。

    您也可以安裝日文的 Crystal Enterprise V10 Professional Edition。 請使用 Linux CD 上日文版的 Crystal Enterprise V10 Professional Edition Japanese,並遵循上述相同的指示。

    解除安裝 Crystal Enterprise V10 Professional Edition

    如果要解除安裝 Windows 中的 Crystal Enterprise(英文或日文版),請遵循下列步驟:

    1. 開啟控制台
    2. 按一下新增/移除程式
    3. 選取 Crystal Enterprise 10,按一下移除按鈕。

    這時會從您的電腦中移除 Crystal Enterprise。

    如果要解除安裝 Linux 中的 Crystal Enterprise(英文或日文版),請遵循下列步驟:

    1. 執行安裝架構 crystal 目錄中的 uninstallCE.sh Script。 這個 Script 會刪除最初安裝 Crystal Enterprise 時所安裝的所有檔案。

    第 13 章 安裝更新項目

    Rational Product Updater 是一個工具,用來追蹤系統所安裝的所有 Rational 軟體開發產品及搜尋和安裝產品更新項目及選用的新特性。

    您安裝的第一個 Rational 軟體開發產品會自動安裝 Product Updater。這個工具會自動登錄後來安裝的所有 Rational 軟體開發產品。 您可以搜尋和自動安裝這些產品的下列各種更新項目:

    更新項目之間的任何相依關係都會自動強制施行。 Product Updater 可讓您利用單一位置來管理所有 Rational 軟體開發產品的更新。 它甚至會更新其本身。

    Product Updater 也可讓您執行下列作業:

    請參閱 Product Updater 的說明系統,以取得如何使用這個工具的相關資訊,存取方法如下:

    1. 如果要啟動 Product Updater,請在 Rational Application Developer 中,選取說明 > 軟體更新 > IBM Rational Product Updater
    2. 在 Product Updater 中,選取說明 > 說明內容

    第 14 章 版權和注意事項

    請參閱版權和注意事項