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 章 版權和注意事項
這份安裝手冊提供安裝和解除安裝 Rational(R) Web Developer、選用特性和 Rational Web Developer 所提供的其他產品的指示。
請參閱移轉手冊,以取得從 WebSphere(R) Studio 移轉的相關資訊。
請參閱 Readme 檔,以取得產品問題和限制的相關資訊。
請參閱 http://www.ibm.com/developerworks/rational,以取得更新的文件和疑難排解資訊。
您必須先安裝下列硬體,才能安裝 Rational Web Developer:
- 至少需要 Intel(R) Pentium(R) III 800 MHz 處理器(建議使用更高等級)。
- 至少需要 768 MB RAM(建議使用 1 GB RAM)。
- 磁碟空間:
- 如果要安裝完整的 Rational Web Developer,您需要 3.0 GB 的磁碟空間。
您開發的資源需要額外的磁碟空間。附註:如果沒有安裝選用的特性和執行時期環境,就可以減少所需要的磁碟空間。
- 如果您下載電子影像來安裝 Rational Web Developer,您還需要額外的磁碟空間。
- 如果您的檔案系統是 FAT32 而不是 NTFS,便需要更多空間
- 您在 TEMP 目錄中需要 500 MB 的空間。
- 顯示器解析度:
您必須先安裝下列軟體,才能安裝 Rational Web Developer:
- 下列作業系統的其中一個:
- Windows(R) XP Professional,含 Service Pack 1 和 2
- Windows 2000 Professional,含 Service Pack 3 和 4
- Windows 2000 Server,含 Service Pack 3 和 4
- Windows 2000 Advanced Server,含 Service Pack 3 和 4
- Windows Server 2003 Standard Edition
- Windows Server 2003 Enterprise Edition
- Red Hat Enterprise Linux(R) Workstation 3.0 版(所有 Service Pack)
- SuSE Linux Enterprise Server (SLES) 第 9 版(所有 Service Pack)
- 上述 Windows 和 Linux 作業系統支援 Rational Web Developer 所支援的所有國家語言。
- 如果您在 Linux 中工作,您需要 GTK 2.2.1 版或更新的版本。
- 您必須有 Web 瀏覽器,才能檢視 Readme 檔和安裝手冊。
如果您在 Linux 中工作,
您必須先安裝 Mozilla 1.4 GTK2,才能執行 Rational Web Developer。
Mozilla 1.5 GTK2 或 Mozilla 1.6 GTK2 也可以搭配 SWT 3.0 來使用。
另外,從 SWT 3.1 v3104 開始,可以使用 Mozilla 1.7 GTK2 或更新的版本。
安裝在系統中的 Mozilla 版本會隨著您的 Linux 程式模組散布而不同。
- 如果要檢視線上說明所包括的特定導覽和指導教學,您必須有 Macromedia Flash Player。
如果是 Windows,
您需要 6.0r65 版或更新的版本,如果是 Linux,則是 6.0r69 版或更新的版本。
- 如果需要支援的資料庫伺服器、Web 應用程式伺服器和其他軟體產品的相關資訊,請參閱線上說明和 Readme 檔。
- 如果您要側寫應用程式,請確定您已安裝 Java(TM) Runtime Environment (JRE) 1.3 或更新的版本。
IBM(R) Rational Software Development Platform 是下列產品所共用的共用開發環境:
- Rational Web Developer
- Rational Application Developer
- Rational Software Architect
- Rational Software Modeler
- Rational Functional Tester
- Rational Performance Tester
如果您安裝任何這些產品,都會將 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 Architect 之後安裝 Rational Application Developer)時,您不能在安裝了第一項產品之後安裝第二項產品。
當您嘗試安裝的產品所提供的功能比您目前已安裝的產品少,就會發生這種狀況。
- 升級 - 當您安裝的產品不只包含現行產品的所有功能,還包含其他功能(比方說,如果您安裝了 Rational Web Developer,又想安裝 Rational Application Developer)時,您的產品就會升級為功能較高的產品。
第一項產品將會被解除安裝,但使用者介面和包含第一項產品之工作的工作區都會保留在相同的位置。
- 共用 - 發生這種狀況時,會有多項產品共用使用者介面的安裝架構。
第二項產品會擴充現有產品的功能,而且不會安裝使用者介面的另一個複本。
因此,比方說,如果您先安裝 Rational Performance Tester,再安裝 Rational Application Developer,這兩項產品會使用同一份使用者介面,使用者介面會同時包含 Rational Performance Tester 和 Rational Application Developer 所提供的所有功能。
解除安裝
- 升級產品- 當產品升級時,會將產品移除,並置換成功能較高的產品。
如果後來解除安裝了剛升級的產品,整套產品都會從系統中移除。
比方說,如果您先安裝 Rational Application Developer,再升級為 Rational Software Architect,後來又選擇解除安裝 Rational Software Architect,這時會解除安裝所有外掛程式(包括共用使用者介面),產品並不會回復為 Rational Application Developer。
如果您要取代 Rational Application Developer,您必須重新安裝它。
- 共用的產品 - 如果您在共用實務中安裝了兩項或兩項以上的產品,在您解除安裝最後一項產品之前,使用者介面將一直保留在適當的位置。比方說,如果您安裝了 Rational Application Developer 和 Rational Performance Tester,且解除安裝 Rational Application Developer,Rational Performance Tester(和使用者介面)仍然會保留在系統中。
- 註:
- 使用者介面會安裝在您安裝的第一個基於 Rational Software Development Platform 之產品的安裝目錄中。
它不會隨著任何其他產品而重新安裝,因此,如果您升級第一項產品,在升級完成之後,您不應移除第一個安裝目錄,因為它仍會包含使用者介面內容。
這一節包含在 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"
在安裝產品之前,請確認下列各項:
- 除了安裝產品所需要的空間之外,您的 TEMP 或 TMP 環境變數必須指向至少有 500 MB 可用空間的有效暫時目錄。
如果要從第一片產品安裝 CD 安裝 Rational Web Developer,請遵循下列步驟:
- 在您開始安裝程序之前,請先閱讀"移轉、升級和共存性問題"。
- 確定您使用的使用者 ID 不含雙位元組字元。
- 將 CD 插入您的光碟機中。
- 如果系統已啟用自動執行,就會自動開啟安裝啟動程式。如果系統停用了自動執行功能,請從第一片安裝 CD 的根目錄執行 launchpad.exe 來顯示「Rational Web Developer 安裝啟動程式」視窗。
要訣:
- 您可以略過啟動程式,直接從第一片安裝 CD 的 \setup 目錄執行 setup.exe 來進入 Rational Web Developer 安裝精靈。
- 如果您不要用圖形式介面,而要在命令提示字元之下安裝 Rational Web Developer,請從第一片安裝 CD 的 \setup 目錄執行下列指令:
setup.exe -console
- 註:
- 利用主控台模式來取消安裝 Rational Web Developer 會受到限制。在開始安裝 Rational Web Developer 之後,就無法取消安裝。您可以在安裝程序的準備步驟取消安裝,但在開始將檔案複製到硬碟之後,就沒有任何支援的方法可用來取消安裝程序。
按 Ctrl+C 鍵會強迫退出安裝程序,但不建議您這麼做。
- 從 Rational Web Developer 安裝啟動程式中,選取安裝 IBM Rational Web Developer 6.0 版。
- 等安裝精靈開啟之後,再按下一步繼續安裝。
- 遵循畫面的作業指示,如閱讀授權合約和指定目標安裝目錄。
- 在「特性」視窗中,您可以選擇要安裝的 Rational Web Developer 特性。
您可以返回安裝精靈,稍後再安裝選用特性。
- 依預設,安裝程式會將整合開發環境及選用的 WebSphere Application Server 6.0 版安裝成測試執行時期環境。
- 如果您要安裝英文以外受支援之國家語言的使用者介面和文件,請選擇安裝語言套件。
如果您的系統語言環境是英文,依預設,不會啟用這項特性。如果您的系統語言是其他支援的國家語言之一,就會選取它。
支援的國家語言有巴西葡萄牙文、法文、德文、義大利文、日文、韓文、簡體中文、西班牙文和繁體中文。
附註:如果您選擇安裝選用的「語言套件」特性,之後,又緊接著在複製檔案時取消安裝,後續的安裝便會有些異常。
在後續安裝中,「特性」畫面會將「語言套件」特性的狀態顯示為(已安裝),即使組成語言套件的檔案並沒有安裝也一樣。
您可以選擇重新安裝「語言套件」特性,這會將適當的檔案複製到您的磁碟中。
在這個狀況下,安裝結束時,可能會出現一則訊息指出在取代檔案期間,發生一或多個錯誤。您可以放心忽略這個錯誤訊息。
- 依預設,不會安裝 Enterprise Generation Language (EGL) 特性。EGL 是一個用來建立複雜商業應用程式的高階且功能強大的語言。
它會解決複雜的基礎技術(如資料庫存取、訊息佇列和 J2EE 等),因此,應用程式開發人員可以全心處理他們旳商業邏輯。
如果要安裝 EGL 外掛程式,請選取 Enterprise Generation Language (EGL) 勾選框。
- 依預設,不會安裝開發 Eclipse 外掛程式的範例。
這些範例適用於想要建立自己的外掛工具來延伸工作台的開發人員。
如果要安裝 Eclipse 外掛程式開發的範例,請選取 Eclipse 外掛程式開發勾選框。
- 按下一步來顯示 Rational Web Developer 安裝的摘要資訊。
- 註:
- 所顯示的磁碟空間需求是所有檔案所需的總位元組數。
您可以將實際需要的磁碟空間設想成大一些。
尤其是,如果您的磁碟格式是 FAT32,由於 FAT32 所用的磁碟區塊架構,許多小檔案的磁碟空間運用效率可能會不好。
- 按下一步來安裝 Rational Web Developer。
- 如果安裝結束時出現警告,指出授權登錄發生問題,請遵循下列步驟:
- 移至安裝目錄下的 \logs 子目錄。
- 利用文字編輯器來開啟 license.log。
- 如果 license.log 含有下面幾行:
486604803 要求的授權已過期
486604805 所有授權的開始日期都還沒到
請確定系統時鐘設定正確,再啟動 Rational Web Developer。
- 安裝程式要花一些時間來設定開發環境和起始設定 Eclipse。
最後,會出現一則確認安裝已經完成的訊息。
按下一步來完成安裝。
- 下一畫面會有一則訊息,建議您利用 Rational Product Updater 來檢查所安裝之特性的更新項目。
(請參閱第 9 章, "安裝更新項目",以取得詳細資訊。)
請按一下完成來關閉安裝視窗。
- 如果您要開發在其他應用程式伺服器中執行的應用程式,您可以選擇性地選擇隨著 Rational Web Developer 而安裝其他執行時期測試環境。如果需要詳細資訊,請參閱第 8 章, "將 WebSphere Application Server 5.x 安裝成整合測試環境"。
- 在利用 Rational Web Developer 的側寫、執行時期分析和記載特性來收集遠端資料之前,您必須先將 Agent Controller 安裝在本端和遠端主機上。
請參閱第 6 章, "安裝 Agent Controller",以取得詳細資料。
- 註:
- 安裝好 Rational Web Developer 之後,您可以隨時從安裝 CD 的 \setup 目錄中重新執行 setup.exe 來新增選用的特性。
這時會啟動 Rational Web Developer 安裝程式,之後,您就可以選取要新增的選用特性。(在選取特性的畫面中,先前安裝的特性旁會出現用括號括住的已安裝。)
您必須使用安裝必要特性時所用的相同使用者 ID。
- 如果您重新執行安裝程式來新增其他特性,且在完成之前選擇取消修正,您可能會收到下列錯誤:
安裝期間發生錯誤 - 使用者取消安裝
當您試圖解除安裝這個狀態的產品時,可能會出現下列錯誤:
找不到適當的 JVM。請利用 -is:javahome <JAVA HOME DIR>
選項來重新執行程式。
如果暫時要解決這個問題,您必須重新執行安裝程式來完成先前取消的修正,再繼續解除安裝產品。
請參閱產品 Readme 檔,以取得您需要下載的電子影像的說明。
在安裝產品之前,請確認下列各項:
- 您的 TEMP 或 TMP 環境變數必須指向至少有 500 MB 可用空間的有效暫時目錄。
這是在安裝產品所需要的空間之外。
- 您必須有大約 3 GB 磁碟空間,用來儲存全套下載影像,另外還要 4 GB 磁碟空間,用來解壓縮影像。
如果要下載和建立電子安裝影像,請執行下列動作:
- 將所有必要的組件和想要的選用組件下載到相同的暫時目錄中。
如果稍後需要任何選用的組件,在開始安裝之前,請先下載這些附加的選用組件,重新執行解壓縮工具。
- 啟動位在暫時目錄中的 extractor.exe 檔。這會啟動建立安裝影像的精靈。
- 遵循精靈中的指示來指定要建立影像的位置及要併入哪些特性。
- 建立好影像之後,如果您要立即安裝產品,請按一下完成。
另外,您也可以取消選取啟動安裝精靈勾選框,稍後再從建立安裝影像的目錄啟動 disk1\launchpad.exe 來執行安裝程式。
- 請遵循"從 CD-ROM 安裝"一節中所說明的指示。
您可以將一份安裝影像放在網路磁碟機中,讓使用者能夠通過網路來安裝。
如果要從網路磁碟機執行安裝程式,您必須使用 Rational Web Developer 的下載電子影像,或依照下列說明來複製 CD 的內容。
您需要大約 4 GB 磁碟空間來將 CD 內容儲存在磁碟中。如果要從 CD 中複製檔案,請執行下列動作:
- 將第一片 Rational Web Developer 安裝 CD 插入光碟機中。
- 在您要儲存影像的網路磁碟機中,建立一個暫時目錄(如 network_drive:\install_image)。
- 在暫時目錄下,建立稱為 disk1 的子目錄。這個子目錄必須稱為 disk1,且必須是小寫。
- 將第一片安裝 CD 中的所有檔案和目錄複製到暫時目錄的 disk1 子目錄中。
- 重複第 3 和 4 步驟,將另兩片 CD 的內容複製到稱為 disk2 和 disk3 的子目錄中。
這些都是核心安裝檔案。
如果您需要任何選用特性的安裝檔案:
- Agent Controller
- WebSphere 5.x 版測試環境
請將適當 CD 的內容複製到暫時目錄中。
附註(R):
如果您不要與安裝精靈交談,Rational Web Developer 安裝程式採無聲方式來執行。
在無聲自動安裝 Rational Web Developer 之前,您必須先設定本端影像:
- 在您開始安裝程序之前,請先閱讀"移轉、升級和共存性問題"。
- 確定您使用的使用者 ID 不含雙位元組字元。
- 依照"建立網路安裝影像"中所說明來建立本端或網路安裝影像。
如果您只要安裝 Rational Web Developer,您只需要複製前三片 CD 中的資訊。
當無聲自動安裝 Rational Web Developer 時,依預設,會安裝下列特性:
- 整合開發環境
- WebSphere Application Server 6.0 版(測試執行時期環境)
- 語言套件(如果您的系統語言環境不是英文)
如果要在預設目錄 system_drive:\Program Files\IBM\Rational\SDP\6.0 中,無聲地安裝只含有預設所選特性的 Rational Web Developer,請執行下列動作:
- 如果您還沒有依照"設定本端影像"所說明來複製影像,請執行這個動作。
- 從指令行中,切換至上一節所建立的暫時目錄中之 \disk1\setup 目錄(如 network_drive:\install_image\disk1\setup)。
- 執行下列指令:
setup.exe -silent
- 無聲自動安裝 Rational Web Developer 可能需要好一會兒才能完成。如果要確定安裝完成的時間,您可以定期監視預設安裝目錄中的 \logs 目錄。如果出現 license.log 檔,就表示無聲自動安裝已經完成。
您可以變更 installLocation 參數,將 Rational Web Developer 安裝在不同目錄中。比方說,如果您要使 "d:\my softdev" 成為安裝目錄,請遵循剛才所說明的相同步驟,但執行下列指令:
setup.exe -silent -P installLocation="d:\my softdev"
(在這個範例中,只會安裝預設特性。)
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
|
如果要無聲自動安裝任何選用特性,請執行下列動作:
- 將 responsefile.txt 複製到新檔案中,如 myresponsefile.txt。
- 編輯回應檔的複本。
- 找出有上表所顯示安裝特性名稱的行。
比方說,如果您要安裝開發 Eclipse 外掛程式的範例,您要在回應檔中找出 # -P feature_examples_win32.active=<value> 這一行。
- 將這一行變更如下:
- 移除第一直欄中的 #。
- 將 <value> 改成 true。
在這個範例中,這一行會改成:
-P feature_examples_win32.active=true
- 儲存變更。
- 如果您還沒有依照"設定本端影像"所說明來複製影像,請執行這個動作。
- 從指令行中,切換至上一節所建立的暫時目錄中之 \disk1\setup 目錄(如 network_drive:\install_image\disk1\setup)。
- 當您執行回應檔時,請如下所示,加入 -options 參數及完整定義的回應檔名稱:
setup.exe -silent -options "Your_directory\myresponsefile.txt"
其中 Your_directory 是回應檔所在的完整目錄名稱。
- 註:
- 如果要確認正在使用您的回應檔,請先執行不設定 -silent 選項的這個指令(也就是說,在執行無聲自動安裝之前),並確認您的設定登錄在安裝精靈中。
如果沒有登錄它們,就表示回應檔設定或指令語法發生問題。
- 無聲自動安裝 Rational Web Developer 可能需要好一會兒才能完成。如果要確定安裝完成的時間,您可以定期監視安裝目錄中的 \logs 子目錄。如果出現 license.log 檔,就表示無聲自動安裝已經完成。
如果要啟動 Rational Web Developer,請執行下列動作:
- 選取開始 > 程式集 > IBM Rational > IBM Rational Web Developer 6.0 > Rational Web Developer。
您也可以選取開始 > 程式集 > IBM Rational > Rational Software Development Platform 來啟動產品。
- 當您第一次啟動 Rational Web Developer 時,會開啟一個對話框,其中已指定預設的 workspace 目錄。依預設,您的工作會儲存在 C:\Documents and Settings\youruserid\IBM\rationalsdp6.0 下名稱為 workspace 的目錄中。
如果您要將工作儲存在其他位置,您可以變更 workspace 的名稱和位置。
- 依預設,會取消選取請用這個作為預設值,以後不要再問我勾選框。
如果您保留預設值,您每次啟動 Rational Web Developer 時,都會開啟一個對話框,讓您切換工作區。
比方說,如果您選擇不同專案要維護不同的工作區,您可以保留這個預設值。
要訣:如果選取請用這個作為預設值,以後不要再問我勾選框,就不會再開啟這個對話框,Rational Web Developer 會利用上一階段作業的工作區來啟動。您可以在啟動產品之後,在視窗 > 喜好設定 > 工作台 > 啟動和關閉頁面中變更這個預設值。
- 然後按一下確定。在建立工作區結構時,會有一次延遲。
工作台首先會開啟一系列的歡迎使用頁面來提供產品概觀和新增功能的相關資訊,以及通往指導教學、範例和外部 Web 資源的鏈結。
請花些時間來探索這些選項。
另外,也請注意「說明」功能表所提供的資訊來源。
如果要解除安裝 Rational Web Developer,請執行下列動作:
- 關閉 Rational Web Developer。
- 開啟「控制台」,然後開啟「新增/移除程式」視窗。選取 IBM Rational Web Developer 6.0,然後按一下變更/移除來解除安裝。
- 任何 plug-ins 或 features 目錄中的所有檔案都會自動刪除,任何這些目錄中的使用者資料和協力廠商外掛程式都包括在內。不會刪除含有您的工作的工作區目錄。
會保留部分其他目錄:
- 如果您是因為發生問題而解除安裝 Rational Web Developer,且準備重新安裝在相同目錄中,就會保留 \eclipse\configuration 目錄。
- 如果您是因為發生問題而解除安裝 Rational Web Developer,準備重新安裝在相同目錄中,且協力廠商外掛程式鏈結至您的產品,可能會保留 \eclipse\links 目錄。
- 會保留 \logs 目錄,以保存任何安裝產生的日誌檔的歷程。這個目錄可能含有可用來排解您遇到的安裝相關問題的資訊。
如果您試圖局部解除安裝一或多項 Rational Web Developer 必要特性,您會收到一則類似下列錯誤訊息:
選項無效:
無法解除安裝 ide_required:沒有設定解除安裝的 root
如果要暫時解決這個問題,請選取解除安裝產品勾選框。這會重新起始設定解除安裝畫面,因此,您現在可以解除安裝整個 Rational Web Developer,也可以取消選取您不要解除安裝的特性。
如果要無聲自動解除安裝 Rational Web Developer,請從命令提示字元下進入安裝目錄,然後輸入:
rwd_prod\_uninst\uninstall.exe -silent
這一節包含在 Windows 中安裝和解除安裝 Rational Web Developer 時,已知的問題和限制。請參閱 Readme 檔或線上說明,以取得會影響產品實際用法之問題和限制的相關資訊。
如果安裝作業失敗,您必須移除所有已安裝的 Rational Web Developer 檔案。如果您要安裝 Rational Web Developer 的目錄是空的,就表示安裝程序已移除所有已安裝的檔案,您可以刪除這個空目錄。
如果您在安裝 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 中,如果已安裝和配置終端機伺服器,當您解除安裝 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 產品,
則該產品的後續安裝可能會失敗。您可能不會收到任何錯誤,但新安裝的產品可能會無法使用。即使產品的開始功能表項目存在,預期的說明和產品功能表也可能不會存在。在產品內,您可能會看到一些已登錄的外掛程式,
但新的產品會無法使用。
如果您在取消合併安裝之後遇到問題,您需要根據您的狀況,採取下列其中一項的一連串動作:
- 如果您在開始複製檔案之前取消安裝,
您可以重新開始安裝,而不需要遵循以下說明的任一暫行解決方法。
- 這個問題的暫行解決方法會根據您所處的安裝程序位置而定。
如果您尚未開始第二次安裝,您可以編輯下列清單中適用於您系統的檔案:
- Windows 2000、2000 Server:C:\winnt\IBM\RAT60\.spdinst\cdi_ref.properties
- Windows XP、2003 Server:C:\Windows\IBM\RAT60\.spdinst\cdi_ref.properties
- Red Hat 3.0 和 SLES 9.0:/etc/IBM/RAT60/.spdinst/cdi_ref.properties
移除等號 (=) 之後的任何內容,其含有 3 個字母的代碼表示要安裝的產品。這些代碼如下:
- rpt = Rational Performance Tester
- rsm= Rational Software Modeler
- rsa= Rational Software Architect
- rad= Rational Application Developer
- rwd= Rational Web Developer
- rft= Rational Functional Tester
在編輯檔案之後,重新開始安裝,且不要在開始複製檔案之後取消安裝。
- 如果您已完成產品安裝,您必須執行解除安裝再重新安裝,且不要在開始複製檔案之後取消安裝。
本節包含在 Linux 安裝 Rational Web Developer 的相關資訊。您可以從 CD-ROM 或下載的電子影像來安裝 Rational Web Developer。
您可以利用所提供的安裝精靈,但也可以依照這份文件稍後所說明,在命令提示字元之下安裝 Rational Web Developer,或執行無聲自動安裝。
安裝注意事項:
- 安裝程式也可以在互動式主控台模式下執行,這比較適合需要協助工具的使用者。
協助工具模式指令行選項:
-accessibility
會使螢幕讀取器程式更容易使用執行時期主控台模式精靈。
如果要執行主控台模式,請在單行中輸入這個指令:
CD_device/setup/setup.bin -is:javaconsole -log @NONE -accessibility
其中 CD_device 的預設值是 /media/cdrom (SuSE) 和 /mnt/cdrom (Red Hat)。
請遵循提示來完成安裝。請注意,當指定 -accessibility 選項時,-is:javaconsole 選項非常重要。
如果您沒有指定這個選項,安裝程式就會當掉。-log @NONE 選項會關閉記載功能,以排除主控台視窗中所列出的日誌資訊。如果您在安裝期間遇到任何問題,
您可能要拿掉這個選項,以收集日誌資訊。
重要事項 - 在使用這項產品之前:
- Rational Web Developer 的執行需要大量檔案,因此,系統必須配置大量檔案控點給它。每個執行的 Rational Web Developer 工具都會需要更多檔案控點。每個程序 1024 個檔案控點的預設限制往往會不夠,且會造成工具的失敗,工作區也可能會遺失。
如果要避免這種失敗,在使用產品之前,我們建議使用者要求管理者提供更多檔案控點給 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"。
在安裝產品之前,請確認下列各項:
- 除了安裝產品所需要的空間之外,您的 TEMP 或 TMP 環境變數指向至少有 500 MB 可用空間的有效暫時目錄。
- 用來安裝產品的終端機階段作業之 Umask 設定設為 0022。
這個設定使 root 以外的使用者也能夠使用產品。
如果要設定這個變數,請以 root 使用者身分登入、啟動一個終端機階段作業,再輸入 Umask 0022。
- 註:
- 如果您的系統啟用了自動執行,請確定 umask 設定已設為 0022,再嘗試安裝產品。
如果您的 umask 設定未設為 0022,請勿從系統自動開啟的啟動程式安裝產品。
相反地,請關閉啟動程式,再利用下列步驟來從安裝 CD 安裝產品。
如果要從產品安裝 CD 安裝 Rational Web Developer,請遵循下列步驟:
- 在您開始安裝程序之前,請先閱讀"移轉、升級和共存性問題"。
- 以 root 使用者身分登入。
- 啟動一個終端機階段作業。
- 輸入 Umask 0022,使 root 以外的使用者也能夠使用這項產品。
- 將 CD 插入光碟機中。
在安裝期間,您必須插入下一片 CD。
如果您無法開啟 CD-ROM 來插入下一片 CD,請檢查下列是否有下列情況:
- 有終端機的現行工作目錄是 CD_device,其中 CD_device 的預設值是 /media/cdrom (SuSE) 和 /mnt/cdrom (Red Hat)。
- 另一個程式(不是安裝程式)在使用 CD-ROM。
如果是這樣,請停止該應用程式。
如果在插入下一片 CD 時仍有問題,請遵循下列步驟:
- 如果安裝程式仍在執行中,請按一下取消。
- 以 root 使用者身分登入。
- 如果還沒有將 Linux 程式模組散布 CD 中的 psmisc RPM 套件安裝在您的機器上,請安裝它。
- 啟動安裝程式。
- 如果仍有問題,請從另一個終端機輸入 /sbin/fuser CD_device 來顯示使用 CD-ROM 的程序。
- 如果要取得程序的詳細資料,請輸入:ps <process_id>
- 如果沒有裝載 CD-ROM,請輸入下列指令來裝載它:
mount CD_device
- 輸入 CD_device/launchpad.bin 來顯示「Rational Web Developer 安裝啟動程式」視窗。
要訣:
- 從 Rational Web Developer 安裝啟動程式中,選取安裝 IBM Rational Web Developer 6.0 版。
- 等安裝精靈開啟之後,再按下一步繼續安裝。
- 遵循畫面的作業指示,如閱讀授權合約和指定目標安裝目錄。
- 在「特性」視窗中,您可以選擇要安裝的 Rational Web Developer 特性。
- 依預設,安裝程式會將整合開發環境及選用的 WebSphere Application Server 6.0 版安裝成測試執行時期環境。
- 如果您要安裝英文以外受支援之國家語言的使用者介面和文件,請選擇安裝語言套件。
如果您的系統語言環境是英文,依預設,不會啟用這項特性。如果您的系統語言是其他支援的國家語言之一,就會選取它。
支援的國家語言有巴西葡萄牙文、法文、德文、義大利文、日文、韓文、簡體中文、西班牙文和繁體中文。
附註:如果您選擇安裝選用的「語言套件」特性,之後,又緊接著在複製檔案時取消安裝,後續的安裝便會有些異常。
在後續安裝中,「特性」畫面會將「語言套件」特性的狀態顯示為已安裝,即使組成語言套件的檔案並沒有安裝也一樣。您可以選擇重新安裝「語言套件」特性,這會將適當的檔案複製到您的磁碟中。
在這個情況下,安裝結束時,可能會出現一則訊息指出在取代檔案期間,發生一或多個錯誤。您可以放心忽略這個錯誤訊息。
- 依預設,不會安裝 Enterprise Generation Language (EGL) 特性。EGL 是一個用來建立複雜商業應用程式的高階且功能強大的語言。
它會解決複雜的基礎技術(如資料庫存取、訊息佇列和 J2EE 等),因此,應用程式開發人員可以全心處理他們旳商業邏輯。
如果要安裝 EGL 外掛程式,請選取 Enterprise Generation Language (EGL) 勾選框。
- 依預設,不會安裝開發 Eclipse 外掛程式的範例。
這些範例適用於想要建立自己的外掛工具來延伸工作台的開發人員。
如果要安裝 Eclipse 外掛程式開發的範例,請選取 Eclipse 外掛程式開發勾選框。
- 按下一步來顯示 Rational Web Developer 安裝的摘要資訊。
- 按下一步繼續安裝 Rational Web Developer。
- 當系統要求下一片 CD 時,請遵循下列步驟:
- 如果要開啟 CD-ROM,請輸入 eject CD_device
- 將下一片 CD 插入 CD-ROM 中。
- 如果沒有選取自動裝載,請輸入下列指令來裝載 CD-ROM:mount CD_device
- 按一下確定,繼續安裝。
- 如果安裝結束時出現警告,指出授權登錄發生問題,請遵循下列步驟:
- 移至安裝目錄下的 /logs 子目錄。
- 利用文字編輯器來開啟 license.log。
- 如果 license.log 含有下面幾行:
486604803 要求的授權已過期
486604805 所有授權的開始日期都還沒到
請確定系統時鐘設定正確,再啟動 Rational Web Developer。
- 安裝好 Rational Web Developer 之後,按下一步來完成安裝作業。
- 下一畫面會有一則訊息,建議您利用 Rational Product Updater 來檢查所安裝之特性的更新項目。
(請參閱第 9 章, "安裝更新項目",以取得詳細資訊。)
請按一下完成來關閉安裝視窗。
- 如果您要開發在其他應用程式伺服器中執行的應用程式,您可以選擇性地選擇隨著 Rational Web Developer 而安裝其他執行時期測試環境。如果需要詳細資訊,請參閱第 8 章, "將 WebSphere Application Server 5.x 安裝成整合測試環境"。
- 在利用 Rational Web Developer 的側寫、執行時期分析和記載特性來收集遠端資料之前,您必須先將 Agent Controller 安裝在本端和遠端主機上。
請參閱第 6 章, "安裝 Agent Controller",以取得詳細資料。
- 註:
- 安裝好 Rational Web Developer 之後,您可以隨時從安裝 CD 的 /setup 目錄中重新執行 setup.bin 來新增選用的特性。
這時會啟動 Rational Web Developer 安裝程式,之後,您就可以選取要新增的選用特性。(在選取特性的畫面中,先前安裝的特性旁會出現用括號括住的已安裝。)
-
如果您重新執行安裝程式來新增其他特性,且在完成之前選擇取消修正,您可能會收到下列錯誤:
安裝期間發生錯誤 - 使用者取消安裝
當您試圖解除安裝這個狀態的產品時,可能會出現下列錯誤:
找不到適當的 JVM。請利用 -is:javahome <JAVA HOME DIR>
選項來重新執行程式。
如果暫時要解決這個問題,您必須重新執行安裝程式來完成先前取消的修正,再繼續解除安裝產品。
請參閱產品 Readme 檔,以取得您需要下載的電子影像的說明。
在安裝產品之前,請確認下列各項:
- 您需要在 /tmp 中有至少 500 MB 可用空間。
- 您必須有大約 3 GB 的磁碟空間,來儲存該組完整的可下載影像,另外還要 4 GB 的磁碟空間來解壓縮影像。
如果要下載和建立電子安裝影像,請執行下列動作:
- 將所有必要的組件和想要的選用組件下載到相同的暫時目錄中。
如果稍後需要任何選用的組件,在開始安裝之前,請先下載這些附加的選用組件,重新執行解壓縮工具。
- 輸入下列指令來修改這個暫時目錄中之 extractor.bin 檔的許可權:
chmod +x extractor.bin
- 輸入 ./extractor.bin 來執行檔案
- 遵循精靈中的指示來指定要建立影像的位置及要併入哪些特性。
- 建立好影像之後,如果您要立即安裝產品,請按一下完成。
另外,您也可以取消選取啟動安裝精靈勾選框,稍後再從建立安裝影像所在的目錄啟動 disk1/launchpad.bin 來執行安裝程式。
- 請遵循"從 CD-ROM 安裝"一節中所說明的指示。
您可以將一份安裝影像放在網路磁碟機中,讓使用者能夠透過網路來安裝。
如果要從網路磁碟機執行安裝程式,您必須使用 Rational Web Developer 的下載電子影像,或依照下列說明來複製 CD 的內容。
您需要大約 4 GB 磁碟空間來將 CD 內容儲存在磁碟中。
如果要從 CD 中複製檔案,請執行下列動作:
- 以 root 使用者身分登入。
- 在您要儲存影像的網路磁碟機中,建立一個目錄(如 install_image)。
- 將第一片 Rational Web Developer 安裝 CD 插入光碟機中。
- 在暫時目錄下,建立稱為 disk1 的子目錄。這個子目錄必須稱為 disk1,且必須是小寫。
- 將第一片安裝 CD 中的所有檔案和目錄複製到暫時目錄的 disk1 子目錄中。
- 重複第 3、4 和 5 步驟,將另兩片 CD 的內容複製到稱為 disk2 和 disk3 的子目錄中。
這些都是核心安裝檔案。
如果您需要下列中任何選用特性的安裝檔案:
- Agent Controller
- WebSphere 5.x 版測試環境
請將適當 CD 的內容複製到暫時目錄中。
- 註:
- 如果從網路安裝影像安裝時,您的機器進入待命模式,安裝可能會失敗。
如果您不要與安裝精靈交談,Rational Web Developer 安裝程式採無聲方式來執行。
在無聲自動安裝 Rational Web Developer 之前,您必須先複製本端影像:
- 在您開始安裝程序之前,請先閱讀"移轉、升級和共存性問題"。
- 依照"建立網路安裝影像"中所說明來建立本端或網路安裝影像。
如果您只要安裝 Rational Web Developer,您只需要複製前三片 CD 中的資訊。
當無聲自動安裝 Rational Web Developer 時,依預設,會安裝下列特性:
- 整合開發環境
- WebSphere Application Server 6.0 版(測試執行時期環境)
- 語言套件(如果您的系統語言環境不是英文)
如果要在預設目錄 /opt/IBM/Rational/SDP/6.0 中,無聲自動安裝只含有預設所選特性的 Rational Web Developer,請執行下列動作:
- 以 root 使用者身分登入。
- 如果您還沒有依照"設定本端影像"所說明來複製影像,請執行這個動作。
- 從指令行中,切換至上一節所建立的暫時目錄之 /disk1/setup 目錄(如
/tmp/install_image/disk1/setup)。
- 執行下列指令:
./setup.bin -silent
- 無聲自動安裝 Rational Web Developer 可能需要好一會兒才能完成。
如果要確定安裝完成的時間,您可以定期監視安裝目錄中的 /logs 子目錄。如果出現 license.log 檔,就表示無聲自動安裝已經完成。
您可以變更 installLocation 參數,將 Rational Web Developer 安裝在不同目錄中。
比方說,如果您要使 "/my_softdev" 成為安裝目錄,請遵循剛才所說明的相同步驟,但執行下列指令:
./setup.bin -silent -P installLocation="/my_softdev"
在這個範例中,只安裝預設特性。
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
|
如果要無聲自動安裝任何選用特性,請執行下列動作:
- 將 responsefile.txt 複製到新檔案中,如 myresponsefile.txt。
- 編輯回應檔的複本。
- 找出有上表所顯示安裝特性名稱的行。
比方說,如果您要安裝 Eclipse 外掛程式的開發範例,您會在回應檔中找到下面這一行:
# -P feature_examples_linux.active=<value>
- 將這一行變更如下:
- 移除第一直欄中的 #。
- 將 <value> 改成 true。
在這個範例中,這一行會改成:
-P feature_examples_linux.active=true
- 儲存變更。
- 以 root 使用者身分登入。
- 如果您還沒有依照"設定本端影像"所說明來複製影像,請執行這個動作。
- 從指令行中,切換至上一節所建立的暫時目錄之 /disk1/setup 目錄(如
/tmp/install_image/disk1/setup)。
- 當您執行回應檔時,請依照下列範例所示,加入 -options 參數及完整定義的回應檔名稱:
./setup.bin -silent -options "Your_directory/myresponsefile.txt"
其中 Your_directory 是回應檔所在的完整目錄名稱。
- 註:
- 如果要確認正在使用您的回應檔,請先執行不設定 -silent 選項的這個指令(也就是說,在執行無聲自動安裝之前),並確認您的設定登錄在安裝精靈中。
如果沒有登錄它們,就表示回應檔設定或指令語法發生問題。
- 無聲自動安裝 Rational Web Developer 可能需要好一會兒才能完成。
如果要確定安裝完成的時間,您可以定期監視安裝目錄中的 /logs 子目錄。如果出現 license.log 檔,就表示無聲自動安裝已經完成。
在使用產品之前,建議使用者要求管理者超出每個程序 1024 個檔案控點的預設限制,提供更多檔案控點給 Rational Web Developer 使用者。
當在 Linux 中,利用下列步驟來增加檔案描述子時,請特別小心。
如果沒有適當遵循指示,機器可能無法適當啟動。
最好是請系統管理者來執行這個動作。
如果要增加檔案描述子,請執行下列動作:
- 以 root 身分登入。如果您沒有最高存取權,您必須先取得最高存取權,才能繼續作業。
- 切換至 etc 目錄。
- 利用 vi 編輯器來編輯 etc 目錄中的 initscript 檔。如果這個檔案不存在,請輸入 vi initscript 來建立它。
- 註:
- 如果您決定要增加檔案控點的數目,請勿將空的 initscript 檔留在機器中,否則,下次會無法啟動機器。
- 在第一行中,輸入 ulimit -n 4096(這裡的重點是數目要大於大部分 Linux 機器的預設值 1024)。
小心:請勿將這個值設得太高,因為它可能會嚴重影響系統層面的效能。
- 在第二行中,輸入 eval exec "$4"。
- 確定您已完成第 4 和 5 步驟之後,儲存和關閉檔案。
- 註:
- 請確定您已正確遵循這些步驟,因為如果沒有正確執行這項作業,機器將無法啟動。
- (選用)修改 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,請移至安裝目錄來執行下列指令:./rationalsdp.bin。
- 如果您在 Gnome(Red Hat 的預設值)中作業,產品捷徑會在主功能表的程式設計 > Rational Software Development Platform 之下。
如果您在 KDE(SuSE 預設值)中作業,產品捷徑就是 IBM Rational > Rational Software Development Platform。
- 當您第一次啟動 Rational Web Developer 時,會開啟一個對話框,其中已指定預設的工作區目錄。
依預設,您的工作會儲存在 $HOME/IBM/rationalsdp6.0 目錄下名為 workspace 的目錄中。
- 依預設,會取消選取請用這個作為預設值,以後不要再問我勾選框。
如果您保留預設值,您每次啟動 Rational Web Developer 時,都會開啟一個對話框,讓您切換工作區。
比方說,如果您選擇不同專案要維護不同的工作區,您可以保留這個預設值。
要訣:如果選取請利用這個作為預設值,且以後不要再問我勾選框,就不會再開啟這個對話框,Rational Web Developer 會利用上一階段作業的工作區來啟動。您可以在啟動產品之後,在視窗 > 喜好設定 > 工作台 > 啟動和關閉頁面中變更這個預設值。
工作台首先會開啟一系列的歡迎使用頁面來提供產品概觀和新增功能的相關資訊,以及通往指導教學、範例和外部 Web 資源的鏈結。
請花些時間來探索這些選項。
另外,也請注意「說明」功能表所提供的資訊來源。
如果要在 Linux 中解除安裝 Rational Web Developer,請遵循下列步驟:
- 以 root 使用者身分登入。
- 移至安裝目錄中的 rwd_prod/_uninst/ 子目錄。
- 輸入下列指令來解除安裝 Rational Web Developer:./uninstall.bin。如果您正在檔案管理員中工作,您可以按一下這個檔案來啟動解除安裝程式。
- 任何 plug-ins 或 features 目錄中的所有檔案或特性都會自動刪除,任何這些目錄中的使用者資料和協力廠商外掛程式都包括在內。不會刪除含有您的工作的工作區目錄。
會保留部分其他目錄:
- eclipse/.config 目錄會保留下來,以防您是因為發生問題而解除安裝 Rational Web Developer,且準備重新安裝在相同目錄中。
- 如果協力廠商外掛程式鏈結至您的產品,eclipse/links 目錄可能會保留下來,以防您是因為發生問題而解除安裝 Rational Web Developer,且準備重新安裝在相同目錄中。
- 會保留 /logs 目錄,以保存任何安裝產生的日誌檔的歷程。這個目錄可能含有可用來排解您遇到的安裝相關問題的資訊。
如果您試圖局部解除安裝一或多項 Rational Web Developer 必要特性,您會收到一則類似下列錯誤訊息:
選項無效:
無法解除安裝 ide_required:沒有設定解除安裝的 root
如果要暫時解決這個問題,請選取解除安裝產品勾選框。這會重新起始設定解除安裝畫面,因此,您現在可以解除安裝整個 Rational Web Developer,也可以取消選取您不要解除安裝的特性。
如果要無聲自動解除安裝 Rational Web Developer,請從命令提示字元下進入安裝目錄,然後輸入:
rwd_prod\_uninst\uninstall.bin -silent
這一節包含在 Linux 中安裝和解除安裝 Rational Web Developer 時,已知的問題和限制。
請參閱 Readme 檔,以取得會影響產品實際用法的問題和限制的相關資訊。
- 不要安裝至 Novell NetWare 磁碟機。
在 Novell NetWare 磁碟機中,安裝會失敗。
如果您在安裝 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 子目錄中。
請參閱"取消安裝合併已安裝的產品後,再嘗試重新安裝可能會無法適當地安裝產品。"。
Agent Controller 是一個常駐程式,可讓用戶端應用程式啟動及管理本端或遠端應用程式,並提供執行應用程式的相關資訊給其他應用程式。您必須先個別安裝 Agent Controller,才能使用下列工具:
- 側寫應用程式所用的側寫工具。Agent Controller 必須安裝在所側寫之應用程式的相同系統中。
- 用來匯入遠端日誌檔的記載工具。Agent Controller 必須已安裝好,且正在匯入日誌檔的來源遠端系統中執行。
- 執行 Test Case 的元件測試工具。Agent Controller 必須安裝在您執行 Test Case 的系統中。
- 用來插入探針、涵蓋程式碼和分析洩漏的執行時期分析工具。
- 註:
- Rational Web Developer 不支援這個工具。
- 在 WebSphere Application Server 5.0 或 5.1 版中進行遠端應用程式測試的工具。
(您不必為了在遠端發佈應用程式或在本端發佈或測試應用程式而安裝 Agent Controller。)
請注意,WebSphere Application Server 6.0 版已內建了這項功能,因此,6.0 版目標伺服器不需要 Agent Controller。
附註:
- 強烈建議您將 Agent Controller 安裝在防火牆後面。
- Agent Controller 在 z/OS(R) 或 OS/400(R) 中沒有網路安全功能。
- 如果需要使用 Agent Controller 時安全方面的詳細資訊,請參閱 Rational Web Developer 所附的 Agent Controller 文件。
- 在安裝軟體之前,不會安裝 Agent Controller 的線上文件。
這時會將文件新增至 Rational Web Developer 線上說明中。
- Windows、Linux/IA32:至少需要 Intel(R) Pentium(R) II 處理器。
建議使用 Pentium III 500 MHz 或以上。
- AIX(R):至少需要 PowerPC(R) 604e 233MHz(IBM RS/6000(R) 7043 43P 系列)
- HP-UX:至少需要 PA8500 300MHz (HP Workstation C3000)
- Solaris:至少需要 UltraSPARC-IIi 300MHz (Sun Ultra 10 Workstation)
- OS/400:iSeries(TM)(依照作業系統的需求)
- z/OS、LINUX/S39:zSeries(R)(依照作業系統的需求)
- 至少需要 512 MB RAM(建議使用 768 MB RAM)
- 磁碟空間:
- 顯示器解析度:
- 至少需要 800 x 600 顯示畫面(建議使用 1024 x 768)
Linux 附註:Agent Controller 的 Hyades Data Collection Engine 特性是利用 libstdc++-libc6.2-2.so.3 共用程式庫來編譯的。
請確定這個共用程式庫存在 /usr/lib 目錄下。如果不存在,您必須安裝作業系統安裝媒體所附的 RPM 套件 compat-libstdc++。
Agent Controller 已通過下列平台的測試:
- RS/6000 中的 AIX 4.3.3 版、5.1 版、5.2 版
- PA-RISC 中的 HP-UX 11.0 版、11i 版
- zSeries 中的 z/OS v1R4、v1R5
- iSeries 中的 OS/400 V5R1、V5R2
- Intel IA32 中的 Red Hat Linux 7.1 版、7.2 版、7.3 版、8.0 版
- Intel IA32 中的 Red Hat Linux Advanced Server 2.1 版
- SPARC 中的 Sun Solaris 第 8 版、第 9 版
- Intel IA32 中的 SuSE Linux 7.2 版、7.3 版
- Intel IA32 中的 SuSE Linux Enterprise Server (SLES) 第 7 版、第 8 版
- zSeries 中的 SuSE Linux Enterprise Server (SLES) 第 7 版
- Intel IA32 中的 Windows 2000 Advanced Server(服務套件 2)
- Intel IA32 中的 Windows 2000 Professional(服務套件 2)
- Intel IA32 中的 Windows 2000 Server(服務套件 2)
- Intel IA32 中的 Windows NT(R) 4.0(服務套件 6a)
- Intel IA32 中的 Windows Server 2003
- Intel IA32 中的 Windows XP Professional
Agent Controller 尚未在下列平台上測試,但應該可以在這些平台上執行:
- pSeries(R) 中的 AIX 4.33 版、5.1.0 版、5.2.0 版、5.3 版
- zSeries 中的 Connectiva Linux Enterprise Edition 1.0
- Intel IA32 中的 Connectiva Linux Enterprise Edition 1.0
- PA-RISC 中的 HP-UX 11iv1h
- Intel IA32 中的 Red Flag Advance Server 4.0 版、4.1 版
- zSeries 中的 Red Hat Linux 7.2 版
- zSeries 中的 RedHat Enterprise Linux 3.0 Update 1
- zSeries 中的 RedHat Enterprise Linux 3.0 Update 3
- zSeries 中的 SuSE 7.2 版
- Intel IA32 中的 SuSE Linux 7.1 版
- Intel IA32 中的 SuSE Linux Desktop 9.0
- Intel IA32 中的 SuSE Linux Standard Edition 9.0
- Intel IA32 中的 SuSE Linux Enterprise Server (SLES) 9
- zSeries 中的 SuSE Linux Enterprise Server 8.0、9.0
- Intel IA32 中的 TurboLinux Enterprise Server 第 8 版
- zSeries 中的 TurboLinux Enterprise Server 第 8 版
- Intel IA32 中的 United Linux 1.0 版
- zSeries 中的 United Linux 1.0 版
- Intel IA32 中的 Windows Server 2003 Standard Edition
- Intel IA32 中的 Windows Server 2003 Enterprise Edition
- Intel IA32 中的 Windows Server 2003 Datacenter Edition
- zSeries 中的 zOS 2.10
- zSeries 中的 z/OS v1R1 至 v1R3、v1R6
- zSeries 中的 z/OS.e v1R3 至 v1R6
Agent Controller 不適用於下列平台:
- iSeries 中的 Linux
- pSeries 中的 Linux
一般而言,Agent Controller 可以搭配使用 JVM 1.4 版或更新的版本。
以下是 Agent Controller 已通過測試的 JVM 版本(Java 完整版本):
- AIX:J2RE 1.4.1 IBM AIX 建置 ca1411-20040301
- HP-UX:J2RE 1.4.2.03-040401-18:59-PA_RISC2.0
- Linux IA32:J2RE 1.4.1 IBM 建置版 cxia321411-20040301;J2RE 1.4.2 IBM。
- Linux for OS/390(R):J2RE 1.4.1 IBM 建置版 cx3901411-20040301
- z/OS:J2RE 1.4.1 IBM z/OS Persistent Reusable VM 建置 cm1411-20030930
- OS/400:J2RE 1.4 IBM
- Solaris SPARC:Sun Java(TM) 2 Standard Edition(建置 1.4.2_04-b05)
- Windows:IA32 J2RE 1.4.1 IBM Windows 32 建置 cn1411-20040301a;J2RE 1.4.2 IBM Windows 32;Sun Java(TM) 2 Standard Edition(建置 1.4.2_04-b05)
Agent Controller 安裝檔在選用軟體磁碟的下列目錄中:
- AIX:/IBM_Agent_Controller/aix
- HP-UX:/IBM_Agent_Controller/hpux
- OS/400:/IBM_Agent_Controller/os400
- Linux/S390:/IBM_Agent_Controller/linux_s390
- Linux/IA32:/IBM_Agent_Controller/linux_ia32
- Solaris:/IBM_Agent_Controller/solaris_sparc
- Windows:\IBM_Agent_Controller\win_ia32
- z/OS:/IBM_Agent_Controller/os390
如果您有舊版的 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
- 以管理者(或 root)身分登入。
- Windows:如果您是從 Rational Web Developer 安裝 CD 來安裝 Agent Controller,請從「啟動程式」視窗中選取安裝 Agent Controller(如果停用自動執行功能,請從安裝 CD 的根目錄執行 lauchpad.exe)。
繼續執行步驟 5。
- 切換至適當平台的安裝媒體所在目錄。
- 執行 setup.exe 程式。如果是非 Windows 平台,請執行 setup.bin。
- 在歡迎畫面上按下一步以繼續。
- 繼續進行安裝之前,請先關閉所有的 Eclipse 平台。按下一步以繼續。
- 閱讀授權合約。
- 選取核准,然後按下一步以繼續。
- 這時會通知您將移除任何現有的 Agent Controller。按下一步以繼續。
- 指定 Agent Controller 的安裝路徑,再按下一步繼續作業。
- 選取您要安裝的 Agent Controller 特性:
- Hyades Data Collection Engine - Eclipse 開放程式碼專案提供的組織架構,可用來啟動及側寫本端或遠端 Java 應用程式。
- IBM Rational 外掛程式 - 您必須選取這項特性,才能選取這份清單中的其餘特性。
- 記載 - 用於側寫及追蹤應用程式的事件型記載組織架構。如果選取了「元件測試」或「WebSphere Application Server 的遠端支援」,這就是必要選項。
- 元件測試 - 手動測試啟用功能的舊式支援。
- 執行時期分析 - 用於探測插入項目、程式碼涵蓋面和分析洩漏的功能。
- 註:
- Rational Web Developer 不支援這項特性,將不會安裝它。
- 安全 - 可供您在 Eclipse 工作台和 Agent Controller 之間建立安全的資料通訊通道。
- WebSphere Application Server 的遠端支援 - 連接遠端 WebSphere Application Server 5.0 或 5.1 版,以執行諸如部署、管理和效能分析等活動的功能。請注意,WebSphere Application Server 6.0 版已經內建了這些功能。
按下一步以繼續。
- 指定 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 啟動。
- 選用:如果選取了「WebSphere Application Server 的遠端支援」,請指定 IBM WebSphere Application Server 5.0 版(只限 Windows)和 5.1 版的路徑。
- 指定哪些主機可以存取 Agent Controller。其選項如下:
- 任何電腦:允許任何用戶端存取 Agent Controller。
(預設選項。)
- 只限這部電腦:只允許本端主機存取 Agent Controller。
- 特定電腦:允許指定的用戶端清單存取 Agent Controller。請使用逗點來分隔清單中的主機名稱。
按下一步以繼續。
- 如果在前述步驟 9 中選取了「安全」:請選擇安全設定。
按下一步以繼續。
- 在摘要畫面上按下一步以繼續。
- 在檔案轉送完成後,按一下完成。
您可以在安裝指令中使用下列參數來無聲執行安裝程序:
| 參數
| 說明
|
| 必要參數
|
|
-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 系統服務 (RAService.exe)。
- 利用控制台下的「Windows 服務」對話框來啟動或停止 Agent Controller 服務(開始 > 設定 > 控制台 > 系統管理工具 > 服務 > IBM Rational Agent Controller)。
- 在非 Windows 平台中,不會自動啟動 Agent Controller 程序 (RAServer)。
您必須自行啟動它。
- 重要事項:非 Windows 平台的下列環境設定必須在啟動 Agent Controller 之前設定。
- 如果要啟動 Agent Controller 程序,請切換至安裝位置的 bin 目錄(如
/opt/IBM/AgentController/bin),再執行
./RAStart.sh
- 如果要停止 Agent Controller 程序,請切換至安裝位置的 bin 目錄(如
/opt/IBM/AgentController/bin),再執行
./RAStop.sh
- 您可以從「控制台」下的新增/移除程式對話框來移除 Agent Controller。
- 如果要執行無聲自動解除安裝,請從安裝位置的 _uninst 目錄(如 C:\Program Files\IBM\AgentController\_uninst)中,執行 uninstall.exe -silent 指令。
- 從安裝位置的 _uninst 目錄(如 /opt/IBM/AgentController/_uninst)中,執行 uninstall.bin 程式。
- 遵循畫面中的指示完成解除安裝。
- 如果要執行無聲自動解除安裝,請使用 uninstall.bin -silent 指令。
如果您有舊版的 Agent Controller 或從 Hyades Data Collection Engine 衍生而來的任何軟體,請先將它停止和解除安裝,之後再安裝這個版本。
- 在 iSeries 主機中,建立一個名稱為 HYADESDC 的程式庫和另一個稱為 IBMRAC 的程式庫:
CRTLIB HYADESDC
CRTLIB IBMRAC
- 在 iSeries 主機的 HYADESDC 程式庫中,建立一個稱為 HYADES400.SAVF 的空保存檔:
CRTSAVF HYADESDC/HYADESDC
- 在 iSeries 主機的 IBMRAC 程式庫中,建立一個稱為 IBMRAC.SAVF 的空保存檔:
CRTSAVF IBMRAC/IBMRAC
- 利用 FTP 將安裝 CD 中的 IBMRAC.SAVF 檔新增至採用 BINARY 模式轉送之 iSeries 主機的 IBMRAC 程式庫中。
- 利用 FTP 將安裝 CD 中的 HYADESDC.SAVF 檔新增至採用 BINARY 模式轉送之 iSeries 主機的 HYADESDC 程式庫中。
- 輸入下列指令,將在 iSeries 主機的保存檔 HYADESDC.SAVF 還原到 HYADESDC 程式庫中:
RSTOBJ OBJ(*ALL) SAVLIB(HYADESDC) DEV(*SAVF) SAVF(HYADESDC/HYADESDC)
- 輸入下列指令,將在 iSeries 主機的保存檔 IBMRAC.SAVF 還原到 IBMRAC 程式庫中:
RSTOBJ OBJ(*ALL) SAVLIB(IBMRAC) DEV(*SAVF) SAVF(IBMRAC/IBMRAC)
- 啟動 QShell,在整合式檔案系統 (IFS) 中建立 /opt/hyadesdc 目錄。
- 將 HYADESDC 中的保存檔 HYADESIFS.SAVF 還原到 IFS 目錄 /opt/hyadesdc 中。例如:
RST DEV('/QSYS.LIB/HYADESDC.LIB/HYADESIFS.FILE') OBJ('/opt/hyadesdc/*')
- 將 IBMRAC 中的保存檔 IBMRACIFS.SAVF 還原到 IFS 目錄 /opt/hyadesdc 中。比方說,在一行中輸入以下指令:
RST DEV('/QSYS.LIB/IBMRAC.LIB/IBMRACIFS.FILE') OBJ('/opt/hyadesdc/*') ALWOBJDIF(*ALL)
- 安裝好 Agent Controller 之後,請將目錄切換至安裝位置的 bin 目錄
/opt/hyades/bin,再輸入下列指令來執行安裝 Script:
./SetConfig.sh
- 遵循畫面中的提示來配置 Agent Controller。
- 如果要啟動 Agent Controller,請將 HYADESDC 和 IBMRAC 程式庫新增至程式庫清單中:
ADDLIBLE HYADESDC
ADDLIBLE IBMRAC
- 輸入下列指令來送出 RAStart 工作:
SBMJOB CMD(CALL RASERVER) JOBD(RASTART)
- 如果要停止 Agent Controller,請輸入下列指令來終止 RAStart 工作:
ENDJOB JOB(RASTART)
- 移除 HYADESDC 和 IBMRAC 程式庫。
- 移除 IFS 目錄 /opt/hyadesdc(包括所有子目錄和檔案)。
如果您有舊版的 Agent Controller 或從 Hyades Data Collection Engine 衍生而來的任何軟體,請先將它停止和解除安裝,之後再安裝這個版本。
- 在 UNIX(R) 系統服務 Shell 中,移至您要安裝 Agent Controller 的目錄。
建議您將它安裝在 /usr/lpp/ 目錄中。
- 將安裝影像 ibmrac.os390.pax 轉送至安裝目錄。
- 發出下列指令來擷取 Agent Controller 檔:
pax -ppx -rf ibmrac.os390.pax
- 將目錄切換至安裝 bin 目錄 /usr/lpp/IBM/AgentController/bin,再輸入下列指令來執行 makelinks Script:
./createLinks.sh
- 在 UNIX(R) 系統服務 Shell 中發出下列指令來控制 Agent Controller 共用物件檔程式:
extattr +p /usr/lpp/IBM/AgentController/lib/*.so
- 安裝好 Agent Controller 之後,請將目錄切換至安裝位置的 bin 目錄
/usr/lpp/IBM/AgentController/bin,再輸入下列指令來執行安裝 Script:
./SetConfig.sh
- 遵循畫面中的提示來配置 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。
附註: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
- 以 root 使用者身分登入,開啟 /usr/lpp/IBM/AgentController/bin 目錄,發出下列指令來啟動伺服器:
./RAStart.sh
- 如果要停止伺服器,請以 root 使用者身分登入,開啟 /usr/lpp/IBM/AgentController/bin 目錄,發出下列指令:
./RAStop.sh
下列清單包含在所有平台中使用 Agent Controller 安全特性的提示和要訣:
- 鑑別由作業系統提供。
只有安裝時指定的使用者可以鑑別。
如果提供使用者名稱 ANY,任何有效的使用者名稱和密碼配對都會轉遞給作業系統進行鑑別,否則,只會轉遞列出的配對。
- 當啟用安全時,您在安裝時指定的使用者必須接受作業系統的鑑別,之後,才能與 Agent Controller 交換任何資訊。工作台使用者必須提供有效的使用者名稱和密碼組合,那是一個作業系統使用者名稱和密碼。
- (只適用於 Windows)不鑑別網域名稱密碼。您必須提供本端使用者名稱和密碼配對。
- 沒有提供任何金鑰管理功能。Agent Controller 的安全使用 Java 金鑰儲存庫。
- 預設金鑰儲存庫和匯出的憑證位於 Agent Controller 目錄 \plugins\com.ibm.etools.pd.security\security (Windows) 或 /plugins/com.ibm.etools.pd.security/security (Linux) 中。這些只是範例而已。
您應該將這些改成包含有意義的憑證的金鑰儲存庫。
這一節討論關於安裝和解除安裝 Agent Controller 的已知問題和限制。除非另有說明,否則,下列資訊適用於支援使用 Agent Controller 的所有作業系統。
Agent Controller 可能無法在非 Windows 平台中啟動,且會出現下列訊息:
無法啟動 RAServer。
這個失敗通常是在 TCP/IP 埠 10002 無法使用時造成的。
依預設,Agent Controller 會利用這個埠來接聽。
可能是 Agent Controller 啟動時,系統中所執行的其他程序正在使用這個埠,也可能是 Agent Controller 剛停止,
又在埠釋出之前重新啟動。
如果 Agent Controller 無法啟動,您可以依照下列方式來啟動它:
- 如果有另一個程序在使用 10002 埠,您可以編輯 serviceconfig.xml 檔變更這個埠號。
文件中有這方面的說明。
- 註:
- 如果 serviceconfig.xml 檔中配置的通訊埠號已經變更,WebSphere Application Server 配置中所定義的 INSTANCE_RAC_PORT_NUM_ID 內容也必須改成相同的埠號。
- 如果 Agent Controller 剛停止,請等幾分鐘,再嘗試重新啟動它。
如果您在安裝或解除安裝期間發生錯誤,這可能是因為執行中的程序已載入 Agent Controller 的物件檔。
如果要確保這些物件檔是可修改的,請執行下列動作:
- 關閉 Rational Web Developer。
- 終止所有含 Java 側寫代理程式或 J2EE 要求側寫程式的 java.exe 程序。
依預設,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 外掛程式都必須先啟用,之後才能使用。
如果要啟用外掛程式,請執行下列動作:
- 從 Rational Web Developer 功能表中,選取視窗 > 喜好設定。
- 在「喜好設定」頁面的「工作台」下,按一下功能。
- 在「功能」視窗中,捲至團隊,再按一下您想啟用之配接器的勾選框。
- 按一下套用,再按一下確定。
當共用專案時,您也可以選取所需要的團隊儲存庫提供者來啟用外掛程式。
不管是 Rational ClearCase 用戶端或伺服器,還是 CVS 伺服器都不會自動安裝。您必須在 Rational Web Developer 之外,個別安裝它們。
如果要搭配其他可用的 SCM 系統來使用 Rational Web Developer,您會需要 SCM 產品的特定配接器。SCM 配接器通常是由 SCM 產品供應商提供。IBM 不為其他 SCM 配接器提供任何保證或背書。
如果需要其他 SCM 產品之配接器的支援或進一步的資訊,請直接洽詢產品供應商。
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)。
Rational Web Developer 支援下列 Rational ClearQuest(R) 版本:
- Rational ClearQuest v2003.06.13 (SR3)
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,您必須先執行下列動作:
- 安裝 Rational Web Developer。
- 安裝和配置基本 Rational ClearQuest 應用程式(2003.06.13 版)。請聯絡區域 Rational ClearQuest 管理者來瞭解如何安裝和配置 Rational ClearQuest 用戶端應用程式以及建立資料庫連線。
請造訪 www.ibm.com/support/docview.wss?uid=swg24007802,以取得下載 Rational ClearQuest Client for Eclipse 的相關資訊。請參閱這個 URL 所提供的 Readme 檔來取得完整的安裝指示。
依預設,WebSphere Application Server 6.0 會隨著 Rational Web Developer 而自動安裝。如果您要開發在 5.x 應用程式伺服器中執行的應用程式,您可以選擇性地安裝其他執行時期測試環境。
您必須先安裝 Rational Web Developer,之後,才能安裝其他執行時期測試環境。
您可以選擇安裝下列整合測試環境:
- WebSphere Application Server 5.1
- WebSphere Application Server Express 5.1
-
WebSphere Application Server 5.0.2
-
WebSphere Application Server Express 5.0.2
如果要安裝一或多種舊版整合測試環境,請遵循下列步驟:
- 從 Rational Web Developer 啟動程式中,按一下安裝 WebSphere 測試環境 5.x 版。這時會開啟 IBM Rational 5.x 整合測試環境安裝程式。
- 按下一步。
- 接受授權合約,然後按下一步。
- 選取您要安裝的整合測試環境。按下一步。
- 檢視摘要資訊,然後按下一步開始安裝。這項摘要安裝會包括測試環境的安裝位置。
- 安裝好之後,按一下完成以結束安裝程式。
- 註:
- 如果您安裝內嵌傳訊和佇列作業支援特性,您必須先解除安裝內嵌傳訊和佇列作業特性,
才能解除安裝 WebSphere 5.x 版測試環境。

若要在 Windows 解除安裝 5.x 版測試環境,請遵循下列步驟:
- 開啟控制台。
- 按一下新增/移除程式。
- 按一下 IBM Rational 5.x 舊式整合測試環境,再按一下變更/移除。
- 這時會開啟 IBM Rational 5.x 測試環境解除安裝程式。按下一步。
- 選取您要解除安裝的測試環境,按下一步。
- 檢視摘要資訊,按下一步。
- 解除安裝好測試環境之後,按一下完成來結束解除安裝程式。

若要在 Linux解除安裝舊式測試環境,請遵循下列步驟:
- 以 root 使用者身分登入。
- 移至安裝目錄中的 lte_prod/_uninst 子目錄。
- 輸入下列指令來解除安裝 5.x 版測試環境:./uninstall.bin。
如果您正在檔案管理員中工作,您可以按一下這個檔案來啟動解除安裝程式。
- 這時會開啟 IBM Rational 5.x 測試環境解除安裝程式。按下一步。
- 選取您要解除安裝的測試環境,按下一步。
- 檢視摘要資訊,按下一步。
- 解除安裝好測試環境之後,按一下完成來結束解除安裝程式。
Rational Product Updater 是一個工具,用來追蹤系統所安裝的所有 Rational 軟體開發產品及搜尋和安裝產品更新項目及選用的新特性。
您安裝的第一個 Rational 軟體開發產品會自動安裝 Product Updater。這個工具會自動登錄後來安裝的所有 Rational 軟體開發產品。
您可以搜尋和自動安裝這些產品的下列各種更新項目:
- 產品更新項目,如修正套件、增補套件和臨時修正程式。
- 提供新功能的選用特性。
更新項目之間的任何相依關係都會自動強制施行。
Product Updater 可讓您利用單一位置來管理所有 Rational 軟體開發產品的更新。
它甚至會更新其本身。
Product Updater 也可讓您執行下列作業:
- 產生已安裝的 Rational 軟體開發產品的詳細清單,其中包括安裝了哪些修正程式和選用特性的相關資訊。
- 建立一或多個本端 (Proxy) 產品更新項目網站,使組織中的使用者不需要從網際網路安裝更新項目。
請參閱 Product Updater 的說明系統,以取得如何使用這個工具的相關資訊,存取方法如下:
- 如果要啟動 Product Updater,請在 Rational Web Developer 中,選取說明 > 軟體更新 > IBM Rational Product Updater。
- 在 Product Updater 中,選取說明 > 說明內容。
請參閱版權和注意事項