IBM Rational Application Developer 7.0 版

安裝手冊

7.0 版

附註

使用本資訊及支援的產品之前，請先閱讀注意事項。

第一版（2006 年 12 月）

本版適用於 IBM Rational Application Developer 7.0 版（產品編號 5724-J19）及所有後續的版次和修訂，除非新版中另有指示。

概觀

本安裝手冊提供安裝和解除安裝 IBM^(R) Rational^(R) Application Developer 的指示。

如需安裝問題和限制的相關資訊，請參閱 Readme 檔。

註:

如需最新的文件和疑難排解資訊，請參閱http://www.ibm.com/software/rational/support/documentation/。

IBM Installation Manager

IBM Installation Manager 可協助您在工作站安裝 Rational Application Developer 安裝套件。也可協助您更新、修改及解除安裝本產品及其他已安裝的套件。套件是指專門由 Installation Manager 安裝的一項產品、一群元件或單一元件。

不論您依循何種安裝情境在工作站安裝 Rational Application Developer，請一律使用 Installation Manager 來安裝 Rational 套件。

IBM Installation Manager 提供許多節省時間的特性。可追蹤您將安裝什麼、已安裝的軟體元件及可供安裝的元件。也會搜尋更新項目，讓您知道您安裝的是最新版的 Rational 版本套件。Installation Manager 也提供工具來管理已安裝產品套件的授權。有提供更新和修改套件的工具。您也可以使用 Installation Manager 來解除安裝產品套件。

IBM Installation Manager 包含五個精靈，讓您在產品套件的整個生命週期內輕鬆維護：

「安裝套件」精靈會引導您完成安裝過程。在安裝產品套件時，您可以接受預設值，或修改預設值來建立自訂安裝。安裝產品套件之前會出現一個完整的摘要，顯示您在整個精靈中已設定的選項。精靈可讓您一次安裝一或多個產品套件。
「更新套件」精靈會為您已安裝的產品套件搜尋可用的更新項目。更新項目可能是已發行的修正程式、新特性或新版的 Rational 產品。精靈中也提供詳細的更新內容。您可以決定是否套用某一項更新。
「修改套件」精靈可讓您修改已安裝的套件的特定元素。在初次安裝產品套件時，請選取您想要安裝的特性。如果後來發現還需要其他特性，您可以利用「修改套件」精靈，在產品套件安裝選項中加入這些特性。您也可以移除特性及新增或移除語言。

「管理授權」精靈可協助您設定套件的授權。請利用此精靈將試用軟體授權改為完整授權、設定伺服器的浮動授權及選取每一個套件的授權類型。
「解除安裝套件」精靈可協助您從電腦中移除產品套件。一次可以解除安裝多個套件。

IBM Rational Software Development Platform

IBM Rational Software Development Platform 是一個通用開發環境，內含開發環境及共用多項產品的其他軟體元件。

開發平台包含下列項目：

Rational Application Developer
Rational Application Developer Community Edition
Rational Functional Tester
Rational Performance Tester
Rational Software Architect
Rational Software Modeler
Rational Systems Developer

另外還有 Rational Manual Tester，但不是平台的一部分。Manual Tester 隨附於 Rational Functional Tester，也可以另外購買。

關於 Rational Application Developer

IBM Rational Application Developer for WebSphere^(R) Software 是一個綜合性的整合開發環境，對 J2EE 程式設計模型提供完整的支援，包括加速開發 Web、Java^(TM)、Web 服務及 Enterprise JavaBeans^(TM) (EJB)。

IBM Support Assistant (ISA) 是一個免費的本端軟體實用性工作台，適用於 Linux^(R) 作業系統，可協助您解決 IBM 軟體產品的問題。可快取取得相關的支援資訊及有助於問題判斷的實用性工具。如需相關資訊，請參閱 http://www.ibm.com/software/support/isa/。

安裝需求

本節詳細說明硬體、軟體及使用者專用權需求，必須符合這些需求，才能順利安裝和執行軟體。

硬體需求

必須確認系統符合最小硬體需求，才能安裝產品。

硬體	需求
處理器	至少：800 MHz Pentium^(R) III（愈高愈好）
記憶體	最小：1 GB RAM
磁碟空間	最小：安裝產品套件需要 2 GB 的磁碟空間。您開發的資源還需要額外的磁碟空間。註: 磁碟空間需求可增減，視您安裝的特性而定。如果是下載產品套件來安裝本產品，則需要額外的磁碟空間。如果使用 FAT32 而非 NTFS，則需要額外的磁碟空間。指向環境變數 TEMP 的目錄需要額外 500 MB 磁碟空間。 /tmp 目錄需要額外 500 MB 的磁碟空間。
顯示器	至少 1024 x 768 解析度和 256 色（愈高愈高）
其他硬體	Microsoft^(R) 滑鼠或相容的指向裝置

軟體需求

必須確認系統符合軟體需求，才能安裝產品。

作業系統

本產品支援下列作業系統：

Microsoft Windows^(R) XP Professional Service Pack 1 或 2
Windows XP Professional x64 Edition （在 AMD 處理器上執行）
Microsoft Windows 2000 Professional Service Pack 4
Microsoft Windows 2000 Server Service Pack 4
Microsoft Windows 2000 Advanced Server Service Pack 4
Microsoft Windows Server 2003 Standard Edition Service Pack 1
Microsoft Windows Server 2003 Enterprise Edition Service Pack 1
Red Hat Enterprise Linux Workstation 4.0 版
Red Hat Desktop 4.0 版（以 32 位元模式執行）
SuSE Linux Enterprise Server (SLES) 第 9 版（所有服務套件；以　32 位元模式執行）

註:

列出的作業系統支援 Rational Application Developer 支援的所有語言。

註:

這一版的 IBM Rational Software Development Platform 適用於 Eclipse ID 3.2.1 或更新版本。您只能延伸現有的 IDE 3.2.1 版或更新版本。

其他軟體需求

GNU Image Manipulation Program Toolkit (GTK+) 2.2.1 版或更新版本及相關的程式庫（GLib、Pango）。
下列其中一個 Web 瀏覽器，可查閱 README 檔和安裝手冊，且支援 Standard Widget Toolkit (SWT) 瀏覽器小組件：
- Microsoft Internet Explorer 6.0 Service Pack 1。
- Mozilla 1.6 或 1.7。
- Firefox 1.0.x 或 1.5。
  註:
  
  在 Red Hat Enterprise Linux Workstation 4.0 版中，可能必須將環境變數 MOZILLA_FIVE_HOME 設為 Firefox 的安裝資料夾。例如，setenv MOZILLA_FIVE_HOME /usr/lib/firefox-1.5。
為了正常檢視多媒體使用者輔助影片，例如導覽、指導教學及示範 Viewlet，您必須安裝 Adobe Flash Player。
- 6.0.65 版或更新版本
- 6.0.69 版或更新版本
如需支援的資料庫伺服器、Web 應用程式伺服器及其他軟體產品的相關資訊，請參閱線上說明。

使用者專用權需求

您必須有符合下列需求的使用者 ID，才能安裝 Rational Application Developer。

使用者 ID 不能含有雙位元組字元。
您的使用者 ID 必須屬於 Administrator 群組。
您必須能夠以 root 身分登入。

規劃安裝

開始安裝任何產品特性之前，請先閱讀本節的所有主題。確實規劃和了解安裝程序的重點有助於確保安裝成功。

安裝實務

安裝 Rational Application Developer 時，有許多實務可供選擇。

下列是可能決定安裝實務的一些因素：

安裝檔的格式和存取方法（例如，使用 CD 或從 IBM Passport Advantage^(R) 下載的檔案）。
安裝位置（例如，安裝在自己的工作站，或將安裝檔放在企業內供人取用）。
安裝類型（例如，利用 Installation Manager GUI 或執行無聲自動安裝）。

以下是您可能依循的一般安裝實務：

從 CD 安裝。
從已下載至工作站的電子映像檔來安裝。
從共用磁碟機上的電子映像檔來安裝。
從 HTTP 或 HTTPS 伺服器上的儲存庫來安裝。

請注意，在最後三個實務中，您可以選擇以無訊息模式執行 Installation Manager 程式來安裝 Rational Application Developer。如需以無訊息模式執行 Installation Manager 的詳細資料，請參閱無聲自動安裝。

從 CD 安裝

在此安裝實務中，您有內含產品套件檔的 CD，且通常將 Rational Application Developer 安裝在自己的工作站。如需步驟概觀，請參閱從 CD 安裝 Rational Application Developer：作業概觀。

從已下載至工作站的電子映像檔來安裝

在此實務中，您已從 IBM Passport Advantage 下載安裝檔，且將在自己的工作站安裝 Rational Application Developer。如需步驟概觀，請參閱從工作站上的電子映像檔來安裝 Rational Application Developer：作業概觀。

從共用磁碟機上的電子映像檔來安裝

在此實務中，您會將電子映像檔放在共用磁碟機上，方便企業內的使用者從單一位置上取得 Rational Application Developer 的安裝檔。如需步驟概觀，請參閱從共用磁碟機上的電子映像檔來安裝 Rational Application Developer：作業概觀。

從 HTTP 伺服器上的儲存庫來安裝

此實務是透過網路來安裝產品的最快方式。此實務不同於共用磁碟機安裝，為了將 Rational Application Developer 的產品套件檔放在 HTTP Web 伺服器上，您必須使用此公用應用程式 - IBM Packaging Utility。此公用程式由 Rational Application Developer 提供，可用套件格式來複製安裝檔，適用於直接從 HTTP Web 伺服器安裝 Rational Application Developer。 HTTP Web 伺服器上含有套件的目錄稱為儲存庫。請注意，在此實務中，Rational Application Developer 專用的安裝檔也放在套件中。如需步驟概觀，請參閱從 HTTP Web 伺服器上的儲存庫來安裝 Rational Application Developer：作業概觀和將 Rational Application Developer 放在 HTTP Web 伺服器：作業概觀。

決定要安裝的特性

在 7.0 版中，您可以選取所要安裝的 Rational Application Developer 特性，來自訂您的軟體產品。

當您使用 IBM Installation Manager 來安裝 Rational Application Developer 產品套件時，安裝精靈會顯示可用產品套件中的特性。在特性清單中，您可以選取所要安裝的特性。系統會為您選取一組預設的特性（包括任何必要的特性）。Installation Manager 會自動維持特性之間的相依關係，以防您清除任何必要特性。

註:

在套件安裝完成後，您仍可在 Installation Manager 中執行「修改套件」精靈，以便在您的軟體產品中新增或移除特性。如需相關資訊，請參閱修改安裝。

特性

下表顯示您可選擇安裝的 Rational Application Developer 特性。預設要安裝的特性選擇可能不同。如果某一項特性已存在共用的資源目錄中，則依預設不會選取，不會再安裝一次。

特性	說明	依預設選擇安裝的特性
Web 開發工具	提供工具，以使用 JavaServer Faces、JavaServer Pages、Servlets 及 HTML 來建置 J2EE Web 應用程式。	是
Struts 工具	提供工具，以使用 Apache Struts 架構來開發 J2EE Web 應用程式。	否
Crystal Reports 工具	提供視覺化工具，以開發需要 Crystal Reports 所提供之報告功能的應用程式。	是
J2EE 和 Web 服務開發工具	提供工具來開發 J2EE 應用程式和 Web 服務。	是
Java 用戶端應用程式編輯器	提供工具，以使用 SWT、AWT 或 Swing UI 程式庫來建置和測試圖形式使用者介面 Java 用戶端應用程式。	是
視覺化編輯器	提供圖形編輯環境來建立 Java 類別、C++ 程式碼、Enterprise Bean、資料表及 XML 綱目。	是
程式碼複查	檢查您的程式碼是否符合規則和最佳實務。程式碼複查可指出潛在問題，並建議如何變更程式碼來改善品質。在某些情況下可自動套用修正以達標準。	是
測試和效能工具平台 (TPTP)	提供 Eclipse 工具來測試應用程式。工具能力包括側寫、監視、記載、元件測試 (Junit) 及靜態分析或程式碼複查。	是
J2EE Connector (J2C) 工具	提供一套完整的工具，協助您建立 CICS^(R) 和 IMS^(TM) 系統的 J2C 用戶端應用程式。利用資料連結精靈來建立 COBOL、PL/I 及 C 語言的 Java 轉置程式碼。	否
Rational ClearCase^(R) SCM 配接器	提供 IBM Rational ClearCase SCM 和 ClearCase MVFS 外掛程式，以便能將軟體構件的受管理版本建立在 ClearCase 版本化物件庫 (VOB) 中。如果也有安裝 ClearCase VOB 和視圖伺服器，這些外掛程式會使用 Snapshot 視圖和動態視圖。	是
Rational RequisitePro^(R) 整合（僅適用於 Windows）	提供密切整合的需求管理工具，在已安裝 IBM Rational RequisitePro 的情況下，可追蹤需求和軟體構件之間的關係。	否
Rational Unified Process^(R) (RUP^(R)) 程序顧問和程序瀏覽器	提供「程序顧問」，而在開發軟體和使用 IBM Rational Software Development Platform 方面提供和環境定義相關的指引，此外亦提供「程序瀏覽器」，以顯示現行作業、構件及工具的相關說明。	是
轉換編寫	提供工具來建立自訂的轉換及自訂現有的轉換。轉換可自動產生模型內容和實作程式碼作業。	否
外掛程式開發環境 (PDE)	提供工具來建立、開發、測試、除錯及部署可延伸 Eclipse 環境的 Eclipse 外掛程式。	否
Java Emitter Template (JET) 延伸	利用 JET 技術延伸特性，您可以開發 JET 轉換，透過程式設計介面 (API)、延伸點及公用程式來控制 JET 引擎。	否
資料工具	提供關聯式資料庫工具來定義和使用資料庫。您可以定義和使用表格、概略表及過濾器；也可以建立和使用 SQL 陳述式、DB2^(R) 常式及 SQLJ 檔案。您也可以利用工具來產生 SQL DDL、DADX 及 XML 檔案。	否
入口網站工具	提供工具來建立、自訂、測試、除錯及部署入口網站應用程式。入口網站開發工具支援 IBM WebSphere Portal 5.1 和 6.0 版。	否
WebSphere Application Server 開發工具	提供 WebSphere Application Server 開發的工具。	是
WebSphere Application Server 編譯時期相依關係	提供必要元件，以建置、編譯、除錯及部署 IBM WebSphere Application Server 的應用程式。	是
IBM WebSphere Application Server Express 5.1 版	提供 IBM WebSphere Application Server Express 5.1 版作為目標執行時期環境。	否
IBM WebSphere Application Server 5.1 版	提供 IBM WebSphere Application Server 5.1 版作為目標執行時期環境。	否
IBM WebSphere Application Server 6.0 版	提供 IBM WebSphere Application Server 6.0 版作為目標執行時期環境。	否
IBM WebSphere Application Server 6.1 版	提供 IBM WebSphere Application Server 6.1 版作為目標執行時期環境。	是

升級和共存性注意事項

如果您已安裝舊版產品，或者您想將多份 Rational Software Development Platform 產品安裝在相同工作站上，請閱讀本節資訊。

供應項目共存性注意事項

某些產品被設計成當安裝在相同套件群組中時，可彼此共存並共用功能。套件群組是一個可讓您安裝一或多個軟體產品或套件的位置。在您安裝每一個套件時，您將選取要將套件安裝在現有的套件群組中或者要新建一個。IBM Installation Manager 會封鎖未設計成共用或不符合版本容錯與其他需求的產品。如果您想一次安裝多個產品，這些產品必須能夠共用套件群組。

本文發表之際，當將以下產品安裝到套件群組時，這些產品可共用功能：

Rational Application Developer
Rational Software Architect
Rational Functional Tester
Rational Performance Tester
Rational Software Modeler
Rational Systems Developer

可安裝到套件群組的合格產品數量不限。當安裝產品時，其功能可供套件群組中的其他所有產品共用。如果您將開發產品和測試產品安裝到一個套件群組中，只要您啟動其中一個產品，即可在您的使用者介面中同時使用到開發和測試功能。如果您新增一個具有建模工具的產品，套件群組中的所有產品即同時具備開發、測試和建模功能。

