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


目錄

第 1 章 簡介

第 2 章 Rational Web Developer 的安裝需求

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

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

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

  • 移轉、升級和共存性問題
  • 從 CD-ROM 安裝
  • 從電子影像安裝
  • 建立網路安裝影像
  • 呼叫無聲自動安裝
  • 設定本端影像
  • 在預設目錄中無聲自動安裝預設特性
  • 無聲自動安裝至不同目錄
  • 無聲自動安裝其他 Rational Web Developer 特性
  • 增加可用的檔案控點數目
  • 啟動 Rational Web Developer
  • 解除安裝 Rational Web Developer
  • 無聲自動解除安裝 Rational Web 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 Web Developer 在團隊環境中工作

  • 支援的軟體
  • IBM Rational ClearCase
  • IBM Rational ClearQuest
  • 第 8 章 將 WebSphere Application Server 5.x 安裝成整合測試環境

    第 9 章 安裝更新項目

    第 10 章 版權和注意事項


    第 1 章 簡介

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

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

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

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


    第 2 章 Rational Web Developer 的安裝需求


    硬體需求

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


    軟體需求

    作業系統

    您必須先安裝下列軟體,才能安裝 Rational Web 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 Web Developer)的啟動點和 Rational Software Development Platform 啟動點,都會啟動共用使用者介面。若要找出產品特定的資訊(如:Readme 檔), 請瀏覽至您在其中安裝 Rational Software Development Platform 的產品特定目錄(如:rwd_prod 表示 Rational Web Developer)。

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

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

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

    -accessibility

    會使螢幕讀取器程式更容易使用執行時期主控台模式精靈。 如果要執行主控台模式,請從第一片 Rational Web 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 Web Developer。 不過,Rational Web Developer 可以與這些產品並存。必要的話, 您可以從 Rational ClearCase(R)、Clear Case LT 和 CVS 中,將工作區、成品和專案手動移轉至 Rational Web Developer

    您可以從 WebSphere Studio 5.1.x 移轉至 Rational Web Developer,也可以選擇共存。請參閱移轉手冊,以取得 Rational Web 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 Web Developer,請遵循下列步驟:

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

      要訣:

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

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

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

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

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

        486604803  要求的授權已過期
        486604805 所有授權的開始日期都還沒到
        
        請確定系統時鐘設定正確,再啟動 Rational Web Developer。
    12. 安裝程式要花一些時間來設定開發環境和起始設定 Eclipse。 最後,會出現一則確認安裝已經完成的訊息。 按下一步來完成安裝。
    13. 下一畫面會有一則訊息,建議您利用 Rational Product Updater 來檢查所安裝之特性的更新項目。 (請參閱第 9 章, "安裝更新項目",以取得詳細資訊。) 請按一下完成來關閉安裝視窗。
    14. 如果您要開發在其他應用程式伺服器中執行的應用程式,您可以選擇性地選擇隨著 Rational Web Developer 而安裝其他執行時期測試環境。如果需要詳細資訊,請參閱第 8 章, "將 WebSphere Application Server 5.x 安裝成整合測試環境"
    15. 在利用 Rational Web Developer 的側寫、執行時期分析和記載特性來收集遠端資料之前,您必須先將 Agent Controller 安裝在本端和遠端主機上。 請參閱第 6 章, "安裝 Agent Controller",以取得詳細資料。

    註:

    從電子影像安裝

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

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

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

    1. 將所有必要的組件和想要的選用組件下載到相同的暫時目錄中。 如果稍後需要任何選用的組件,在開始安裝之前,請先下載這些附加的選用組件,重新執行解壓縮工具。
    2. 啟動位在暫時目錄中的 extractor.exe 檔。這會啟動建立安裝影像的精靈。
    3. 遵循精靈中的指示來指定要建立影像的位置及要併入哪些特性。
    4. 建立好影像之後,如果您要立即安裝產品,請按一下完成。 另外,您也可以取消選取啟動安裝精靈勾選框,稍後再從建立安裝影像的目錄啟動 disk1\launchpad.exe 來執行安裝程式。
    5. 請遵循"從 CD-ROM 安裝"一節中所說明的指示。

    建立網路安裝影像

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

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

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

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

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

    1. Agent Controller
    2. WebSphere 5.x 版測試環境

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

    附註(R)


    呼叫無聲自動安裝

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

    設定本端影像

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

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

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

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

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

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

    無聲自動安裝至不同目錄

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

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

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

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

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

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


    表 1. 回應檔選項清單。

    特性 回應檔項目
    產品安裝目錄 installLocation
    WebSphere Application Server 6.0 版 feature_was6_win32.active
    語言套件 feature_lang_pack_rwd_win32.active
    企業產生語言 (EGL) feature_egl_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 Web Developer 可能需要好一會兒才能完成。如果要確定安裝完成的時間,您可以定期監視安裝目錄中的 \logs 子目錄。如果出現 license.log 檔,就表示無聲自動安裝已經完成。

    啟動 Rational Web Developer

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

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

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

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

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


    解除安裝 Rational Web Developer

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

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

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

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

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

    無聲自動解除安裝 Rational Web Developer

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

    rwd_prod\_uninst\uninstall.exe -silent
    

    已知的問題和限制

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

    失敗安裝的復原

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

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

    如果您在安裝 Rational Web 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 Web Developer 安裝目錄的 \runtimes\base_v6 子目錄中。

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

    在 Windows Server 2003 中,如果已安裝和配置終端機伺服器,當您解除安裝 Rational Web 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 Web Developer for Linux

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

    安裝注意事項:

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


    移轉、升級和共存性問題

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

    您不能從 WebSphere Studio Site Developer 或 WebSphere Studio Application Developer 4.x.x 版或 5.0.x 版移轉至 Rational Web Developer。 不過,Rational Web Developer 可以與這些產品共存。必要的話, 您可以從 Rational ClearCase、Clear Case LT 和 CVS 中,將工作區、成品和專案手動移轉至 Rational Web 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 Web 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 Web Developer 安裝啟動程式」視窗。

      要訣:

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

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

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

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

      3. 依預設,不會安裝 Enterprise Generation Language (EGL) 特性。EGL 是一個用來建立複雜商業應用程式的高階且功能強大的語言。 它會解決複雜的基礎技術(如資料庫存取、訊息佇列和 J2EE 等),因此,應用程式開發人員可以全心處理他們旳商業邏輯。 如果要安裝 EGL 外掛程式,請選取 Enterprise Generation Language (EGL) 勾選框。
      4. 依預設,不會安裝開發 Eclipse 外掛程式的範例。 這些範例適用於想要建立自己的外掛工具來延伸工作台的開發人員。 如果要安裝 Eclipse 外掛程式開發的範例,請選取 Eclipse 外掛程式開發勾選框。
    12. 下一步來顯示 Rational Web Developer 安裝的摘要資訊。
    13. 下一步繼續安裝 Rational Web 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 Web Developer。
    16. 安裝好 Rational Web Developer 之後,按下一步來完成安裝作業。
    17. 下一畫面會有一則訊息,建議您利用 Rational Product Updater 來檢查所安裝之特性的更新項目。 (請參閱第 9 章, "安裝更新項目",以取得詳細資訊。) 請按一下完成來關閉安裝視窗。
    18. 如果您要開發在其他應用程式伺服器中執行的應用程式,您可以選擇性地選擇隨著 Rational Web Developer 而安裝其他執行時期測試環境。如果需要詳細資訊,請參閱第 8 章, "將 WebSphere Application Server 5.x 安裝成整合測試環境"
    19. 在利用 Rational Web Developer 的側寫、執行時期分析和記載特性來收集遠端資料之前,您必須先將 Agent Controller 安裝在本端和遠端主機上。 請參閱第 6 章, "安裝 Agent Controller",以取得詳細資料。

    註:

    從電子影像安裝

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

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

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

    1. 將所有必要的組件和想要的選用組件下載到相同的暫時目錄中。 如果稍後需要任何選用的組件,在開始安裝之前,請先下載這些附加的選用組件,重新執行解壓縮工具。
    2. 輸入下列指令來修改這個暫時目錄中之 extractor.bin 檔的許可權:
      chmod +x extractor.bin
      
    3. 輸入 ./extractor.bin 來執行檔案
    4. 遵循精靈中的指示來指定要建立影像的位置及要併入哪些特性。
    5. 建立好影像之後,如果您要立即安裝產品,請按一下完成。 另外,您也可以取消選取啟動安裝精靈勾選框,稍後再從建立安裝影像所在的目錄啟動 disk1/launchpad.bin 來執行安裝程式。
    6. 請遵循"從 CD-ROM 安裝"一節中所說明的指示。

    建立網路安裝影像

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

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

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

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

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

    1. Agent Controller
    2. WebSphere 5.x 版測試環境

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

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

    呼叫無聲自動安裝

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

    設定本端影像

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

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

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

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

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

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

    無聲自動安裝至不同目錄

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

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

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

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

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

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


    表 2. 回應檔選項清單。

    特性 回應檔項目
    產品安裝目錄 installLocation
    WebSphere Application Server 6.0 版 feature_was6_linux.active
    語言套件 feature_lang_pack_rad_linux.active
    企業產生語言 (EGL) feature_egl_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 Web Developer 可能需要好一會兒才能完成。 如果要確定安裝完成的時間,您可以定期監視安裝目錄中的 /logs 子目錄。如果出現 license.log 檔,就表示無聲自動安裝已經完成。

    增加可用的檔案控點數目

    在使用產品之前,建議使用者要求管理者超出每個程序 1024 個檔案控點的預設限制,提供更多檔案控點給 Rational Web 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 Web Developer

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

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

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

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


    解除安裝 Rational Web Developer

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

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

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

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

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

    無聲自動解除安裝 Rational Web Developer

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

    rwd_prod\_uninst\uninstall.bin -silent
    

    已知的問題和限制

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

    磁碟限制

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

    如果您在安裝 Rational Web 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 Web 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. Windows:如果您是從 Rational Web Developer 安裝 CD 來安裝 Agent Controller,請從「啟動程式」視窗中選取安裝 Agent Controller(如果停用自動執行功能,請從安裝 CD 的根目錄執行 lauchpad.exe)。 繼續執行步驟 5。
    3. 切換至適當平台的安裝媒體所在目錄。
    4. 執行 setup.exe 程式。如果是非 Windows 平台,請執行 setup.bin
    5. 在歡迎畫面上按下一步以繼續。
    6. 繼續進行安裝之前,請先關閉所有的 Eclipse 平台。按下一步以繼續。
    7. 閱讀授權合約。
    8. 選取核准,然後按下一步以繼續。
    9. 這時會通知您將移除任何現有的 Agent Controller。按下一步以繼續。
    10. 指定 Agent Controller 的安裝路徑,再按下一步繼續作業。
    11. 選取您要安裝的 Agent Controller 特性:

      下一步以繼續。

    12. 指定 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 啟動
    13. 選用:如果選取了「WebSphere Application Server 的遠端支援」,請指定 IBM WebSphere Application Server 5.0 版(只限 Windows)和 5.1 版的路徑。
    14. 指定哪些主機可以存取 Agent Controller。其選項如下:

      下一步以繼續。

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

      下一步以繼續。

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

    無聲自動安裝 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. 利用 FTP 將安裝 CD 中的 IBMRAC.SAVF 檔新增至採用 BINARY 模式轉送之 iSeries 主機的 IBMRAC 程式庫中。
    5. 利用 FTP 將安裝 CD 中的 HYADESDC.SAVF 檔新增至採用 BINARY 模式轉送之 iSeries 主機的 HYADESDC 程式庫中。
    6. 輸入下列指令,將在 iSeries 主機的保存檔 HYADESDC.SAVF 還原到 HYADESDC 程式庫中:

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

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

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

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

      ./SetConfig.sh
      
    12. 遵循畫面中的提示來配置 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 轉送至安裝目錄。
    3. 發出下列指令來擷取 Agent Controller 檔:

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

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

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

      ./SetConfig.sh
      
    7. 遵循畫面中的提示來配置 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 Web Developer。
    2. 終止所有含 Java 側寫代理程式或 J2EE 要求側寫程式的 java.exe 程序。

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

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

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

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

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

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

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

    如果要搭配其他可用的 SCM 系統來使用 Rational Web 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 Web Developer 之後,您必須確定您的 ClearCase 用戶端和伺服器環境已利用最新的適當修補程式更新過。 您需要這個修補程式,才能提供比較及合併統一建模語言 (UML) 圖檔的適當支援。 當使用 Rational Web 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 Web 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 檔來取得完整的安裝指示。


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

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

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

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

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

    1. 從 Rational Web 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 章 安裝更新項目

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

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

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

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

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

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

    第 10 章 版權和注意事項

    請參閱版權和注意事項