如果您安裝開發產品，且之後購買了功能更多的開發產品，然後將該產品加到相同的套件群組中，則這兩個產品將同時具備新增的功能。如果您解除安裝具備較強功能的產品，原來的產品仍保有該功能。請注意，這是 Rational Software Development Platform 群組中之第 6 版產品在「升級」行為方面的一項變更。

註:

每一個安裝至唯一位置的產品可能只會有一個相關聯的套件群組。產品必須安裝至多個位置，才能有多個相關聯的套件群組。Rational Functional Tester 和 Rational Performance Tester 在一部電腦上只能安裝至一個位置中。

升級注意事項

您不能將已安裝在您工作站上的舊版 Rational Application Developer 變更為 7.0 版。不過， Rational Application Developer 7.0 版可和舊版共存。

您可以將工作區、專案和構件從 WebSphere Studio Developer 5.1.2 版和 Rational Application Developer 6.0 版，移轉至 7.0 版。詳細資料請參閱線上說明中的移轉文件。

請注意，在您第一次啟動 Rational Application Developer 第 7 版時，它會預設成新工作區。在您閱讀移轉文件前，請勿在 Rational Application Developer 7.0 版中開啟現有的工作區。

如果您已安裝舊版 Agent Controller，請先停止並解除安裝它，並清除任何遺留的檔案，然後再安裝這個版本的 Agent Controller。如需相關資訊，請參閱第 6 章「安裝 Agent Controller」。

安裝儲存庫 (IR)

IBM Installation Manager 會從指定的儲存庫位置中擷取產品套件。

如果以「啟動程式」來啟動 Installation Manager，儲存庫資訊會傳給 Installation Manager。如果直接啟動 Installation Manager，則必須指定安裝儲存庫 (IR)，內含您要安裝的產品套件。請參閱在 Installation Manager 中設定儲存庫喜好設定。

有些組織會將自己的產品套件封裝起來放在企業內部網路上。如需這種安裝實務的相關資訊，請參閱從 HTTP 伺服器上的儲存庫來安裝。系統管理者必須提供正確的 URL 給您。

根據預設值，IBM Installation Manager 會利用每一個 Rational 軟體開發產品內含的 URL 來連接網際網路上的儲存庫伺服器。接著，Installation Manager 會搜尋產品套件及新的特性。

在 Installation Manager 中設定儲存庫喜好設定

如果從「啟動程式」開始安裝 Rational Application Developer， IBM Installation Manager 在啟動時會自動定義您所安裝的產品套件所在的儲存庫位置。但如果直接啟動 Installation Manager（例如，從 Web 伺服器上的儲存庫安裝 Rational Application Developer），則必須先在 Installation Manager 中指定儲存庫喜好設定（含產品套件的目錄 URL），才能安裝產品套件。請在「喜好設定」視窗的「儲存庫」頁面指定這些儲存庫位置。根據預設值，Installation Manager 會使用每一個 Rational 軟體開發產品內含的 URL，透過網際網路來連接儲存庫伺服器，並搜尋可安裝的套件和新的特性。您的組織可能要求您將儲存庫重新導向來使用企業內部網站。

註:

開始執行安裝程序之前，請記得向管理者查詢安裝套件儲存庫 URL。

若要在 Installation Manager 中新增、編輯或移除儲存庫位置：

啟動 Installation Manager。
在 Installation Manager 的「開始」頁面上，按一下檔案 -> 喜好設定，然後按一下儲存庫。這時會開啟「儲存庫」頁面，顯示任何可用的儲存庫、位置及是否可存取。
在「儲存庫」頁面上，按一下新增儲存庫。
在「新增儲存庫」視窗中，鍵入儲存庫位置的 URL，或瀏覽至儲存庫來設定檔案路徑。
按一下確定。如果是輸入 HTTPS 儲存庫位置，則會提示您輸入使用者 ID 和密碼。列出新的或變更的儲存庫位置。如果無法存取儲存庫， 可存取的直欄中會顯示紅色的 x 記號。
按一下確定來結束。

套件群組和共用資源目錄

使用 IBM Installation Manager 來安裝 Rational Application Developer 套件時，您必須選擇套件群組和共用資源目錄。

套件群組

在安裝過程中，您必須指定 Rational Application Developer 套件的套件群組。套件群組代表一個目錄，同一群組的套件在此目錄中共用資源。使用 Installation Manager 來安裝 Rational Application Developer 套件時，您可以建立新的套件群組，或將套件安裝至現有的套件群組。（有些套件可能無法共用套件群組，此時，使用現有套件群組的選項會停用。）

請注意，同時安裝多個套件時，所有套件會安裝至相同的套件群組。

套件群組的名稱會自動指定，但您必須選擇套件群組的安裝目錄。

順利安裝產品套件來建立套件群組之後，就不能再變更安裝目錄。安裝目錄包含安裝至套件群組中的 Rational Application Developer 產品套件的特定檔案和資源。在產品套件中，其他套件群組可能使用的資源會放在共用資源目錄中。

共用資源目錄

共用資源目錄是安裝構件所在的目錄，可供一或多個產品套件群組使用。

重要:

您只有一次機會指定共用資源目錄：第一次安裝套件時。建議您使用最大的磁碟機。除非解除安裝所有套件，否則無法變更目錄位置。

延伸現有的 Eclipse IDE

安裝 Rational Application Developer 產品套件時，您可以選擇新增 Rational Application Developer 套件中所含的功能，以延伸已安裝在您電腦上的 Eclipse 整合開發環境 (IDE)。

隨同 IBM Installation Manager 一起安裝的 Rational Application Developer 套件附有一個 Eclipse IDE 或工作台版本；這個隨附的工作台是基本平台，可提供 Installation Manager 套件中的功能。但如果工作站已有 Eclipse IDE，您可選擇延伸（亦即將 Rational Application Developer 套件的其他功能新增至 IDE）該 Eclipse 實例。

若要延伸現有的 Eclipse IDE：請在「安裝套件」精靈的「位置」頁面中，選取延伸現有的 Eclipse IDE 選項。

例如，您可能想獲得 Rational Application Developer 套件所提供的功能，但在使用 Rational Application Developer 套件的功能時，又想要保有現行 IDE 的喜好設定，此時就可選擇延伸現有的 Eclipse IDE。您也可能想要使用已安裝來延伸 Eclipse IDE 的外掛程式。

現有的 Eclipse IDE 必須是 3.2.1 版（或以上）才能延伸。Installation Manager 會檢查您指定的 Eclipse 實例是否符合安裝套件的需求。

驗證和解壓縮電子映像檔

如果從 IBM Passport Advantage 下載安裝檔，您必須先從壓縮檔中解壓縮電子映像檔，才能安裝 Rational Application Developer。在解壓縮映像檔之前，您可以先驗證下載檔的完整性。

您可以比對已發佈的 MD5 值和下載檔的總和檢查值，檢查下載檔是否毀損或不完整。

解壓縮已下載的檔案

將每一個壓縮檔解壓縮至相同目錄。 Linux 請勿在目錄名稱中加上空格，否則無法從指令行執行 launchpad.sh 指令來執行啟動程式。

前置安裝作業

安裝產品之前，請先完成下列步驟：

確認系統符合安裝需求這一節所描述的需求。
確認環境變數 TEMP （Windows 系統）或 /tmp 目錄（Linux 系統）所指的目錄至少有 500 MB 可用。這不包括產品安裝所需的空間。
確認使用者 ID 符合產品安裝所需的存取權。請參閱使用者專用權需求。
閱讀規劃安裝這一節，特別注意升級和共存性注意事項這個主題。
若要讓非 root 使用者也可以使用產品，在安裝產品之前，umask 變數必須設為 0022。若要設定這個變數，請以 root 使用者身分登入，啟動終端機階段作業，然後鍵入 umask 0022。

安裝作業

下列各節綜述安裝實務這一節所描述的安裝實務。您可以使用主要步驟中的鏈結來取得詳細的指示。

從 CD 安裝 Rational Application Developer：作業概觀

在此安裝實務中，您有內含安裝檔的 CD，且通常將 Rational Application Developer 安裝在自己的工作站。

下列是從 CD 安裝的一般步驟：

完成前置安裝作業列出的前置安裝步驟。
將第一片安裝 CD 插入光碟機中。
裝載光碟機。
如果系統上已啟用自動執行，則會自動開啟 Rational Application Developer 啟動程式。如果自動執行未啟用，請執行「啟動程式」。如需詳細資料，請參閱執行啟動程式。
從啟動程式開始執行 Rational Application Developer 的安裝。如需詳細資料，請參閱從啟動程式開始安裝。
如果在工作站上未偵測到 IBM Installation Manager，將提示您安裝，接著會啟動安裝精靈。請遵循精靈的畫面指示來完成 Installation Manager 的安裝。如需詳細資料，請參閱在 Windows 上安裝 Installation Manager。

當 Installation Manager 安裝完成或已存在電腦上時， Installation Manager 會啟動並自動開始執行「安裝套件」精靈。
請遵循「安裝套件」精靈的畫面指示來完成安裝。如需詳細資料，請參閱使用 IBM Installation Manager 圖形式介面來安裝 IBM Rational Application Developer。
配置授權。依預設已包含 Rational Application Developer 的試用軟體授權。您必須配置授權來確保可繼續存取產品。如需詳細資料，請參閱管理授權。
增加工作站的檔案控點數目。如需詳細資料，請參閱在 Linux 工作站增加檔案控點數目。
安裝 Rational Application Developer 內含的選用性軟體。如需相關資訊，請參閱安裝選用性軟體。

從工作站上的電子映像檔來安裝 Rational Application Developer：作業概觀

下列是從電子安裝映像檔來安裝 Rational Application Developer 的一般步驟。

確定工作站有足夠的空間可儲存必須從 IBM Passport Advantage 下載的檔案和解壓縮的安裝映像檔。請參閱硬體需求。
從 IBM Passport Advantage 上將產品映像檔的所有必要部分下載至暫存目錄。
從下載的檔案中解壓縮安裝映像檔，並驗證安裝映像檔完整無缺。如需詳細資料，請參閱驗證和解壓縮電子映像檔。
繼續執行下列從電子映像檔安裝中的步驟。

從電子映像檔安裝

完成前置安裝作業列出的前置安裝步驟。
執行啟動程式。如需詳細資料，請參閱執行啟動程式。
從啟動程式開始執行 Rational Application Developer 的安裝。如需詳細資料，請參閱從啟動程式開始安裝。
如果在工作站上未偵測到 IBM Installation Manager，將提示您安裝，接著會啟動安裝精靈。請遵循精靈的畫面指示來完成 Installation Manager 的安裝。如需詳細資料，請參閱在 Windows 上安裝 Installation Manager。

當 Installation Manager 安裝完成或已存在系統上時， Installation Manager 會啟動並自動開始執行「安裝套件」精靈。
請遵循「安裝套件」精靈的畫面指示來完成安裝。如需詳細資料，請參閱使用 IBM Installation Manager 圖形式介面來安裝 IBM Rational Application Developer。
配置授權。依預設已包含 Rational Application Developer 的試用軟體授權。您必須配置授權來確保可繼續存取產品。如需詳細資料，請參閱管理授權。
增加工作站的檔案控點數目。如需詳細資料，請參閱在 Linux 工作站增加檔案控點數目。
安裝 Rational Application Developer 內含的選用性軟體。如需相關資訊，請參閱安裝選用性軟體。

從共用磁碟機上的電子映像檔來安裝 Rational Application Developer：作業概觀

在此實務中，您會將電子映像檔放在共用磁碟機上，方便企業內的使用者從單一位置上取得 Rational Application Developer 的安裝檔。

下列步驟是由將安裝映像檔放在共用磁碟機上的人來執行。

確定共用磁碟機有足夠的磁碟空間可儲存必須從 IBM Passport Advantage 下載的檔案和解壓縮的安裝映像檔。如需詳細資料，請參閱硬體需求。
從 IBM Passport Advantage 上將產品映像檔的所有必要部分下載至共用磁碟機的暫存目錄。
從下載的檔案中，將安裝映像檔解壓縮至共用磁碟機上可存取的目錄，並驗證安裝映像檔完整無缺。如需詳細資料，請參閱驗證和解壓縮電子映像檔。

若要從共用磁碟機上的安裝檔來安裝 Rational Application Developer：

切換至含安裝映像檔的共用磁碟機的 disk1 目錄。
遵循從電子映像檔安裝中的步驟執行。

從 HTTP Web 伺服器上的儲存庫來安裝 Rational Application Developer：作業概觀

在此實務中，IBM Installation Manager 會從 HTTP Web 伺服器擷取產品套件。

這些步驟假設 HTTP Web 伺服器上已建立含有 Rational Application Developer 套件的儲存庫。

若要從 HTTP 伺服器上的儲存庫來安裝 Rational Application Developer 套件：

完成前置安裝作業列出的前置安裝步驟。
安裝 IBM Installation Manager。請參閱管理 IBM Installation Manager。在此實務中，假設 Installation Manager 安裝檔可從共用磁碟機上取得。
啟動 Installation Manager。如需詳細資料，請參閱在 Windows 上啟動 Installation Manager。
在 Installation Manager 的儲存庫喜好設定中設定含有 Rational Application Developer 套件的儲存庫的 URL。請參閱在 Installation Manager 中設定儲存庫喜好設定。
在 Installation Manager 中啟動「安裝套件」精靈，遵循「安裝套件」精靈的畫面指示來完成安裝。如需詳細資料，請參閱使用 IBM Installation Manager 圖形式介面來安裝 IBM Rational Application Developer。
配置授權。依預設已包含 Rational Application Developer 的試用軟體授權。您必須設定授權來確保可繼續使用產品。如需詳細資料，請參閱管理授權。
增加工作站的檔案控點數目。如需詳細資料，請參閱在 Linux 工作站增加檔案控點數目。
安裝 Rational Application Developer 內含的選用性軟體。如需相關資訊，請參閱安裝選用性軟體。

將 Rational Application Developer 放在 HTTP Web 伺服器：作業概觀

準備從 HTTP Web 伺服器上的儲存庫來安裝 Rational Application Developer：

確定 HTTP 或 HTTPS Web 伺服器有足夠的磁碟空間可儲存產品套件。請參閱硬體需求。
確定工作站有足夠的磁碟空間可儲存必須從 IBM Passport Advantage 下載的檔案和解壓縮的安裝映像檔。請參閱硬體需求
從 IBM Passport Advantage 上將產品映像檔的所有必要部分下載至工作站的暫存目錄。
從下載的檔案中，將安裝映像檔解壓縮至工作站的另一個暫存目錄，並驗證安裝映像檔完整無缺。如需詳細資料，請參閱驗證和解壓縮電子映像檔。
從適合您平台的「輔助 CD」（或電子映像檔）中將 IBM Packaging Utility 安裝在工作站。
利用 Packaging Utility 來複製 Rational Application Developer 產品套件。
將 Packaging Utility 的輸出複製到 HTTP 或 HTTPS Web 伺服器。
從「輔助 CD」中將 IBM Installation Manager 的安裝檔複製到共用磁碟機。
要求組織內的使用者來安裝 Installation Manager。
將儲存庫的 URL 提供給使用者，內含您先前建立的 Rational Application Developer 產品套件。

管理 IBM Installation Manager

在 Windows 上安裝 Installation Manager

IBM Installation Manager 是以啟動程式來安裝。如需此程序的相關資訊，請參閱從啟動程式來安裝。

若要手動安裝 Installation Manager：

從第一片安裝光碟的 InstallerImager_win32 資料夾中執行 setup.exe。
在「歡迎使用」畫面上，按下一步。
檢閱「授權合約」頁面上的授權合約，選取我接受授權合約的條款表示接受。按下一步。
必要的話，請在「目標檔案夾」頁面按一下變更按鈕，變更安裝位置。按下一步。
在「安裝類型」頁面上，按下一步。
在「準備安裝程式」頁面上，按一下安裝。安裝完成時會開啟「完成」頁面。
按一下完成。

在 Linux 上安裝 Installation Manager

IBM Installation Manager 是以啟動程式來安裝。如需此程序的相關資訊，請參閱從啟動程式來安裝。

若要手動安裝 Installation Manager：

以 root 使用者專用權來開啟終端機視窗。
從第一片安裝光碟的 InstallerImager_linux 資料夾中執行 setupLinux.bin。
在「歡迎使用」畫面上，按下一步。
檢閱「授權合約」頁面上的授權合約，選取我接受授權合約的條款表示接受。按下一步。
必要的話，編輯安裝目錄位置。按下一步。
在資訊摘要頁面上，按一下安裝。
在「InstallShield 精靈完成」頁面上，按一下完成。

在 Windows 上啟動 Installation Manager

請利用啟動程式來啟動 IBM Installation Manager。這樣做會使用已配置的儲存庫喜好設定和選取的 Rational Application Developer 套件來啟動 Installation Manager。如果直接啟動 Installation Manager，則必須設定儲存庫喜好設定，並手動選擇產品套件。

若要手動啟動 Installation Manager：

從工作列開啟開始功能表。
選取所有程式 -> IBM Installation Manager -> IBM Installation Manager。

在 Linux 上啟動 Installation Manager

若要手動啟動 Installation Manager：

以 root 使用者專用權來開啟終端機視窗。
執行 /opt/IBM/InstallationManager/launcher_shortcut。

在 Windows 上解除安裝 Installation Manager

若要手動解除安裝 Installation Manager：

從第一片安裝光碟的 InstallerImager_win32 資料夾中執行 setup.exe。
在「歡迎使用」畫面上，按下一步。
在「程式維護」頁面上，選取移除按鈕。按下一步。
在「安裝類型」頁面上，按下一步。
在「移除程式」頁面上，按一下移除。
在「InstallShield 精靈完成」頁面上，按一下完成。

在 Linux 上解除安裝 Installation Manager

IBM Installation Manager 必須以您的 Linux 版本所提供的套件管理工具來解除安裝。

若要在 Linux 上手動解除安裝 Installation Manager：

以 root 使用者專用權來開啟終端機視窗。
切換至 Installation Manager 的安裝目錄（預設是 /opt/IBM/InstallationManager），再切換至 _uninst。
執行 .uninstaller.bin。

從啟動程式來安裝

「啟動程式」讓您集中在單一位置上檢視版本資訊和啟動安裝程序。

在下列情況，請利用啟動程式來開始安裝 Rational Application Developer：

從產品 CD 安裝。
從工作站上的電子映像檔來安裝。
從共用磁碟機上的電子映像檔來安裝。

如果從「啟動程式」來開始安裝程序，IBM Installation Manager 啟動時會預先配置含有 Rational Application Developer 套件的儲存庫位置。如果直接安裝和啟動 Installation Manager，則必須手動設定儲存庫喜好設定。

若要從啟動程式來安裝：

完成前置安裝作業所描述的前置安裝作業（如果尚未完成）。
執行啟動程式。請參閱執行啟動程式。
開始安裝 Rational Application Developer。請參閱從啟動程式開始安裝。

請遵循「安裝套件」精靈的畫面指示來完成安裝。如需詳細資料，請參閱使用 IBM Installation Manager 圖形式介面來安裝 IBM Rational Application Developer。

執行啟動程式

完成前置安裝作業所描述的前置安裝作業（如果尚未完成）。

如果從 CD 安裝且工作站已啟用自動執行，當您將第一片安裝光碟插入光碟機時，將自動啟動 Rational Application Developer 啟動程式。如果從電子映像檔安裝，或工作站未配置自動執行，則必須手動執行啟動程式。

若要執行啟動程式：

將 IBM Rational Application Developer CD 插入光碟機中。確定已裝載光碟機。
如果系統上已啟用自動執行，則會自動開啟 IBM Rational Application Developer 啟動程式。如果系統上未啟用自動執行：
- 執行 CD 根目錄中的 launchpad.exe。
- 執行 CD 根目錄中的 launchpad.sh。

從啟動程式開始安裝

執行啟動程式。
按一下版本注意事項來閱讀版本資訊（如果尚未閱讀）。
準備開始安裝時，請按一下安裝 IBM Rational Application Developer.
這時會出現訊息視窗，指出是否在工作站偵測到 IBM Installation Manager 程式。
- 如果在系統上未偵測到 IBM Installation Manager，則會提示您必須安裝才能繼續。
  1. 按一下確定，開始安裝 IBM Installation Manager。這時會啟動 IBM Installation Manager 安裝精靈。
  2. 請遵循精靈的畫面指示來完成 IBM Installation Manager 的安裝。如需相關資訊，請參閱在 Windows 上安裝 Installation Manager。
  3. 當 IBM Installation Manager 順利安裝完成時，請按一下完成，關閉精靈。
  4. 閱讀開啟的訊息，再按一下確定。Installation Manager 會啟動並自動開啟「安裝套件」精靈。
- 如果在系統上偵測到 IBM Installation Manager，請按一下確定，Installation Manager 將啟動並自動開啟「安裝套件」精靈。
請遵循「安裝套件」精靈的畫面指示來完成安裝。如需完整的詳細資料，請參閱使用 IBM Installation Manager 圖形式介面來安裝 IBM Rational Application Developer

使用 IBM Installation Manager 圖形式介面來安裝 IBM Rational Application Developer

下列步驟說明使用 Installation Manager GUI 來安裝 IBM Rational Application Developer 套件。

「安裝」頁面會列出 Installation Manager 在儲存庫中找到的所有套件。如果發現一個套件有兩個不同版本，則只會顯示套件的最新版本或建議版本。
- 若要顯示 Installation Manager 找到的任何套件的所有版本，請按一下顯示全部版本。
- 若要回到只有建議套件的畫面，請按一下只顯示建議版本。
按一下 IBM Rational Application Developer 套件，在詳細資料窗格中顯示相關說明。
若要搜尋 IBM Rational Application Developer 套件的更新項目，請按一下檢查更新。 Installation Manager 會在預先定義的網站上搜尋產品套件的更新項目。也會搜尋您已設定的任何儲存庫位置。進度指示器會顯示正在搜尋。您可以在安裝基本產品套件的同時安裝更新項目。
如果找到 IBM Rational Application Developer 套件的更新項目，「安裝套件」頁面的套件清單中會將這些更新項目列在相對應的套件下。依預設只會顯示建議的更新項目。
- 若要檢視可用的套件的所有更新項目，請按一下顯示全部版本。
- 若要在詳細資料下顯示套件說明，請按一下套件名稱。
選取 IBM Rational Application Developer 套件及您要安裝的套件的任何更新項目。互有相依關係的更新項目會自動一起選取和清除。按下一步以繼續。
註:

若要同時安裝多個套件，所有套件會安裝至相同的套件群組。
在「授權」頁面上，閱讀已選取的套件的授權合約。如果選取多個套件來安裝，則每一個套件可能各有授權合約。在授權頁面的左邊，按一下每個套件版本來顯示授權合約。選取要安裝的套件版本（例如，基礎套件和更新項目）列在套件名稱下。
1. 如果同意所有授權合約的條款，請按一下我接受授權合約的條款。
2. 按下一步以繼續。
在「位置」頁面上，在共用資源目錄欄位中鍵入共用資源目錄的路徑，不然就接受預設路徑。共用資源目錄包含可供一或多個套件群組共用的資源。按下一步以繼續。
預設路徑為：
- C:\IBM\SDP7com
- /opt/IBM/SDP7com
重要:

您只能在第一次安裝套件時指定共用資源目錄：。請使用最大的磁碟，以確保有足夠的空間可容納未來套件的共用資源。除非解除安裝所有套件，否則無法變更目錄位置。
在「位置」頁面上，選擇現有的套件群組來安裝 IBM Rational Application Developer 套件，或建立新的群組。套件群組代表一個目錄，同一群組的套件在此目錄中共用資源。若要建立新的套件群組：
1. 按一下建立新的套件群組。
2. 鍵入套件群組的安裝目錄路徑。套件群組的名稱會自動建立。
  預設路徑為：
  - C:\IBM\SDP7
  - /opt/IBM/SDP7
3. 按下一步以繼續。
在下一個「位置」頁面上，您可以選擇延伸系統上已安裝的現有 Eclipse IDE，加上您所安裝的套件中的功能。您必須有 Eclipse 3.2.1 版或更新版本才能選取這個選項。
- 如果不要延伸現有的 Eclipse IDE，請按下一步繼續執行。
- 若要延伸現有的 Eclipse IDE：
  1. 選取延伸現有的 Eclipse。
  2. 在 Eclipse IDE 欄位中，鍵入或導覽至 Eclipse 執行檔（eclipse.exe 或 eclipse.bin）所在的資料夾位置。 Installation Manager 會檢查 Eclipse IDE 版本是否適用於您所安裝的套件。 Eclipse IDE JVM 欄位顯示您指定的 IDE 的 Java 虛擬機器 (JVM)。
  3. 按下一步以繼續。
在「特性」頁面上，在語言下選取套件群組的語言。 IBM Rational Application Developer 套件的使用者介面和文件將會安裝相對應的國家語言翻譯。請注意，您的選擇會套用至安裝在此套件群組下的所有套件。
在下一個「特性」頁面上，選取您要安裝的套件特性。
1. 選擇性的: 若要查看特性的相依關係，請選取顯示相依關係。
2. 選擇性的: 按一下特性，在詳細資料下檢視簡要說明。
3. 在套件中選取或清除特性。Installation Manager 會自動維護對其他特性的任何相依關係，並顯示更新的下載大小和安裝的磁碟空間需求。
4. 特性選取完畢之後，請按下一步繼續執行。
在「摘要」頁面上，在安裝 IBM Rational Application Developer 套件之前先複查您的選擇。若要變更您在先前頁面所做的選擇，請按上一步來變更。滿意安裝選擇之後，請按一下安裝，開始安裝套件。進度指示器會顯示安裝完成百分比。
安裝程序完成時，將出現訊息來確認程序成功。
1. 按一下檢視日誌檔，在新的視窗中開啟目前階段作業的安裝日誌檔。您必須關閉「安裝日誌」視窗才能繼續。
2. 在「安裝套件」精靈中，選取是否在結束時啟動 IBM Rational Application Developer。
3. 按一下完成，啟動選取的套件。「安裝套件」精靈會關閉，您也會回到 Installation Manager 的「開始」頁面。

無聲自動安裝

您可以採取無聲自動安裝模式執行 Installation Manager 來安裝 Rational Application Developer 產品套件。以無訊息模式執行 Installation Manager 時，不會出現使用者介面； Installation Manager 會使用回應檔來輸入安裝產品套件所需的指令。

以無訊息模式執行 Installation Manager 很有用，因為您可以透過 Script，以批次程序來安裝、更新、修改及解除安裝產品套件。

請注意，您必須安裝 Installation Manager，才能以無聲自動模式來安裝 Rational Application Developer 套件。如需 Installation Manager 的詳細安裝資訊，請參閱管理 IBM Installation Manager。

無聲自動安裝有兩項主要的作業：

建立回應檔。
以無聲自動安裝模式來執行 Installation Manager。

建立回應檔

您可以將使用 Installation Manager 來安裝 Rational Application Developer 產品套件時的動作記錄下來以建立回應檔。在記錄回應檔時，您在 Installation Manager GUI 中所做的所有選擇會儲存在 XML 檔案中。以無訊息模式執行 Installation Manager 時，Installation Manager 會使用 XML 回應檔來尋找含有套件的儲存庫、選取要安裝的特性等。

若要記錄用於安裝（或解除安裝）的回應檔：

在指令行，切換至 Installation Manager 安裝目錄中的 eclipse 子目錄。例如：
- cd C:\Program Files\IBM\Installation Manager\eclipse
- cd opt/IBM/InstallationManager/eclipse
在指令行中輸入下列指令，以啟動 Installation Manager，並改為您自己的回應檔和選用日誌檔的檔名和位置：
- launcher.bat -record <回應檔路徑和名稱>.xml -log <日誌檔路徑和名稱>.xml。例如，launcher.bat -record c:\mylog\responsefile.xml -log c:\mylog\record_log.xml
- launcher.sh -record <回應檔名稱 >.xml -log <日誌檔路徑和名稱>.xml。例如， launcher.sh -record /root/mylog/responsefile.xml -log /root/mylog/record_log.xml
註:

請確定您所輸入的檔案路徑已存在；Installation Manager 不會為回應檔和日誌檔建立目錄。
遵循「安裝套件」精靈的畫面指示來完成安裝選擇，直到出現「摘要」頁面為止。如需詳細資料，請參閱使用 IBM Installation Manager 圖形式介面來安裝 IBM Rational Application Developer。
按一下安裝，當安裝程序開始時，按一下取消。
按一下完成，關閉 Installation Manager。

指令所指定的位置中會建立 XML 回應檔。

以無聲自動安裝模式來執行 Installation Manager

您可以從指令行以無聲自動安裝模式來執行 Installation Manager。

關於如何以無訊息模式執行的其他文件，請參閱 Installation Manager 線上說明。

在 Installation Manager 啟動指令 launcher.bat (Windows) 或 launcher.sh (Linux) 中，只要附加 -silent 引數，就能夠以無訊息模式執行 Installation Manager。

launcher.bat -silent [引數]
launcher.sh -nosplash -silent [引數]

下表說明無聲自動安裝指令所用的引數：

引數	說明
-input	指定 XML response file 做為 Installation Manager 的輸入。回應檔包含 Installation Manager 執行的指令。
-log	（選用）指定日誌檔來記錄無聲自動安裝的結果。日誌檔是 XML 檔案格式。

若要以無聲自動安裝模式來執行 Installation Manager：

在指令行，切換至 Installation Manager 安裝目錄中的 eclipse 子目錄。例如：
- cd C:\Program Files\IBM\Installation Manager\eclipse
- cd opt/IBM/InstallationManager/eclipse
輸入並執行下列指令，請改為您自己的回應檔和日誌檔（選用性）位置：
- 。例如，launcher.bat -silent -input c:\mylog\responsefile.xml -log c:\mylog\silent_install_log.xml
- launcher.sh -nosplash -silent<回應檔名稱> -log <日誌檔路徑和名稱>。例如，launcher.sh -nosplash -silent -input /root/mylog/responsefile.xml -log /root/mylog/silent_install_log.xml

Installation Manager 會以無聲自動安裝模式執行、讀取回應檔，並在您指定的目錄中寫入日誌檔。以無聲自動安裝模式執行時，必須有回應檔，但可自行決定是否使用日誌檔。

回應檔指令

若要使用 Installation Manager 的無聲自動安裝功能，您必須建立回應檔，內含 Installation Manager 必須執行的所有指令。建議記錄您安裝 IBM Rational Application Developer 套件時的動作來建立回應檔。您也可以手動建立或編輯回應檔。

回應檔有兩類指令：

喜好設定指令用來設定 Installation Manager 在檔案 -> 喜好設定...下的喜好設定，例如儲存庫位置資訊。
無聲自動安裝指令用來模擬 Installation Manager 中的「安裝套件」精靈。

無聲自動安裝喜好設定指令

通常是以「喜好設定」視窗來指定喜好設定，但您也可以在無聲自動安裝期間所用的回應檔中指定喜好設定（以鍵值表示）。

註:

您可以在回應檔中指定多項喜好設定。

在回應檔中定義喜好設定時，XML 程式碼如下所示：

<preference>
	name = 『喜好設定的鍵』
	value = 『要設定的喜好設定值』
</preferences>

請利用下列表來查看無聲自動安裝喜好設定的鍵和相關的值：

鍵	值	附註
com.ibm.cic.common.core. preferences. installDataLocation	指定 Installation Manager 資料的安裝位置。	重要: 此為選用的鍵，適用於測試和除錯。如果不指定 Installation Manager 的安裝位置，無聲自動安裝和 UI 版的 Installation Manager 將使用相同的位置。
com.ibm.cic.common.core. preferences.logLocation	指定 Installation Manager 日誌檔的位置。	重要: 此為選用的鍵，適用於測試和除錯。如果不指定日誌檔的位置，則無聲自動安裝和 UI 版的 Installation Manager 將使用相同的位置。
com.ibm.cic.license.policy. location	指定 URL 來定義遠端授權原則檔所在的位置。
com.ibm.cic.common.core. preferences. http.proxyEnabled	True 或 False	False 是預設值。
com.ibm.cic.common.core. preferences. http.proxyHost	主機名稱或 IP 位址
com.ibm.cic.common.core. preferences. http.proxyPort	埠號
com.ibm.cic.common.core. preferences. http.proxyUseSocks	True 或 False	False 是預設值。
com.ibm.cic.common.core. preferences. SOCKS.proxyHost	主機名稱或 IP 位址
com.ibm.cic.common.core. preferences. SOCKS.proxyPort	埠號
com.ibm.cic.common.core. preferences. ftp.proxyEnabled	True 或 False	False 是預設值。
com.ibm.cic.common.core. preferences. ftp.proxyHost	主機名稱或 IP 位址
com.ibm.cic.common.core. preferences. ftp.proxyPort	埠號
com.ibm.cic.common.core. preferences.eclipseCache	共用元件目錄

無聲自動安裝指令

請利用這個參考表來進一步瞭解無聲自動安裝期間使用的回應檔指令。

回應檔指令	說明
指定設定檔 <profile id="設定檔 ID" installLocation="設定檔的安裝位置"> </profile>	請利用這個指令來建立安裝位置。如果指定的安裝位置已存在，則指令沒有效果。目前，在建立設定檔時，無聲自動安裝還會建立兩個安裝環境定義：一個用於 Eclipse，另一個用於 native。設定檔就是安裝位置。
設定儲存庫 <server> <repository location="http:/xxx/ repository/"> <repository location=』file:/C:/ repository/』> <!--以下新增更多儲存庫--> <...> </server>	請利用這個指令來指定無聲自動安裝期間使用的儲存庫。每一個儲存庫位置可以是 URL 或檔案路徑。
安裝 <install> <offering profile= "設定檔 ID" features= "特性 ID" id= "產品 ID" version= "產品版本"></offering> <!--以下新增更多產品> <...> </install>	請利用這個指令來指定將安裝的安裝套件。設定檔 ID 必須符合現有的設定檔或「指定設定檔」指令所建立的設定檔。特性 ID 可選擇以逗號分隔清單來指定，例如 "feature1, feature2』等。如果未指定特性 ID，則會安裝指定產品中的所有預設特性。註: 安裝時會安裝必要的特性，即使在逗號分隔清單中未明確指定也一樣。
解除安裝 <uninstall> <offering profile= "設定檔 ID" features= "特性 ID" id= "產品 ID" version= "產品版本"></offering> <!--以下新增更多產品> <...> </uninstall>	請利用這個指令來指定將解除安裝的安裝套件。設定檔 ID 必須符合現有的設定檔或設定檔指令中指定的設定檔。再者，如果未指定特性 ID，則會解除安裝指定產品中的所有特性；如果未指定產品 ID，則會解除安裝指定設定檔中所有已安裝的產品。
InstallAll <installALL/> 註: 這個指令相當於使用 -silent -installAll .	請利用這個指令來自動搜尋和安裝所有可用的可安裝套件。
UpdateAll <updateALL/> 註: 這個指令相當於使用 -silent -updateAll .	請利用這個指令來自動搜尋和更新所有可用的可安裝套件。

其他回應檔屬性

您也可以在回應檔中加入清除模式和授權合約接受的屬性。

清除模式屬性

您可以在回應檔中套用 clean 屬性，如此，無聲自動安裝功能將不會保留 Installation Manager 使用者介面中的伺服器和喜好設定的設定值。若要以清除模式執行，請在開啟的回應檔標示上將下列屬性設為 true：

<agent-input clean="true">

如果將 clean 屬性設為 true，無聲自動安裝將不會保留伺服器喜好設定；這些設定的效力僅限於本次設定。完成無聲自動安裝之後，當您檢視 Installation Manager UI 時，您會發現回應檔中指定的儲存庫及其他喜好設定出現在「喜好設定」頁面上。如果以清除模式執行無聲自動安裝，則不會出現這些設定。

註:

clean 模式屬性適用於測試和除錯期間。

授權合約接受屬性

以無聲自動安裝模式執行 Installation Manager 時，原則上您會同意接受安裝套件所顯示的任何授權條款。如果不要接受授權合約，您可以在 <agent-input> 元素中加上屬性，自動中斷無聲自動安裝作業：<agent-input acceptLicense='false">。如果您安裝的安裝套件要求必須接受授權合約，則無聲自動安裝作業會失敗。

參照：回應檔範例

您可以利用 XML 回應檔來指定預先定義的資訊，例如無聲自動安裝喜好設定、儲存庫位置、安裝設定檔等。回應檔有利於團隊和公司以無聲自動模式來安裝安裝套件及統一安裝套件的位置和喜好設定。

回應檔範例
<agent-input > <!-- 新增喜好設定 --> <preference name="com.ibm.cic.common.core.preferences. http.proxyEnabled" value="c:/temp"/> <!-- 建立設定檔（如果不存在）--> <profile id="my_profile" installLocation="c:/temp/my_profile"></profile> <server> <repository location= "http://a.site.com/local/products/sample/20060615_1542/repository/"></repository> /server> <install> <offering profile= "my_profile" features= "core" id= "ies" version= "3.2.0.20060615"> </offering> /install> </agent-input>

回應檔範例

<agent-input >

<!-- 新增喜好設定 -->
<preference name="com.ibm.cic.common.core.preferences. http.proxyEnabled" 
value="c:/temp"/>

<!-- 建立設定檔（如果不存在）-->
<profile id="my_profile" installLocation="c:/temp/my_profile"></profile>

<server>
<repository location= 
"http://a.site.com/local/products/sample/20060615_1542/repository/"></repository>
/server>

<install>
	<offering profile= "my_profile" features= "core" id= "ies" 
version= "3.2.0.20060615">
	</offering>
/install>

</agent-input>

無聲自動安裝日誌檔

您可以利用無聲自動安裝日誌檔來檢查無聲自動安裝階段作業的結果。

無聲自動安裝功能會建立 XML 格式的日誌檔，記錄無聲自動安裝的執行結果（但必須以 -log <日誌檔路徑>.xml 指定日誌檔路徑）。如果無聲自動安裝階段作業順利完成，則日誌檔只包含根元素 <result> </result>。但如果安裝期間發生錯誤，無聲自動安裝日誌檔將包含錯誤元素和訊息，例如：

<result>
	<error> 找不到設定檔：設定檔 ID</error>
	<error> 其他一些錯誤</error>
</result>

如需詳細的分析，請查看 Installation Manager 資料區中產生的日誌。您可以利用喜好設定指令，將資料區為設為您偏好的位置，如回應檔主題所示。

IBM Packaging Utility

請利用 IBM Packaging Utility 軟體將產品套件複製到儲存庫，此儲存庫可放在能夠以 HTTP 或 HTTPS 存取的 Web 伺服器上。

Packaging Utility 軟體位於 Rational Application Developer 包含的每一個平台（Windows 和 Linux）的「輔助 CD」上。若要將含有 Rational Application Developer 套件的儲存庫放在可透過 HTTP 或 HTTPS 存取的 Web 伺服器上，您必須使用 Packaging Utility 將 Rational Application Developer 的產品套件複製到儲存庫。

請利用此公用程式來執行下列作業：

產生產品套件的新儲存庫。
將產品套件複製到新的儲存庫。您可以將多個產品套件複製到單一儲存庫，藉此為組織建立一個共同位置，方便以 IBM Installation Manager 來安裝產品套件。
從儲存庫中刪除產品套件。

如需此工具的完整使用指示，請參閱 Packaging Utility 的線上說明。

解壓縮 Packaging Utility

IBM Packaging Utility 必須先從壓縮檔中解壓縮，才能用來複製 Rational Application Developer 產品套件。

請執行下列步驟來解壓縮 IBM Packaging Utility 軟體：

尋找 Packaging Utility 壓縮檔。 Packaging Utility 壓縮檔位於各平台的「輔助 CD」上：
- PackagingUtility\PU_win32.zip
- PackagingUtility/PU_linux.zip
從含有公用程式的壓縮檔中，將所有檔案解壓縮至相同目錄，請保留目錄結構或壓縮檔。

使用 Packaging Utility 將產品套件複製到 HTTP 伺服器

若要在 HTTP 或 HTTPS 伺服器上建立儲存庫，您必須使用 Packaging Utility 來複製 Rational Application Developer 的產品套件

請注意，這個方法不會複製 Rational Application Developer 安裝映像檔中的選用性軟體。只會複製以 IBM Installation Manager 安裝的 Rational Application Developer 檔案。

也請注意，Packaging Utility 可將多個產品套件合併至單一儲存庫位置。如需相關資訊，請參閱 Packaging Utility 線上說明。

若要使用套裝公用程式來複製產品套件：

如果從 CD 映像檔複製，請執行下列作業：
1. 將第一片安裝 CD 插入光碟機中。
2. 裝載光碟機。
3. 如果系統上已啟用自動執行，則會自動開啟 Rational Application Developer 啟動程式。請關閉啟動程式。
啟動 Packaging Utility。
在公用程式的主頁面上，按一下複製產品套件。這時會開啟「必備項目」頁面，顯示兩個選項：
- 我將從 IBM Web 下載產品套件
- 我將從其他來源取得產品套件
按一下我將從 IBM Web 下載產品套件。
註:

如果已定義可存取的儲存庫，您可以使用我將從其他來源取得產品套件選項。
按下一步，進入「來源」頁面。如果沒有產品套件可選取，您必須開啟含有產品套件的儲存庫。
若要開啟儲存庫，請按一下開啟儲存庫按鈕。這時會開啟「開啟儲存庫」視窗。
註:

儲存庫可以是檔案系統中的目錄路徑、含有產品第一片 CD 的磁碟機或伺服器上的目錄 URL。
若要定義儲存庫位置，請按一下「儲存庫位置」的瀏覽按鈕，然後導覽選取「儲存庫位置」- 含有電子磁碟映像檔的 common root directory 或含有第一片產品安裝 CD 的磁碟機。比方說，如果 Rational Application Developer 檔案（disk1、disk2 等）位於 C:\My product\unzip，則應該將這個位置定義成儲存庫。
按一下確定來定義儲存庫位置，並關閉「瀏覽至儲存庫目錄」視窗。
在「目的地」頁面上，按一下瀏覽按鈕，選取現有的儲存庫目錄，或建立新的資料夾來儲存產品。
指定選取的產品套件及任何修正程式的儲存庫之後，請按一下確定，關閉「瀏覽至目錄」視窗。您剛定義的檔案路徑會列在「目的地」頁面的目錄欄位中。
按下一步，進入「摘要」頁面。「摘要」頁面顯示已選取要複製到目的地儲存庫的產品套件。這個頁面也列出複製作業所需的儲存空間數量及磁碟機上可用的空間數量。
按一下複製，將選取的產品套件複製到目的地儲存庫。精靈底端會顯示狀態列，指出複製程序還剩多少時間。完成複製程序之後，將開啟「完成」頁面，顯示已順利複製的所有產品套件。
按一下完成，回到 Packaging Utility 主頁面。

現在，您已使用 Packaging Utility 將 Rational Application Developer 安裝檔複製到儲存庫，您可以將儲存庫放到 Web 伺服器上，讓目錄和檔案可透過 HTTP 來存取。（儲存庫也可以放在 UNC 磁碟機上。）

管理授權

您可以利用「管理授權」精靈及相關的「喜好設定」頁面來管理已安裝的 IBM Rational Software Development Platform 產品和自訂套件的授權。「管理授權」精靈會顯示每一個已安裝的套件的授權類型和授權期限資訊。

您可以匯入啟動套件將試用版的產品升級成授權版。您也可以為試用或永久授權的產品啟用 IBM Rational Common Licensing，從 Rational 授權伺服器取得浮動授權碼。

授權

購買 IBM Rational 軟體產品時有三種產品授權可選擇：「授權使用者授權」、「授權使用者固定期限授權 (FTL)」及「浮動授權」。最適合組織的選擇取決於產品使用人數、產品使用頻率及您偏好的軟體採購方式。

授權使用者授權

IBM Rational「授權使用者授權」允許單一特定個人使用一項 Rational 軟體產品。購買者必須為每一位以任何形式存取產品的使用者取得「授權使用者授權」。除非購買者長期或永久更換原始受讓人，否則不得轉讓「授權使用者授權」。

比方說，如果購買一個「授權使用者授權」，您可以將授權分配給一個特定個人，此人就可使用 Rational 軟體產品。「授權使用者授權」不允許第二人在任何時間使用該產品，即使原授權人未積極使用亦同。

授權使用者固定期限授權

IBM Rational「授權使用者固定期限授權 (FTL)」允許單一特定個人在一定指定時間內（期限）使用一項 Rational 軟體產品。購買者必須為每一位以任何形式存取產品的使用者取得「授權使用者 FTL」。除非購買者長期或永久更換原始受讓人，否則不得轉讓「授權使用者 FTL」。

註:

選擇以 Passport Advantage Express 方案購買「授權使用者 FTL」時， IBM 會自動按市價延長授權期限一年，除非您在授權到期前向 IBM 表示不要延長。延長的 FTL 期限自原始 FTL 期限到期時起算。目前，此延長期限的價格是原始 FTL 價格的 80%，但可能變動。

如果向 IBM 表示不要延長授權期限，則授權到期時必須停止使用產品。

浮動授權

IBM Rational「浮動授權」是多位團隊成員共用的單一軟體產品的授權，但並行使用者總數不得超出您購買的浮動授權數。比方說，如果為一項 Rational 軟體產品購買一個浮動授權，則組織內的任何使用者可隨時使用該產品。但第二人必須等到現行使用者登出之後才能存取產品。

若要使用浮動授權，您必須取得浮動授權碼並安裝在 Rational License Server 上。伺服器會回應使用者對於授權碼的存取要求；只要現行使用者數量符合組織所購買的授權數，就會授予存取權。

啟用授權

如果是第一次安裝 Rational 軟體產品，或想要延長授權來繼續使用產品，您可以選擇如何啟用產品的授權。

Rational Software Development Platform 產品的授權有兩種啟用方式：

匯入產品啟動套件
啟用 Rational Common Licensing 來取得浮動授權碼

啟動套件

產品啟動套件包含 Rational 產品試用版的永久授權碼。請購買啟動套件並下載至本端機器，然後匯入啟動套件來啟用產品的授權。請利用 IBM Installation Manager 來匯入產品的啟動套件。

Rational Common Licensing

您可以取得浮動授權碼，安裝 Rational License Server，然後啟用產品的 Rational Common Licensing。Rational Common Licensing 有下列好處：

整個組織確實遵守授權規定
購買較少的授權

如需取得啟動套件和「浮動」授權的相關資訊，請參閱購買授權。

檢視已安裝的套件的授權資訊

您可以從 IBM Installation Manager 中檢閱已安裝的套件的授權資訊，包括授權類型和到期日。

若要檢視授權資訊：

啟動 IBM Installation Manager。
在主頁面上，按一下管理授權。

每一個已安裝的套件會顯示套件供應商、現行授權類型及到期日。

匯入產品啟動套件

下載產品啟動套件之後，您必須利用 IBM Installation Manager 從下載位置匯入套件。

您必須購買啟動套件並下載至可存取的工作站。

若要匯入啟動套件並啟用新的授權碼：

啟動 IBM Installation Manager。
在主頁面上，按一下管理授權。
在「安裝套件」頁面，選取套件，再按一下匯入產品啟用套件。
按下一步。畫面上會顯示選取的套件的詳細資料，包括現行授權類型和授權適用的版本範圍。
瀏覽至套件的下載位置路徑，然後選取適當的 Java 保存檔 (JAR)，再按一下開啟。
按下一步。「摘要」頁面會顯示啟動套件的目標安裝目錄、新授權適用的產品及版本資訊。
按一下完成。

產品啟動套件及永久授權碼已匯入產品中。「管理授權」精靈指出匯入是否成功。

啟用浮動授權

如果團隊環境支援 Rational Common Licensing，您可以啟用產品的浮動授權，配置連線來允許存取浮動授權碼。

如需授權伺服器、授權碼及 Rational Common Licensing 管理的詳細資料，請參閱授權管理手冊。

您必須向管理者查詢授權伺服器連線資訊。

若要啟用浮動授權做為指定套件的授權類型並配置授權伺服器連線：

啟動 IBM Installation Manager。
在主頁面上，按一下管理授權。
在「安裝套件」頁面，選取套件版本，按一下配置授權伺服器，再按下一步。
在「授權伺服器」頁面，選取啟用 Rational Common Licensing 勾選框。
配置一或多個授權伺服器連線。
1. 按一下新增按鈕。
2. 在「新增伺服器」視窗，在名稱欄位中鍵入授權伺服器的主機名稱。
3. （選用）在使用防火牆的環境下，請在埠欄位中鍵入一個值。除非管理者有指示，否則請勿指派這個埠的值。
4. 按一下確定。
5. 如果系統管理者還提供其他授權伺服器的主機名稱，請重複這些步驟來新增每一個伺服器。在備用伺服器配置下，假設使用三個伺服器，請以這種格式鍵入每一個主機名稱："hostname1"、"hostname2"、"hostname3"。對於每一個埠號，請相對應地鍵入："host1port#"、"host2port#"、"host3port#"。
按下一步。
（選用）配置自訂套件的授權使用順序。清單中的授權順序決定產品嘗試取得特定授權的授權碼時的順序。
按一下完成。

「管理授權」精靈指出浮動授權配置是否成功。

下次開啟已啟用的產品時，將建立連線來連接授權伺服器，從可用的浮動授權碼儲存區取得授權碼。

購買授權

如果產品授權即將到期，或您想要為團隊成員取得更多產品授權，您可以購買新的授權。

若要購買和啟用產品，請完成下列步驟：

決定您要購買的授權類型。
請至 ibm.com^(R) 或聯絡 IBM 業務代表來購買產品授權。如需詳細資料，請造訪 IBM 的 How to buy 軟體網頁。
視您購買的授權類型而定，請以您收到的「權利證明」執行下列其中一個步驟來啟用產品：
- 如果為產品購買「授權使用者授權」請至 Passport Advantage，依指示下載產品啟動套件。
- 如果為產品購買「浮動授權」，請按一下 IBM Rational Licensing and Download site 鏈結，完成登入（需要註冊 IBM），然後選取鏈結來連接 IBM Rational 授權碼中心。在此處，您可以利用「權利證明」來取得授權伺服器的浮動授權碼。
  此外，您也可以至 Passport Advantage 下載產品的啟動套件。匯入啟動套件之後，如果您長期在離線狀態下使用 PC，您可以選擇將浮動授權切換成永久軟體授權。

想要匯入啟動套件或啟用產品的浮動授權支援時，請利用 IBM Installation Manager 的「管理授權」精靈。

在 Linux 工作站增加檔案控點數目

重要事項：為獲得最佳結果，在您使用 Rational 產品前，請增加提供給 Rational Application Developer 的檔案控點數目，這是因為它在每一項程序方面所用的檔案控點數目超過預設限制 1024 個。（系統管理者可能需要採取這項變更。）

在 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 4.0 版會有這個檔案。如果沒有這個檔案，您可考慮在上述步驟 4 中使用較小的數字（例如 2048）。您必須執行這個動作，使大部分使用者在每個程序允許開啟的檔案數目上有合理的低限。如果您在第 4 步驟中使用相當低的數字，這個動作就比較不重要。不過，如果您在步驟 4 中選擇設定較高的數字，因而無法在 limits.conf 檔中設立限制，可能會嚴重影響電腦效能。
以下是範例 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。

Windows 按一下開始 -> 程式集 -> <套件群組名稱> -> IBM Rational Application Developer -> IBM Rational Application Developer. 例如，按一下開始 -> 程式集 -> IBM Software Development Platform -> IBM Rational Application Developer -> IBM Rational Application Developer

若要從指令行啟動 Rational Application Developer：

<產品安裝目錄>\eclipse.exe -product com.ibm.rational.rad.product.ide
<產品安裝目錄>/eclipse -product com.ibm.rational.rad.product.ide

修改安裝

IBM Installation Manager 的「修改套件」精靈可讓您變更已安裝的產品套件的語言和特性選擇。

依預設，除非儲存庫喜好設定指向本端更新站台，否則需要用到網際網路。如需相關資訊，請參閱 Installation Manager 說明。

註:

在修改之前，請先關閉所有以 Installation Manager 安裝的程式。

若要修改已安裝的產品套件：

從 Installation Manager 的「開始」頁面，按一下修改套件圖示。
在「修改套件」精靈中，選取 Rational Application Developer 產品套件的安裝位置，再按下一步。
在「修改」頁面上，在「語言」下選取套件群組的語言，再按下一步。套件的使用者介面和文件將會安裝相對應的國家語言翻譯。請注意，您的選擇會套用至安裝在此套件群組下的所有套件。
在「特性」頁面上，選取您要安裝或移除的套件特性。
1. 如需進一步瞭解特性，請按一下特性，在詳細資料下查看簡要說明。
2. 若要查看特性的相依關係，請選取顯示相依關係。按一下特性時，「相依關係」視窗中會顯示依賴此特性的任何特性和此特性依賴的任何特性。在套件中選取或排除特性時，Installation Manager 會自動維護對其他特性的任何相依關係，並顯示更新的下載大小和安裝的磁碟空間需求。
特性選取完畢之後，請按下一步。
在「摘要」頁面上，在修改安裝套件之前先複查您的選擇，然後按一下修改。
選擇性的: 修改程序完成時，請按一下檢視日誌檔，查看完成日誌。

更新 Rational Application Developer

您可以為 IBM Installation Manager 所安裝的套件安裝更新項目。

依預設，除非儲存庫喜好設定指向本端更新站台，否則需要用到網際網路。如需相關資訊，請參閱 Installation Manager 說明。

註:

在更新之前，請先關閉所有以 Installation Manager 安裝的程式。

若要搜尋並安裝產品套件更新項目：

從 Installation Manager 的「開始」頁面，按一下更新套件。
在「更新套件」頁面上，選取 Rational Application Developer 產品套件的安裝位置，然後按下一步。 Installation Manager 會在自己的儲存庫及 Rational Application Developer 預先定義的更新站台上搜尋更新項目。進度指示器會顯示正在搜尋
找到的更新項目會顯示在「更新項目」頁面上。依預設只會顯示並選取建議的更新項目。按一下顯示全部可顯示所有可用的更新項目。接受預設選擇或選取其他更新項目，再按下一步。
在「授權」頁面上，閱讀更新項目的授權合約。如果同意所有授權合約的條款，請按一下我接受授權合約的條款，然後按下一步。
複查「摘要」頁面上的詳細資料，然後按一下更新。當更新程序完成時，「完成」頁面會顯示結果。
選擇性的: 按一下檢視日誌檔鏈結，檢視完成日誌。
按一下完成，關閉精靈。

解除安裝 Rational Application Developer

Installation Manager 的「解除安裝套件」選項可讓您從單一安裝位置上解除安裝套件。您也可以從每一個安裝位置上逐一解除安裝所有已安裝的套件。

若要解除安裝套件，必須以您安裝產品套件時所用的使用者帳戶來登入系統。

若要解除安裝套件：

關閉您以 Installation Manager 安裝的程式。
在「開始」頁面上，按一下解除安裝套件圖示。
在「解除安裝套件」頁面上，選取您要解除安裝的 Rational Application Developer 產品套件。按下一步。
在「摘要」頁面上，複查將解除安裝的套件清單，然後按一下解除安裝。解除安裝完成之後，畫面上會顯示「完成」頁面。
按一下完成，結束精靈。

安裝選用性軟體

Rational Application Developer 安裝映像檔中包含下列選用性軟體：

IBM WebSphere Portal 5.1 版測試環境
IBM WebSphere Portal 6.0 版測試環境
IBM Rational Agent Controller 7.0.1 版
IBM Rational ClearCase LT 7.0 版
Crystal Reports Server XI Release 2

安裝 WebSphere Portal 測試環境 5.1.0.x 版

入口網站測試環境可讓您從 Rational Application Developer 工作台來測試入口網站應用程式。 .

有關在 Windows 和 Linux 工作站上安裝和解除安裝 WebSphere Portal 5.1.0.x 的完整指示，以及詳細的系統需求說明，請參閱 WebSphere Portal 5.1 資訊中心 (http://www.ibm.com/websphere/portal/library)。

從 CD-ROM 或電子映像檔安裝 WebSphere Portal 測試環境 5.1.0.x 版

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

若要安裝 WebSphere Portal 測試環境 5.1.0.x，請遵循下列步驟：

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

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

依預設，WebSphere Portal 5.1 測試環境會安裝和使用 Cloudscape^(TM) 資料庫，來儲存存取入口網站資源時所用的使用者身分、認證和許可權等相關資訊。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.0.x 版

您可以使用圖形式解除安裝程式來解除安裝 WebSphere Portal 測試環境 5.1.0.x。

請在 WebSphere Portal 5.1 資訊中心 (http://www.ibm.com/websphere/portal/library) 中，參閱有關解除安裝 Windows 和 Linux 系統中之 WebSphere Portal 5.1 的完整指示。您可以找到在解除安裝之前可能採取的決策和步驟等相關資訊，也可以找到其他解除安裝方法（例如：手動解除安裝）的相關資訊。

若要使用圖形式解除安裝程式，來解除安裝 WebSphere Portal 測試環境 5.1.0.x，請執行下列動作：

執行下列步驟之一，以啟動解除安裝程式：
- 僅適用於 Windows：在「控制台」上，從「新增/移除程式」視窗中選取 WebSphere Portal。
- 從命令提示字元來啟動解除安裝程式。
  1. 切換至 portal__server_root/uninstall 目錄
  2. 根據您的作業系統，執行下列指令：
選取解除安裝時所用的語言，並按一下確定。此時會顯示「歡迎使用」畫面。
選取要解除安裝的元件，並按下一步。
註:

WebSphere Application Server 解除安裝程式會故意將其根登錄機碼遺留在 Windows 登錄中。
按下一步，以顯示確認畫面。
按下一步，開始進行解除安裝程序。當解除安裝程式完成時，程式會顯示確認畫面。
按一下完成，關閉解除安裝程式。
重新開機。您必須如此做，尤其是如果您想將 WebSphere Portal 重新安裝在相同機器上時更需如此做。

安裝 WebSphere Portal 6.0 版測試環境

入口網站測試環境可讓您從 Rational Application Developer 工作台來測試入口網站應用程式。 .

有關在 Windows 和 Linux 工作站上安裝和解除安裝 WebSphere Portal 6.0 的完整指示，以及詳細的系統需求說明，請參閱 WebSphere Portal 5.0 資訊中心 (http://www.ibm.com/websphere/portal/library)。

從 CD-ROM 或電子映像檔安裝 WebSphere Portal 測試環境 6.0 版

以下指示會引導您完成 WebSphere Portal 6.0 的安裝。如需完整的詳細說明，請參閱 IBM WebSphere Portal 6.0 版資訊中心 (ttp://www.ibm.com/websphere/portal/library)。

若要安裝 WebSphere Portal 測試環境 6.0，請遵循下列步驟：

如果您從電子映像檔來安裝，請確定您已將所有的入口網站磁碟映像檔擷取或複製到相同的目錄中。請參閱解壓縮已下載的檔案。
如果您已安裝 WebSphere Application Server、WebSphere Portal、WebSphere Application Server 整合測試環境或 WebSphere Portal 整合測試環境，請確定它們全部已經停止，且務必停止任何 HTTP 伺服器。否則，安裝可能會失敗。
使用下列方法之一，來啟動 WebSphere Portal 測試環境 6.0 版安裝程式：
- 從 Rational Application Developer 啟動程式（請參閱執行啟動程式），按一下 WebSphere Portal 6.0 版測試環境。
- 插入 WebSphere Portal 6.0 安裝 CD。在 Windows 系統上，安裝程式應會自動啟動。若未啟動，或者您是安裝在 Linux 系統上，請從安裝 CD 或磁碟映像檔的根目錄，執行下列指令：
  - install.bat
  - install.sh
選取用來執行安裝程式的語言，再按一下確定來繼續作業。
閱讀安裝程式歡迎使用頁面中的資訊，按下一步。
閱讀授權合約和非 IBM 條款。如果同意，請選取我接受 IBM 和非 IBM 條款，並按下一步
接受 WebSphere Application Server 6.0 版的預設安裝目錄，或瀏覽以選取新目錄，然後按下一步。預設安裝目錄為 C:\Program Files\IBM\Portal60UTE\AppServer（若為 Windows）或 opt/IBM/Portal60/AppServer（若為 Linux）。除非您沒有足夠的空間，否則，建議您使用預設安裝目錄。
接受預設 WebSphere 應用程式伺服器內容，或指定下列項目：
- Cell 名稱。
- 在 WebSphere Application Server Cell 中，您要安裝 WebSphere Portal 應用程式伺服器的節點。此值在同一 Cell 中的其他節點名稱間必須是唯一的。一般而言，此值和電腦的主機名稱相同。
- 執行 WebSphere Application Server 之電腦的完整 DNS 名稱、簡短 DNS 名稱或 IP 位址。請勿使用本端主機或迴路位址。
輸入 WebSphere Application Server 管理者的使用者 ID 與密碼。使用者 ID 或密碼不能有空格，此外請確定密碼長度至少有五個字元。在安裝後，會使用這個具備管理者權限的使用者 ID 來存取 WebSphere Application Server。請注意，這個使用者 ID 僅用來登入 WebSphere Application Server，而和用來存取作業系統本身的任何使用者 ID 無關。按下一步以繼續。
選取您是否想安裝 WebSphere Portal Process Server 以具備商業程序支援，並按下一步，繼續進行。 重要事項：在您安裝產品時，如果您有意將產生的節點新增至受管理的 Cell 中，或將該節點作為叢集的一部分，可採取下列兩種做法之一：
- 如果您在受管理的 Cell 或叢集中需要商業程序整合支援，則必須將 WebSphere Portal 安裝在一個已聯合至部署管理程式的節點上。請結束這項安裝程序，並參閱 WebSphere Portal 6.0 版資訊中心中的「設定叢集」主題。
- 如果您在受管理的 Cell 或叢集中不需要商業程序整合支援，請在這個畫面上選取「不安裝 WebSphere Process Server」，並繼續進行。
如果您在受管理的 Cell 或叢集中需要商業程序整合支援，則必須將 WebSphere Portal 安裝在一個已聯合至部署管理程式的節點上。請結束這項安裝程序，並參閱「設定叢集」，取得相關指示。如果您將 WebSphere Portal（包含商業程序整合支援）安裝在不受管理的節點上，則稍後無法將該節點新增至受管理的 Cell 中或將它作為叢集的一部分。
接受 Portal Server 的預設安裝目錄，或瀏覽以選取新的目錄，再按下一步。預設安裝目錄為 C:\Program Files\IBM\Portal60UTE\PortalServer （若為 Windows）或 opt/IBM/Portal60UTE/PortalServer（若為 Linux）。除非您沒有足夠的空間，否則，建議您使用預設安裝目錄。如果您指定的目錄不存在，則會建立該目錄。若是安裝在 Windows 上，請勿在安裝路徑中使用句點 (.)。按下一步
輸入 WebSphere Portal 管理者的使用者 ID 與密碼。使用者 ID 或密碼不能有空格，此外請確定密碼長度至少有五個字元。在安裝後，會使用這個具備管理者權限的使用者 ID 來存取 WebSphere Portal。請注意，這個使用者 ID 僅用來登入 WebSphere Portal，而和用來存取作業系統本身的任何使用者 ID 無關。如果您打算使用「輕量型目錄存取通訊協定 (LDAP)」目錄來管理您的使用者，請確定您在此處指定的管理者使用者 ID，符合「使用者 ID 和密碼中的特殊字元」中指定的建議事項。按下一步。
驗證已安裝產品，並按下一步。此時安裝程式會開始安裝所選的元件。在整個安裝與配置程序中，安裝程式會顯示各種不同元件的進度指示器。
註:

安裝作業可能需要一段時間來完成。請使用進度指示器和您平台的程序監視機能，來監視整體的安裝進度。
若是從 CD 安裝：當出現提示時，請插入適當的 WebSphere Portal 6.0 CD，並指定其光碟機位置。
當安裝完成時，安裝程式會顯示確認畫面，其中列出已安裝的元件。請先記下以下資訊，再按一下完成：
- 用來存取 WebSphere Portal 的埠號會顯示在確認畫面上。請記下埠號，以便在驗證 WebSphere Portal URL 時使用。此值亦會儲存在 <portal installation directory>/config/wpconfig.properties 檔中的 WpsHostPort 內容內。
- 如果您想使用「WebSphere Portal 首要步驟」來存取 WebSphere Portal，請確定已選取「啟動首要步驟」。透過「首要步驟」，您可以存取 WebSphere Portal 或閱讀 WebSphere Portal 文件。
按一下完成。
若要驗證 WebSphere Portal 是否正在執行，請在瀏覽器中開啟下列 URL： http://example.com:port_number/wps/portal；其中 example.com 為執行 WebSphere Portal 之機器的完整主機名稱，port_number 為顯示在確認畫面上的埠號。例如 http://www.ibm.com:10038/wps/portal。
WebSphere Portal 正在啟動和執行。 重要事項：此刻您是在啟用安全的情況下執行。

如需使用 WebSphere Portal 6.0 的相關資訊，請參閱 IBM WebSphere Portal 6.0 版資訊中心 (ttp://www.ibm.com/websphere/portal/library)。

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

WebSphere Portal 測試環境 6.0 版會將配置、存取控制（例如：存取入口網站資源時所用的使用者身分、認證和許可權）和使用者資料儲存在資料庫中。依預設， WebSphere Portal 會安裝和使用 Cloudscape 資料庫。然而，您或許想使用另一種支援的資料庫。

如需安裝和配置另一種支援的資料庫（如 DB2、Oracle 或 SQL Server 資料庫）以搭配 WebSphere Portal 6.0 版使用的相關資訊，請參閱 WebSphere Portal 6.0 版資訊中心 (www.ibm.com/websphere/portal/library)。您可在 WebSphere Portal 6.0 版資訊中心的配置 -> 配置資料庫下找到相關指示。

解除安裝 WebSphere Portal 測試環境 6.0 版

您可以使用圖形式解除安裝程式來解除安裝 WebSphere Portal 測試環境 6.0。

請在 WebSphere Portal 6.0 資訊中心 (http://www.ibm.com/websphere/portal/library) 中，參閱有關解除安裝 Windows 和 Linux 系統中之 WebSphere Portal 6.0 的完整指示。您可以找到規劃解除安裝以及其他解除安裝方法（例如：手動解除安裝）等相關資訊。

若要使用圖形式解除安裝程式，來解除安裝 WebSphere Portal 測試環境 6.0，請執行下列動作：

請在 WebSphere Portal 6.0 資訊中心 (http://www.ibm.com/websphere/portal/library) 中，參閱有關規劃解除安裝 Windows 和 Linux 系統中之 WebSphere Portal 6.0 的完整指示。
執行下列步驟之一，以啟動解除安裝程式：
- 僅適用於 Windows：在「控制台」上，從「新增/移除程式」視窗中選取 WebSphere Portal。
- 從命令提示字元來啟動解除安裝程式。
  1. 切換至 portal_server_root/uninstall 目錄
  2. 根據您的作業系統，執行下列指令：
    - ./uninstall.sh
    - uninstall.bat
選取解除安裝時所用的語言，並按一下確定。此時會顯示「歡迎使用」畫面。
選取要解除安裝的元件，並按下一步。
註:

WebSphere Application Server 解除安裝程式會故意將其根登錄機碼遺留在 Windows 登錄中。
按下一步，以顯示確認畫面。
按下一步，開始進行解除安裝程序。當解除安裝程式完成時，程式會顯示確認畫面。
按一下完成，關閉解除安裝程式。
重新開機。您必須如此做，尤其是如果您想將 WebSphere Portal 重新安裝在相同機器上時更需如此做。

安裝 Agent Controller

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

側寫應用程式所用的側寫工具。Agent Controller 必須安裝在所側寫之應用程式的相同系統中。
用來匯入遠端日誌檔的記載工具。Agent Controller 必須已安裝好，且正在匯入日誌檔的來源遠端系統中執行。
執行 Test Case 的元件測試工具。Agent Controller 必須安裝在您執行 Test Case 的系統中。
在 WebSphere Application Server 5.0 或 5.1 版中進行遠端應用程式測試的工具。（您不必為了在遠端發佈應用程式或在本端發佈或測試應用程式而安裝 Agent Controller。）請注意，WebSphere Application Server 6.0 版已內建了這項功能，因此，6.0 版目標伺服器不需要 Agent Controller。

附註^(R)：

強烈建議您將 Agent Controller 安裝在防火牆後面。
如需 Agent Controller 使用時的安全事項的相關資訊，請參閱 Agent Controller 文件。
在安裝軟體之前，不會安裝 Agent Controller 的線上文件。這時會將文件新增至線上說明。
在安裝 Agent Controller 7.0.1 版之前，您必須按照下列指示先解除安裝舊版 Agent Controller。
如需無聲自動安裝 Agent Controller 的相關資訊，請參閱下列指示。

硬體需求

Windows、 Linux/IA32：至少使用 Intel^(R) Pentium 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/40：iSeries^(TM)（依照作業系統的需求）
z/OS^(R)、LINUX/S39：zSeries^(R)（依照作業系統的需求）
Linux/ppc64：pSeries^(R) 和 iSeries 型的 POWER5^(TM) 處理器（依作業系統的要求）
至少需要 512 MB RAM（建議使用 768 MB RAM）
磁碟空間：
- 您需要至少 100 MB 的安裝磁碟空間
顯示器解析度：
- 至少需要 800 x 600 顯示畫面（建議使用 1024 x 768）

支援的平台

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

支援 Agent Controller 7.0.1 版的平台如下：

PowerPC（32 位元）中的 AIX 5.2 版、5.3 版和 5L
zSeries（32 位元）中的 z/OS V1R4、V1R5、V1R6 和 V1R7
iSeries 中的 OS/400^(R) V5R2、V5R3 和 V5R4
Linux 2.4 和 2.6 核心。舉例來說，支援的發行套件有：
- Intel IA32 中的 Red Hat Linux Advanced Server 2.1 版
- PowerPC（64 位元）中的 Red Hat Enterprise Linux AS Release 3
- Red Hat Enterprise Linux (RHEL) 3.0 版和 4.0 版
- Intel IA32 中的 SuSE Linux Enterprise Server (SLES) 第 9 版
- zSeries（32 位元）中的 SuSE Linux Enterprise Server (SLES) 第 8 版
Intel IA32 中的 Windows 2000 Server 或 Advanced Server (SP4)
Intel IA32 中的 Windows 2000 Professional (SP3)
Intel IA32 中的 Windows 2003 Server Standard and Enterprise (SP1)
EM64T（64 位元）中的 Windows 2003 Server Enterprise x64 Edition (SP1)
Intel IA32 中的 Windows XP Professional (SP2)
PA-RISC 中的 HP-UX 11.0 版、11i 版
SPARC 中的 Sun Solaris 第 8 版、第 9 版和 10.0 版

支援的 JVM

一般而言，Agent Controller 可搭配 Java 虛擬機器 (JVM) 1.4 版以上一起使用。以下是 Agent Controller 已通過測試的 JVM 版本（Java 完整版本）：

AIX：J2RE 1.4.1 IBM AIX 建置 ca1411-20040301
AIX： J2RE 1.5.0 IBM AIX 建置 pap32devifx-20060310 (SR1)
HP-UX：J2RE 1.4.2.03-040401-18:59-PA_RISC2.0
Linux for Intel IA32： J2RE 1.4.1 IBM 建置 cxia321411-20040301；J2RE 1.4.2 IBM。
Linux for Intel IA32： J2RE 1.5.0 IBM Linux 建置 pxi32dev-20060511 (SR2)
Linux for PPC64：J2RE 1.4.2 IBM 建置 cxp64142-20040917（已啟用 JIT：jitc）
Linux for PPC64：J2RE 1.5.0 IBM Linux 建置 pxp64devifx-20060310 (SR1)
Linux for OS/390^(R)：J2RE 1.4.1 IBM 建置版 cx3901411-20040301
Linux for OS/390： J2RE 1.4.2 IBM 建置 cx390142-20050609
z/OS：J2RE 1.4.1 IBM z/OS Persistent Reusable VM 建置 cm1411-20030930
z/OS： J2RE 1.5.0 IBM z/OS 建置 pmz31dev-20051104a
OS/400： J2RE 1.4 IBM
OS/400： J2RE 1.5 IBM
Solaris SPARC：Sun Java 2 Standard Edition（建置 1.4.2_04-b05）
Solaris SPARC：1.5.0_06-b05
Windows： IA32 J2RE 1.4.1 IBM Windows 32 建置 cn1411-20040301a；J2RE 1.4.2 IBM Windows 32；Sun Java 2 Standard Edition（建置 1.4.2_04-b05）
Windows_IA32：1.5.0_04-b05、J2RE 1.5.0 IBM Windows 32 建置 pwi32dev-20051222
Windows_EM64T（64 位元）Sun Java 2 Runtime Environment Standard Edition （建置 1.5.0_06-b05）1.5.0 06 版

尋找安裝檔

安裝檔案位於 Agent Controller 光碟的下列目錄中：

AIX：<Agent Controller CD>/aix_powerpc
HP-UX：<Agent Controller CD>/hpux
OS/400：<Agent Controller CD>/os400
z/Series 上的 Linux：<Agent Controller CD>/linux_s390
Intel IA32 上的 Linux：<Agent Controller CD>/linux_ia32
PPC64 上的 Linux： <Agent Controller CD>/linux_ppc64
Solaris：<Agent Controller CD>/solaris_sparc
Intel IA32 上的 Windows：<Agent Controller CD>\win_ia32
Intel 延伸記憶體 64 技術（64 位元）上的 Windows：<Agent Controller CD>\win_em64t
Intel Itanium^(R) 系統（64 位元）上的 Windows：<Agent Controller CD>\win_ipf
z/OS：<Agent Controller CD>/os390

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

解除安裝舊版 Agent Controller

附註：

在安裝 Agent Controller 7.0.1 版之前，您必須先解除安裝舊版 Agent Controller：

若是發現 Agent Controller 7.0 或 6.x，Agent Controller 7.0.1 版安裝程式會阻止安裝，並發出警告：請移除任何現有的 IBM Rational Agent Controller，再重新執行安裝。若是使用無聲自動安裝程式， Agent Controller 7.0.1 版安裝程式會直接結束安裝，而不發出任何警告。
若是發現早已安裝 Agent Controller 7.0.1 版，安裝程式會顯示下列警告：此產品已安裝在 <rac_install_dir>。若要改寫現有的安裝環境，請按「下一步」。如果您選擇繼續安裝，則安裝程式會改寫現有的安裝環境。當使用無聲自動安裝程式時，則會直接改寫現有的安裝環境，而不發出任何警告。

若是在 Windows 上解除安裝 Agent Controller 6.x 版，您必須手動移除任何殘留的檔案。其做法是停止並解除安裝 Agent Contoller，然後清除以下任何在解除安裝後可能遺留的檔案：

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

若是在 UNIX^(R) 平台上解除安裝 Agent Controller 6.x 版或 7.x 版，您必須手動移除任何殘留的檔案。其做法是停止並解除安裝 Agent Contoller，然後清除以下任何在解除安裝後可能遺留的檔案：

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

在 7.0.1 版中，Agent Controller 安裝在以下位置：

Windows：<rac_install_dir>\bin
Linux：<rac_install_dir>/lib
其中，<rac_install_dir> 是 Agent Controller 的安裝目錄。

安裝 Agent Controller

以管理者（或 root）身分登入。
切換至適當平台的安裝檔的解壓縮目錄。
繼續進行安裝之前，請先關閉所有的 Eclipse 平台。
執行 setup.exe 程式。如果是非 Windows 平台，請執行 setup.bin。
在歡迎畫面上按下一步以繼續。
閱讀授權合約。
選取我接受授權合約的條款，再按下一步繼續作業。
指定 Agent Controller 的安裝路徑，再按下一步繼續作業。
指定 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 啟動。

按下一步以繼續。
選用：如果在步驟 9 選取「WebSphere Application Server 的遠端支援」，請指定 IBM WebSphere Application Server 的版本。按下一步以繼續。
選用：如果在步驟 9 選取「WebSphere Application Server 的遠端支援」，請指定 IBM WebSphere Application Server 5.0 版（僅限 Windows）和 5.1 版的路徑。按下一步以繼續。
指定哪些主機可以存取 Agent Controller。其選項如下：
- 只限這部電腦：只允許本端主機存取 Agent Controller。
- 特定電腦：允許指定的用戶端清單存取 Agent Controller。如果選取這個選項，且在步驟 9 已選取「安全」，請按下一步，進入「存取清單」畫面。鍵入可存取 Agent Controller 的主機名稱清單，以逗點區隔。
- 任何電腦：允許任何用戶端存取 Agent Controller。（預設選項。）
  註:
  
  如果使用鑑別機制，例如「輕量型目錄存取通訊協定 (LDAP)」，則選取「任何電腦」會要求您在安裝程序完成之後停用 Agent Controller 使用者鑑別。如需詳細資料，請參閱 Agent Controller 文件。
按下一步以繼續。
選擇安全設定
註:

如果選取「任何電腦」，則依預設會啟用安全（以下稱為「啟用」）。通訊將加密，且所有連線都將經過鑑別。若要停用安全，請參閱 Agent Controller 文件。
- 停用：通訊不會加密，而且存取控制將受限於指定的主機清單。（「任何電腦」除外的預設選項。）
- 啟用：通訊將會加密，而且將強制所有連線執行 Secure Sockets Communications 的鑑別。
  如果選取「啟用」，請按下一步，在安全下鍵入可連接 Agent Controller 的使用者清單，以逗點區隔。這些使用者必須經過鑑別，才能使用這項工具。
按下一步以繼續。
在摘要畫面按下一步，開始安裝 Agent Controller。
安裝完成之後，按一下完成。

無聲自動安裝 Agent Controller

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

參數	說明
-silent 如果採用無聲自動方式，則必須提供下列變數： -V licenseAccepted=true	選用：向安裝程式表示要無聲自動執行，不然會出現傳遞輸入的安裝精靈。
-P installLocation	選用：指定安裝路徑。預設安裝路徑是 '$D(install)/IBM/AgentController'。範例： Windows： C:\Program Files\IBM\AgentController 若為 UNIX^(R)/Linux： /opt/IBM/AgentController
-V VJavaPath	必要：指定 Java 執行檔的完整路徑
-V VAccessLocal -V VAccessCustom -V VAccessAll	選用：指定用戶端可如何連接 Agent Controller (ALL, LOCAL, CUSTOM)。以下變數只能有一個設為 "true"，其他必須設為 false。依預設是 VAccessAll="true" 任何電腦： VAccessAll="true" ：容許任何用戶端僅限這台電腦： VAccessLocal="true" ：只容許本端主機 (default) 特定的電腦： VAccessCustom="true" ：容許一群用戶端（也需要 -V VHosts 參數）
-V VHosts	如果 VAccessCustom="true，則此項為必要的指定用戶端主機名稱，以逗點區隔
以下兩個變數皆必須指定，且應為對立的： -V VSecurity="true" 或 "false" -V VSecurityDisable="false" 或 "true"	選用：（true、false）預設值： VSecurity=true VSecurityDisable=false
-V VUsers	必要：如果 VSecurity="true" 指定哪些使用者可以連接 Agent Controller
-V VWAS6 -V VWAS5	選用：使用 WAS V6 時，-V VWAS6="true"（預設值）使用 WAS V5.x 時，-V VWAS5="true"
-V VWAS_HOME_V50 -V VWAS_HOME_V51	選用：如果 -V VWAS5="true" 指定 IBM WebSphere Application Server 5.1 和 5.0 的安裝位置

參數

說明

-silent

如果採用無聲自動方式，則必須提供下列變數：

-V licenseAccepted=true

選用：向安裝程式表示要無聲自動執行，不然會出現傳遞輸入的安裝精靈。

-P installLocation

選用：指定安裝路徑。預設安裝路徑是 '$D(install)/IBM/AgentController'。

範例：

Windows： C:\Program Files\IBM\AgentController

若為 UNIX^(R)/Linux： /opt/IBM/AgentController

-V VJavaPath

必要：指定 Java 執行檔的完整路徑

-V VAccessLocal

-V VAccessCustom

-V VAccessAll

選用：指定用戶端可如何連接 Agent Controller (ALL, LOCAL, CUSTOM)。以下變數只能有一個設為 "true"，其他必須設為 false。依預設是 VAccessAll="true"

任何電腦： VAccessAll="true" ：容許任何用戶端
僅限這台電腦： VAccessLocal="true" ：只容許本端主機 (default)
特定的電腦： VAccessCustom="true" ：容許一群用戶端（也需要 -V VHosts 參數）

-V VHosts

如果 VAccessCustom="true，則此項為必要的

指定用戶端主機名稱，以逗點區隔

以下兩個變數皆必須指定，且應為對立的：

-V VSecurity="true" 或 "false"
-V VSecurityDisable="false"
 或 "true"

選用：（true、false）

預設值：

VSecurity=true 
VSecurityDisable=false

-V VUsers

必要：如果 VSecurity="true"

指定哪些使用者可以連接 Agent Controller

-V VWAS6

-V VWAS5

選用：

使用 WAS V6 時，-V VWAS6="true"（預設值）

使用 WAS V5.x 時，-V VWAS5="true"

-V VWAS_HOME_V50

-V VWAS_HOME_V51

選用：如果 -V VWAS5="true"

指定 IBM WebSphere Application Server 5.1 和 5.0 的安裝位置

範例：

從指令行安裝：

-P installLocation="D:\IBM\AgentController"

-V VJavaPath=" D:\jdk1.4.2\jre\bin\java.exe "

-V VAccessLocal="false"

-V VAccessCustom="true"

-V VAccessAll="false"

-V VHosts="host1,host2"

-V VSecurity="true"

-V VSecurityDisable="false"

-V VUsers="user1,user2"

-V VWAS5="true"

-V VWAS_HOME_V51="D:\WebSphere5.1\AppServer"

-V VWAS_HOME_V50="D:\WebSphere5.0\AppServer"

使用回應檔來安裝：

您可以建立回應檔（例如 setup.rsp）來儲存所有參數，而不在指令行中指定。以下是 Windows 範例， Linux/UNIX 平台則類似：

setup.exe -silent -options setup.rsp

回應檔的內容：

      # Start of response file

-P installLocation="D:\IBM\AgentController"

-V licenseAccepted="true"

-V VJavaPath=" D:\jdk1.4.2\jre\bin\java.exe "

-V VAccessLocal="false"

-V VAccessCustom="true"

-V VAccessAll="false"

-V VHosts="host1,host2"

-V VSecurity="true"

-V VSecurityDisable="false"

-V VUsers="user1,user2"

-V VWAS5="true"

-V VWAS_HOME_V51="D:\WebSphere5.1\AppServer"

-V VWAS_HOME_V50="D:\WebSphere5.0\AppServer"

 
      # End of response file

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

在 Windows 中，會自動啟動 Agent Controller 系統服務 (RAService.exe)。
使用 Windows「控制台」下的「服務」對話框，啟動或停止 Agent Controller 服務（開始 > 設定 > 控制台 > 系統管理工具 > 服務 >IBM Rational^(R) Agent Controller）。

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

在非 Windows 平台中，不會自動啟動 Agent Controller 程序 (RAServer)。您必須自行啟動它。

重要事項：非 Windows 平台的下列環境設定必須在啟動 Agent Controller 之前設定。

Solaris：/usr/sbin 必須先新增至 PATH 環境中，之後，才能啟動 Agent Controller。請輸入下列指令來設定路徑：
```
PATH=/usr/sbin:$PATH
export PATH
```
AIX：對於某些 JVM，LDR_CNTRL 環境變數必須設為 USERREGS，才能正常使用 Agent Controller。若要設定這個變數，請在執行 RAStart.sh Script 之前先執行下列指令：
```
export LDR_CNTRL=USERREGS
```

Linux、AIX、Solaris、HP-UX、z/OS：RAServer 需要含有執行檔程式庫（如 libjvm.so）的 JRE 目錄加入程式庫路徑環境變數中。下表顯示每個平台的路徑變數設定，以平台的支援 JVM 之預設安裝位置為基礎。

附註：: 您輸入的路徑必須符合安裝 Agent Controller 時將指定之 JRE 的路徑。Agent Controller 將使用您指定的 JRE 來啟動 Java 應用程式。

平台	程式庫路徑設定
AIX	LIBPATH=/usr/java14/jre/bin: /usr/java14/jre/bin /classic:$LIBPATH export LIBPATH
HP-UX	SHLIB_PATH=/opt/java1.4/jre/ lib/PA_RISC/server:/opt/java1.4/ jre/lib/PA_RISC:$SHLIB_PATH export SHLIB_PATH
Linux/IA32	LD_LIBRARY_PATH=/opt/IBMJava2-141/ jre/bin/classic:/opt/IBMJava2-141 /jre/bin:$LD_LIBRARY_PATH export LD_LIBRARY_PATH
Linux/PPC64	LD_LIBRARY_PATH=/opt/IBMJava2-ppc64-142/ jre/bin:/opt/IBMJava2-ppc64-142/ jre/bin/classic:$LD_LIBRARY_PATH export LD_LIBRARY_PATH
Linux/390	LD_LIBRARY_PATH=/opt/IBMJava2-s390-141/ jre/bin/classic:/opt/IBMJava2-s390-141/ jre/bin:$LD_LIBRARY_PATH export LD_LIBRARY_PATH
Solaris	LD_LIBRARY_PATH=/usr/j2sdk1.4.2_04/ jre/lib/sparc/server: /usr/j2sdk1.4.2_04/jre/lib/ sparc:$LD_LIBRARY_PATH export LD_LIBRARY_PATH
z/OS	LIBPATH=/usr/lpp/java/IBM/ J1.4/bin/classic:/usr/lpp /java/IBM/J1.4/bin:$LIBPATH export LIBPATH

若要啟動 Agent Controller 程序，請切換至安裝位置的 bin 目錄（例如 /opt/IBM/AgentController/bin），然後執行
```
./RAStart.sh
```
若要停止 Agent Controller 程序，請切換至安裝位置的 bin 目錄（例如 /opt/IBM/AgentController/bin），然後執行
```
./RAStop.sh
```

在 Windows 工作站解除安裝 Agent Controller

您可以從「控制台」下的新增/移除程式對話框來移除 Agent Controller。
若要執行無聲解除安裝，請從安裝位置的 _uninst 目錄（例如 C:\Program Files\IBM\AgentController\_uninst）執行 uninstall.exe -silent 指令。

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

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

在工作站解除安裝有多個參照的 Agent Controller

Agent Controller 7.0.1 版不容許將產品的多個實例安裝在單一工作站上。執行額外的安裝時（獨立式安裝或產品內含的安裝），Agent Controller 會將起始新安裝的產品名稱的參照記錄下來。

如果 Agent Controller 安裝多次，不論是獨立式安裝或產品內含的安裝（換句話說，有多個參照計數），則必須等到最後參照的產品解除安裝時，才能解除安裝 Agent Controller；最後參照的產品仍然需要 Agent Controller。

在仍有其他產品需要 Agent Controller 的情況下，如果試圖解除安裝 Agent Controller，解除安裝不會執行，將出現「無法解除安裝這個產品，因為另一個產品需要這個產品」的訊息。

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

解除安裝舊版 Agent Controller

如果您有舊版的 Agent Controller，請先停止並解除安裝，再安裝這個版本。

安裝 Agent Controller

在 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)
```
如果您想安裝「國家語言」套件，請完成以下的步驟 11 至 16。否則，請繼續進行步驟 17。
在 iSeries 主機的 HYADESNL1 程式庫中，建立兩個空的保存檔 HYADESNL1.SAVF 和 HYADESNL2.SAVF：
```
CRTSAVF IBMRAC/HYADESNL1
CRTSAVF IBMRAC/HYADESNL2
```
利用 FTP 將安裝 CD 中的 NL 檔（HYADESNL1.SAVF 和 HYADESNL2.SAVF）新增至 HYADESDC 程式庫（位於採用 BINARY 模式轉送的 iSeries 主機上）中。
在 iSeries 主機的 IBMRAC 程式庫中，建立兩個空的保存檔 IBMRACNL1.SAVF 和 IBMRACNL1.SAVF：
```
CRTSAVF IBMRAC/IBMRACNL1
CRTSAVF IBMRAC/IBMRACNL2
```
利用 FTP 將安裝 CD 中的 NL 檔（IBMRACNL1.SAVF 和 IBMRACNL1.SAVF）新增至 IBMRAC 程式庫（位於採用 BINARY 模式轉送的 iSeries 主機上）中。

將 HYADESDC 中的保存檔 HYADESNL1.SAVF 和 HYADESNL2.SAVF 還原到 IFS 目錄 /opt/hyadesdc 中。比方說，以單行輸入以下指令：

	RST DEV('/QSYS.LIB/HYADESDC.LIB/HYADESNL1.FILE') OBJ
('/opt/hyadesdc/*') ALWOBJDIF(*ALL)
	RST DEV('/QSYS.LIB/HYADESDC.LIB/HYADESNL2.FILE') OBJ
('/opt/hyadesdc/*') ALWOBJDIF(*ALL)

將 IBMRAC 中的保存檔 IBMRACNL1.SAVF 和 IBMRACNL2.SAVF 還原到 IFS 目錄 /opt/hyadesdc 中。比方說，以單行輸入以下指令：

	RST DEV('/QSYS.LIB/IBMRAC.LIB/IBMRACNL1.FILE') OBJ('/opt/hyadesdc/*') 
ALWOBJDIF(*ALL)
	RST DEV('/QSYS.LIB/IBMRAC.LIB/IBMRACNL2.FILE') OBJ('/opt/hyadesdc/*') 
ALWOBJDIF(*ALL)

安裝好 Agent Controller 之後，請切換至安裝位置的 bin 目錄 /opt/hyades/bin，再輸入下列指令來執行安裝 Script：
```
./SetConfig.sh
```
遵循畫面中的提示來配置 Agent Controller。

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

如果要啟動 Agent Controller，請將 HYADESDC 和 IBMRAC 程式庫新增至程式庫清單中：
```
ADDLIBLE HYADESDC
ADDLIBLE IBMRAC
```
輸入下列指令來送出 RAStart 工作：
```
SBMJOB CMD(CALL RASERVER) JOBD(RASTART)
```
如果要停止 Agent Controller，請輸入下列指令來終止 RAStart 工作：
```
ENDJOB JOB(RASTART)
```
或者，請切換至安裝位置的 bin 目錄 (/opt/hyades/bin)，並執行停止 Script：
```
./RAStop.sh
```

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

移除 HYADESDC 和 IBMRAC 程式庫。
移除 IFS 目錄 /opt/hyadesdc（包括所有子目錄和檔案）。

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

解除安裝舊版 Agent Controller

如果您有舊版的 Agent Controller，請先停止並解除安裝，再安裝這個版本。

安裝 Agent Controller

在 UNIX 系統服務 Shell 中，切換至您要安裝 Agent Controller 的目錄。建議您將它安裝在 /usr/lpp/ 目錄中。
將安裝映像檔 ibmrac.os390.pax、tptpdc.os390.pax 轉送至安裝目錄。
發出下列指令來擷取 Agent Controller 檔：
```
pax -ppx -rvf ibmrac.os390.pax
```
發出下列指令，以擷取測試和效能工具 (TPTP) Agent Controller 檔案：
```
pax -ppx -rvf tptpdc.os390.pax
```
切換至安裝 bin 目錄 (<rac_install_dir>/bin)，並輸入下列指令，以執行 Script 來建立 Agent Controller 程式庫的鏈結：
```
./createLinks.sh
```
在 UNIX 系統服務 Shell 中，發出下列指令來控制 Agent Controller 共用物件檔程式：
```
extattr +p /usr/lpp/IBM/AgentController/lib/*.so
```
如果您想安裝「國家語言」套件，請完成以下的步驟 7 至 8。否則，請繼續進行步驟 9。
將 NL 安裝映像檔 tptpdc.nl1.os390.pax、tptpdc.nl2.os390.pax、ibmrac.os390.nl1.pax、ibmrac.os390.nl2.pax 轉送至安裝目錄。

發出下列指令來擷取 Agent Controller 檔：

	pax -ppx -rf tptpdc.nl1.os390.pax
	pax -ppx -rf tptpdc.nl2.os390.pax
	pax -ppx -rf ibmrac.os390.nl1.pax
	pax -ppx -rf ibmrac.os390.nl2.pax

安裝好 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。

在 z/OS (OS/390) 上啟動和停止 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

以 root 使用者身分登入，開啟 /usr/lpp/IBM/AgentController/bin 目錄，發出下列指令來啟動伺服器：
```
./RAStart.sh
```
如果要停止伺服器，請以 root 使用者身分登入，開啟 /usr/lpp/IBM/AgentController/bin 目錄，發出下列指令：
```
./RAStop.sh
```

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

如果您在安裝 Agent Controller 時執行了 createLinks.sh，請移至 /usr/lpp/IBM/AgentController/bin 目錄，發出下列指令：
```
./removeLinks.sh
```
發出下列指令來移除 IBMRAC 目錄及其所有子目錄：
```
rm -rf /usr/lpp/IBM/AgentController
```

使用 Agent Controller 安全特性

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

鑑別由作業系統提供。只有安裝時指定的使用者可以鑑別。如果提供使用者名稱 ANY，任何有效的使用者名稱和密碼配對都會轉遞給作業系統進行鑑別，否則，只會轉遞列出的配對。
當啟用安全時，您在安裝時指定的使用者必須接受作業系統的鑑別，之後，才能與 Agent Controller 交換任何資訊。工作台使用者必須提供有效的使用者名稱和密碼組合，那是一個作業系統使用者名稱和密碼。
（只適用於 Windows）不鑑別網域名稱密碼。您必須提供本端使用者名稱和密碼配對。
沒有提供任何金鑰管理功能。Agent Controller 的安全使用 Java 金鑰儲存庫。
在 Windows 上，預設的金鑰儲存庫和匯出的憑證位於 Agent Controller 目錄 <rac_install_dir>\security 中，在 Linux 上，則位於 <rac_install_dir>/security 中。其中，<rac_install_dir> 是 Agent Controller 的安裝目錄。這些只是舉例。您應該將這些改成包含有意義的憑證的金鑰儲存庫。

使用 Agent Controller 安全特性

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

鑑別由作業系統提供。只有安裝時指定的使用者可以鑑別。如果提供使用者名稱 ANY，任何有效的使用者名稱和密碼配對都會轉遞給作業系統進行鑑別，否則，只會轉遞列出的配對。
當啟用安全時，您在安裝時指定的使用者必須接受作業系統的鑑別，之後，才能與 Agent Controller 交換任何資訊。工作台使用者必須提供有效的使用者名稱和密碼組合，那是一個作業系統使用者名稱和密碼。
（只適用於 Windows）不鑑別網域名稱密碼。您必須提供本端使用者名稱和密碼配對。
沒有提供任何金鑰管理功能。Agent Controller 的安全使用 Java 金鑰儲存庫。
在 Windows 上，預設的金鑰儲存庫和匯出的憑證位於 Agent Controller 目錄 <rac_install_dir>\security 中，在 Linux 上，則位於 <rac_install_dir>/security 中。其中，<rac_install_dir> 是 Agent Controller 的安裝目錄。這些只是舉例。您應該將這些改成包含有意義的憑證的金鑰儲存庫。

工作台/Agent Controller 相容性摘要

舊版相容性（使用舊版工作台和 6.0.1 版 Agent Controller）：是的，彼此相容，新的 Agent Controller 支援舊版的所有特性（例如，控制通道的「安全」）。但您無法使用新的特性，包括多工（透過控制通道傳回資料來確保安全性）。

新版相容性（使用 6.0.1 工作台和舊版 Agent Controller）：不允許，通常不支援。

Agent Controller 之間跨版本的相容性：有些產品或工具（例如 IBM Performance Optimization Toolkit）在多個主機上（除工作台外）需要以 Agent Controller 來彼此「探索」和通訊。各版本對這項功能的變更都表示如果要使用這個功能，則所有牽涉的主機必須全部使用 Agent Controller 6.0.0.1 版，不然就全部使用 Agent Controller 6.0.1 版。亦即，在 Agent Controller 實例之間使用動態探索時，不能混搭版本。

已知的問題和限制

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

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

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 的物件檔。如果要確保這些物件檔是可修改的，請執行下列動作：

關閉 Eclipse 工作台。
終止所有含 Java 側寫代理程式或 J2EE 要求側寫程式的 java.exe 程序。

安裝 ClearCase LT

Rational ClearCase LT 是一個適合小型專案小組的配置管理工具。ClearCase LT 為 IBM Rational ClearCase 系列產品的一部分，從小型專案工作群到分散的全球性企業皆可使用。

安裝媒體包含 Rational ClearCase LT 7.0.0.0 版。與 Rational Application Developer 分開安裝。

如果工作站已安裝 ClearCase LT，則可升級至最新版本。如需從舊版升級的相關資訊，請參閱 ClearCase LT 的安裝文件。

若要讓 Rational Application Developer 和 ClearCase LT 一起使用，請必須安裝 Rational ClearCase SCM 配接器特性。根據預設值，安裝 Rational Application Developer 時會選取這項特性；但如果未選取，稍後仍可利用 IBM Installation Manager 的「修改套件」精靈來安裝。如需詳細資料，請參閱修改安裝。

Rational ClearCase SCM 配接器必須啟用之後才能使用。如需啟用和使用配接器的詳細資料，請參閱線上說明。

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

如需 Rational ClearCase LT 的完整安裝指示，請參閱 ClearCase LT 安裝媒體提供的安裝文件。在安裝產品之前，強烈建議您先閱讀 ClearCase LT 版本注意事項。

有些文件是 Acrobat PDF 檔案。需要 Adobe Reader 軟體才能開啟這些檔案，您可以從 http://www.adobe.com/products/acrobat/readstep2.html 下載這套軟體。

Windows 從 ClearCase LT 安裝啟動程式中可以檢視安裝指示和版本注意事項。請參閱開始安裝 Rational ClearCase LT。

若要開啟安裝指示：
1. 從第一片 ClearCase LT 安裝 CD 中（或電子映像檔的磁碟目錄），開啟 doc\books\install.pdf。這時會開啟 IBM Rational ClearCase, ClearCase MultiSite^(R), and ClearCase LT Installation and Upgrade Guide, Version 7.0 (Windows)。
2. 請至 http://www-1.ibm.com/support/docview.wss?uid=pub1gi11636，依指示下載 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT Installation Guide, 7.0, Linux and UNIX。
這時會開啟 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT Installation and Upgrade Guide, Version 7.0 (Linux)。

從 IBM 出版品中心取得文件

您也可以從 IBM 出版品中心下載 Rational ClearCase LT 的安裝指示和版本注意事項。

請至 http:http://www.ibm.com/shop/publications/order。
在出版品中心的歡迎使用頁面上選取您的國家/地區。
按一下「搜尋出版品」。

在適當的搜尋欄位中，輸入文件標題或出版品號碼。

若要依標題來搜尋文件，請在「搜尋」欄位中輸入標題。
若要依出版品（資料 ID）號碼來搜尋文件，請在「出版品號碼」欄位中輸入號碼。

表 1. ClearCase 出版品號碼
文件	出版品號碼
IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT Installation and Upgrade Guide (Windows)	GI11-6365-00
IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT Installation and Upgrade Guide (UNIX)	GI11-6366-00
IBM Rational ClearCase LT Release Notes	GI11-6369-00

開始安裝 Rational ClearCase LT

本節的安裝指示協助您啟動 Rational ClearCase LT 的安裝程序。安裝產品時，請務必參考 Rational ClearCase LT 安裝手冊中的完整安裝指示。在安裝之前，請您一定要先閱讀版本注意事項。

在 Windows 上開始安裝 Rational ClearCase LT

使用下列其中一個方法來啟動 Rational ClearCase LT 啟動程式：
- 從 Rational Application Developer 啟動程式中（請參閱執行啟動程式），按一下 Rational ClearCase LT。
- 插入 Rational ClearCase LT 的第一片 CD。這時應該會自動執行啟動程式。如果未執行，請從第一片 Cd 或磁碟映像檔的根目錄中執行 setup.exe。
閱讀版本資訊（如果尚未閱讀）。
按一下安裝 IBM Rational ClearCase LT。這時會開啟 Rational ClearCase LT 安裝精靈。

遵循「安裝精靈」的指示來完成安裝。

在 Linux 上安裝 Rational ClearCase LT

如需在 Linux 工作站上安裝 Rational ClearCase LT 7.0 版的完整指示，請參閱 IBM Rational ClearCase、ClearCase MultiSite 和 ClearCase LT 安裝手冊 7.0（Linux 和 UNIX 版），本手冊可從 http://www-1.ibm.com/support/docview.wss?uid=pub1gi11636 下載。

配置 Rational ClearCase LT 授權

如果同一台電腦上已安裝 Rational Application Developer 和 Rational ClearCase LT，則不必再配置 Rational ClearCase LT 授權。不過，如果只安裝 Rational ClearCase LT 而未安裝 Rational Application Developer，則必須配置 ClearCase LT 授權。

如需授權配置的詳細資料，請參閱 ClearCase LT 安裝手冊

安裝 Crystal Reports Server XI Release 2

Crystal Reports Server XI Release 2 是一種共通架構，用來進行資料存取、報告和資訊遞送。它的設計是為了與現有的資料、Web 和應用程式投資相整合。Crystal Reports Server XI Release 2 以 Crystal Reports 為基礎，為一個調整資訊來配合數千使用者的有效解決方案。

Crystal Reports Server XI Release 2 是一個集中式平台，藉由 Web 或整合到企業內部網路、企業外部網路、網際網路和公司入口網站應用程式中，來管理和安全分送複雜的互動式報告，此外，它適用於 Windows 和 Linux。

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

在 Windows 上安裝 Crystal Reports Server XI Release 2

當您執行這項預設安裝時，會將所有的用戶端與伺服器元件安裝在您的工作站上。會自動為「集中管理伺服器 (CMS)」建立一個 MySQL 資料庫。會建立預設使用者和群組帳戶，並將範例報告發佈至您的系統上。當安裝完成時，伺服器元件會在您的工作站上以服務方式啟動。

若要在 Windows 上安裝 Crystal Reports Server XI Release 2 的所有元件，請執行下列動作：

從 Rational Application Developer 安裝啟動程式，按一下安裝 Crystal Reports Server XI Release 2。如果您是從 CD ROM 安裝，則會提示您將第一片 Crystal Reports Server XI Release 2 for Windows 安裝光碟插入光碟機中。
從 Rational Application Developer 安裝啟動程式，按一下安裝 Crystal Reports Server XI Release 2。
在安裝精靈中，選取一種安裝語言，並按一下確定。這是安裝程序所用的語言，而非將要安裝的語言。
在歡迎使用頁面上，按一下確定。
閱讀授權合約頁面中的授權合約，如果您接受條款，請按一下我接受授權合約，並按下一步。
在選取用戶端或伺服器安裝頁面上，按一下執行伺服器安裝。
註:

這個選項會安裝所有必要的 Crystal Reports Server 元件。執行用戶端安裝選項只會將用戶端工具安裝至您可用來遠端管理 Crystal Reports Server 環境的機器上。
遵循安裝精靈中的指示進行，並在目錄選擇頁面上，接受預設位置 (C:\Program Files\Business Objects\BusinessObjects Enterprise 11.5)，然後按下一步，繼續進行步驟 9。
如果您選擇安裝在預設位置以外的磁碟機上，安裝精靈會要求您選取一個磁碟機，以便安裝 Crystal Reports 等 Business Objects 產品也會使用的共用檔案。若要將數個 Business Objects 產品安裝在相同機器上，但不將檔案安裝在預設系統磁碟機上，請先安裝 Crystal Reports Server。之後當您安裝 Crystal Reports 時，它會使用 Crystal Reports Server 所建的共通檔案目錄。
在安裝類型頁面上，按一下新建，並完成下列步驟：
- 如果您想將 MySQL 資料庫安裝成 CMS 資料庫，請按一下安裝 MySQL 資料庫伺服器，然後按下一步，繼續進行步驟 10。這是建議的安裝方式。
- 如果您想使用另一種資料庫來作為 CMS 資料庫（如 Oracle 或 Sybase），請按一下使用現有的資料庫伺服器，並按下一步。
如需如何使用現有資料庫伺服器的相關資訊和指示，請參閱 BusinessObjects Enterprise 安裝手冊。這項資訊可在「在 Windows 上安裝 BusinessObjects Enterprise」一章中的「新建安裝」一節下找到。
如果您已選擇將 MySQL 資料庫安裝成 CMS 資料庫，請完成下列步驟：
1. 輸入埠號。
2. 輸入將供 MySQL root 使用者帳戶使用的密碼，並加以確認。
3. 接受預設使用者名稱來存取 CMS 資料庫，或輸入新使用者名稱以置換預設名稱。
4. 輸入將用來存取 CMS 資料庫的密碼，並加以確認。
5. 按下一步
在選擇 Web 元件配接器類型頁面上，完成下列步驟之一：
- 如果您只想使用 Java Web 元件配接器，並使用您自己的 Java 應用程式伺服器，請按一下 Java 應用程式伺服器，按一下使用預先安裝的 Java 應用程式伺服器，清除 IIS ASP.NET 勾選框，並按下一步；然後繼續進行步驟 13。
- 如果您只想使用 Java Web 元件配接器，並安裝 Tomcat，請按一下 Java 應用程式伺服器，按一下安裝 Tomcat 應用程式伺服器，清除 IIS ASP.NET 勾選框，並按下一步；然後繼續進行步驟 12。
- 如果您只想使用 IIS ASP.NET Web 元件配接器，請清除 Java 應用程式伺服器勾選框，選取 IIS ASP.NET 勾選框，並從選擇網站清單中，接受預設值或選取要部署 WAR 檔的網站，並按下一步；然後繼續進行步驟 13。
- 如果您想同時使用 Java 和 IIS ASP.NET Web 元件配接器，請同時選取 Java 應用程式伺服器和 IIS ASP.NET，並從選擇網站清單中，接受預設值或選取要部署 WAR 檔的網站，按一下使用預先安裝的 Java 應用程式伺服器或安裝 Tomcat 應用程式伺服器，並按下一步；然後繼續進行步驟 12 或步驟 13。
如果您已選擇安裝 Tomcat 應用程式伺服器，請接受預設值或變更預設安裝位置，並配置「連線」埠、「關機」埠和「重新導向」埠，然後按下一步。
註:

如果您將 Crystal Reports Server 安裝在和 BusinessObjects Enterprise 6.x 部署相同的機器上，請勿使用埠 8080，因為可能已有其他部署使用該埠。
在開始安裝頁面上，按下一步。此時會開始安裝。在安裝程序期間，可能會提示您重新開機，並登錄您的產品。
在安裝精靈的最後一頁上，清除啟動 BusinessObjects 管理主控台（除非您想將自己的報告立即發佈至 Crystal Reports Server），並按一下完成。

在 Windows 上解除安裝 Crystal Reports Server XI Release 2

若要在 Windows 上解除安裝 Crystal Reports Server XI Release 2，請執行下列動作：

按一下開始 -> 設定 -> 控制台。
在控制台視窗中，按一下新增/移除程式。
在新增或移除程式視窗中，選取 Crystal Reports Server XI Release 2，並按一下移除。

在 Linux 上安裝 Crystal Reports Server XI Release 2

若要在 Linux 上安裝 Crystal Reports Server XI Release 2，請執行下列動作：

存取第一片 Crystal Reports Server XI Release 2 for Linux 安裝光碟：
- 將第一片 Crystal Reports Server XI Release 2 for Linux 安裝光碟插入光碟機中。
- 如果您是從電子映像檔安裝，請在您擷取電子映像檔的目錄中，導覽對應至第一片 Crystal Reports Server XI Release 2 for Linux 光碟的磁碟目錄。
開啟 xir2_crs_quickinstall_linux_en.pdf 檔（位於安裝光碟的 /docs/en 子目錄中）。這個檔案含有「在 Linux 上安裝 Crystal Reports Server XI Release 2」的完整指示。您必須參閱這個檔案的指示來準備系統，以及完成安裝程序。在安裝產品之前，您也應檢視 release.pdf 檔（位於安裝光碟的根目錄中）的「安裝」一節。
在繼續執行安裝 Script 之前，請先檢視 Linux 版 Crystal Reports Server 快速安裝手冊章節（PDF 檔），並執行所有必要的動作。
在安裝產品之前，停用任何防毒軟體。
遵循 PDF 檔中的「開始安裝」指示進行，以完成安裝程序。它會說明使用者的安裝程序。

在 Linux 上解除安裝 Crystal Reports Server XI Release 2

若要在 Linux 上解除安裝 Crystal Reports Server XI Release 2，請執行位於軟體之安裝目錄中的解除安裝 Script。

在原始安裝期間所安裝的所有檔案都會刪除。

注意事項

Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

本資訊係針對美國地區提供的產品和服務所開發。IBM 在其他國家不見得提供本文件所提及的各項產品、服務或功能。如需所在地目前提供之產品和服務的相關資訊，請聯絡當地 IBM 業務代表。在提及 IBM 產品、程式或服務時，不表示或暗示只能使用該 IBM 產品、程式或服務。任何功能相當之產品、程式或服務皆可替用，唯不得侵犯任何 IBM 智慧財產權。但使用者必須自行負責評估和驗證任何非 IBM 產品、程式或服務的操作。

對於本文描述的主題，IBM 可能擁有專利或申請中的專利。提供本文並不授予您使用這些專利的權利。您可以將授權查詢以書面寄到：

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

關於雙位元組 (DBCS) 資訊的授權查詢，請聯絡當地 IBM 智慧財產權部門，或將書面查詢寄到：

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

下列段落不適用於英國或該等條款牴觸當地法律的其他任何國家：International Business Machines Corporation 以「現狀」提供本出版品，不附帶任何明示或暗示的保證，包括（但不限於）未涉侵權、可售性或特定用途之適用性的隱含保證。有些國家禁止在某些交易中拋棄明示或暗示的保證，因此，這項聲明不見得適用於您。

本資訊可能含有技術面錯誤或排版錯誤。因此會定期變更本資訊，這些變更將納入新版的出版品中。IBM 可能隨時改進及/或變更本出版品描述的產品及/或程式，但不另行通知。

本資訊對於非 IBM 網站的引述只是基於方便，絕非為這些網站提供任何背書。這些網站的資料並非本 IBM 產品的一部分，使用這些網站時須自行承擔風險。

本程式的使用者如需取得下列用途的相關資訊： (i) 在獨立建立的程式和其他程式（包括本程式）之間交換資訊 ii) 互用已交換的資訊，請聯絡：

Intellectual Property Dept. for Rational Software
IBM Corporation
3600 Steeles Avenue East
Markham, Ontario
Canada L3R 9Z7

該等資訊有其適當的供應條款，在某些情況下需要付費。

IBM 根據 IBM 客戶合約、IBM 國際程式授權合約或雙方之間的任何同等合約之條款，提供本文描述的授權程式及所有適用的授權資料。

非 IBM 產品的相關資訊取自於這些產品的供應商、發佈聲明或其他公開管道。 IBM 尚未測試這些產品，無法確認非 IBM 產品的效能準確性、相容性或其他任何主張。關於非 IBM 產品的功能問題，請向這些產品的供應商查詢。

商標和服務標記

下列術語是 International Business Machines Corporation 在美國及（或）其他國家的商標：

AIX
ClearCase
developerWorks^(R)
IBM
ibm.com
iSeries
MultiSite
MVS^(TM)
OS/390
OS/400
Passport Advantage
POWER5
PowerPC
pSeries
Rational
RS/6000
WebSphere
z/OS
zSeries

Intel、Itanium 和 Pentium 是 Intel Corporation 或其子公司在美國與其他國家或地區的商標或註冊商標。

Java 及所有以 Java 為基礎的商標，是 Sun Microsystems, Inc. 在美國及/或其他國家或地區的商標。

Linux 是 Linus Torvalds 在美國及/或其他國家/地區的商標。

Microsoft 和 Windows 是 Microsoft Corporation 在美國及/或其他國家的商標。

UNIX 是 Open Group 在美國與其他國家或地區的註冊商標。

其他公司、產品或服務名稱可能是其他公司的商標或服務標記。