用於 Rational Application Developer 6.0.1 版 / Rational Web Developer 6.0.1 版/ Rational Software Architect 6.0.1 版/ Rational Performance Tester 6.1.1 版
(c) Copyright IBM Corporation 2000, 2005. All Rights Reserved.
Agent Controller 是一個常駐程式，可讓用戶端應用程式啟動及管理本端或遠端應用程式，並提供執行應用程式的相關資訊給其他應用程式。您必須先個別安裝 Agent Controller，才能使用下列工具：
附註：
使用下列指令：
在所有其他狀況下，您必須先使用以下提供的指示解除安裝舊版的 Agent Controller， 再安裝 Agent Controller 6.0.1 版。
請參閱以下指示以取得無聲自動安裝 Agent Controller 的詳細資訊。
Linux 附註：Agent Controller 的 Hyades Data Collection Engine 特性是利用 libstdc++-libc6.2-2.so.3 共用程式庫來編譯的。 請確定這個共用程式庫存在 /usr/lib 目錄下。如果不存在，您必須安裝作業系統安裝媒體所附的 RPM 套件 compat-libstdc++。
OS/400 注意事項：Agent Controller for OS/400 (iSeries) 需要安裝 IBM XML Toolkit for iSeries (5733-XT1)。請洽詢 iSeries 供應商以取得一份 IBM XML Toolkit for iSeries。
z/OS 注意事項：Agent Controller for z/OS (zSeries) 需要安裝 XML C++ Parser 1.4 for z/OS， 可於 www.ibm.com/servers/eserver/zseries/software/xml/download/cparser_download.html 取得。
Agent Controller 已通過下列平台的測試：
Agent Controller 尚未在下列平台上測試，但應該可以在這些平台上執行：
一般而言，Agent Controller 可以搭配使用 JVM 1.4 版或更新的版本。 以下是 Agent Controller 已通過測試的 JVM 版本（Java 完整版本）：
您解壓縮到暫時目錄的 Agent Controller 安裝檔會位於下列目錄中：
如果您安裝了 6.0 版 Rational 軟體開發產品所提供的 Agent Controller 或 6.0.0.1 版 Agent Controller， 它會在您安裝 6.0.1 版 Agent Controller 時自動解除安裝。在所有其他狀況下，您必須先解除安裝舊版的 Agent Controller 或衍生自 Hyades Data Collection Engine 的任何軟體， 才能安裝 Agent Controller 6.0.1 版。
您可以無聲自動安裝 6.0.1 版 Agent Controller，而不需要先使用參數 -P hyadesdc_product.patch=True 來解除安裝 6.0 版或 6.0.0.1 版Agent Controller。利用這個方法，您之前的安裝配置會加以移轉；所有之前的安裝參數也會予以保留。使用下列指令：
請參閱以下指示以取得無聲自動安裝 Agent Controller 的詳細資訊。
如果您有舊版的 Agent Controller 或從 Hyades Data Collection Engine 衍生而來的任何軟體，請先將它停止、解除安裝，以及清除遺留的檔案，之後再安裝這個版本的 Agent Controller。 解除安裝之後可能遺留下列檔案：
Windows：
%RASERVER_HOME%\*.*（Agent Controller 的安裝目錄） %SystemRoot%\system32\piAgent.dll（Windows 的 system32 目錄） %SystemRoot%\system32\LogAgent.dll %SystemRoot%\system32\hcbnd.dll %SystemRoot%\system32\hcclco.dll %SystemRoot%\system32\hccldt.dll %SystemRoot%\system32\hccls.dll %SystemRoot%\system32\hcclserc.dll %SystemRoot%\system32\hcclsert.dll %SystemRoot%\system32\hcclsm.dll %SystemRoot%\system32\hcjbnd.dll %SystemRoot%\system32\hclaunch.dll %SystemRoot%\system32\hcthread.dll %SystemRoot%\system32\piAgent.dll %SystemRoot%\system32\rac.dll %SystemRoot%\system32\sysperf.dllLinux、AIX、HP-UX、Solaris：
$RASERVER_HOME/*（Agent Controller 的安裝目錄） /usr/lib/libpiAgent.so（HP-UX 上的副檔名為 .sl） /usr/lib/libLogAgent.so /usr/lib/libhcbnd.so /usr/lib/libhcclco.so /usr/lib/libhccldt.so /usr/lib/libhccls.so /usr/lib/libhcclserc.so /usr/lib/libhcclsert.so /usr/lib/libhcclsm.so /usr/lib/libhcjbnd.so /usr/lib/libhclaunch.so /usr/lib/libhcthread.so
按下一步以繼續。
按下一步以繼續。
如果選取了「啟用」，請按下一步，並在安全之下輸入可連接 Agent Controller 的使用者清單（以逗點區隔）。這些使用者必須經過鑑別，才能使用這項工具。
按下一步以繼續。
您可以在安裝指令中使用下列參數來無聲執行安裝程序：
| 參數 | 說明 |
|---|---|
| 必要參數 | |
-silent | 指示安裝程式以無聲自動方式執行 |
-P installLocation | 指定安裝路徑 |
-W javaHome_win.path | (Windows) 指定 java.exe 執行檔的完整路徑 |
-W javaHome_unix.path | （非 Windows）指定 java 執行檔的完整路徑 |
-W hostList.type | 指定用戶端可以如何連接 Agent Controller（ALL、LOCAL、CUSTOM）
|
-W securityCustom.type | （於 hostList.type="CUSTOM" 時使用）指定是否應該開啟安全 (true、false)
|
-W securityLocal.type | （於 hostList.type="LOCAL" 時使用）指定是否應該開啟安全 (true、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 hostListCustom.hosts | 指定用戶端主機名稱，以逗點分隔（如果 hostList.type="CUSTOM"） |
-W securityAllList.users | （於 hostList.type="ALL" 時使用）指定哪些使用者可以連接 Agent Controller |
-W securityCustomList.users | （於 hostList.type="CUSTOM" 時使用）指定哪些使用者可以連接 Agent Controller（如果 securityCustom.type = "true"） |
-W securityLocalList.users | （於 if hostList.type="LOCAL" 時使用）指定哪些使用者可以連接 Agent Controller（如果 securityLocal.type = "true"） |
-P hyadesdc_ibm_runtimeAnalysis_feature.active=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 hostListCustom.hosts="host1,host2" -W securityCustom.type="true" -W securityCustomList.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.0/AppServer" -W hostList.type="CUSTOM" -W hostListCustom.hosts="host1,host2" -W securityCustom.type="true" -W securityCustomList.users="user1,user2"
使用回應檔
您可以建立回應檔（如 setup.rsp）來儲存上述所有參數，而不必在指令行中指定它們：
# Start of response file -P installLocation="D:\IBM\AgentController" -W javaHome_win.path="D:\ibm-sdk-n142p\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 hostListCustom.hosts="host1,host2" -W securityCustom.type="true" -W securityCustomList.users="user1,user2" # End of response file
# Start of response file -P installLocation="D:\IBM\AgentController" -W javaHome_win.path="D:\ibm-sdk-n142p\jre\bin\java.exe" -W wasHome_win.was510path="D:\WebSphere5.1\AppServer" -W wasHome_win.was500path="D:\WebSphere5.0\AppServer" -W hostList.type="LOCAL" -W securityLocal.type="true『 -W securityLocalList.users="user1,user2" # End of response file
# Start of response file -P installLocation="D:\IBM\AgentController" -W javaHome_win.path="D:\ibm-sdk-n142p\jre\bin\java.exe" -W wasHome_win.was510path="D:\WebSphere5.1\AppServer" -W wasHome_win.was500path="D:\WebSphere5.0\AppServer" -W hostList.type="ALL" -W securityAllList.users="user1,user2" # End of response file
如果要利用回應檔進行安裝，請執行下列動作：
Windows：setup.exe -silent -options d:\temp\setup.rsp
非 Windows：setup.bin -silent -options /tmp/setup.rsp
PATH=/usr/sbin:$PATH export PATH
| 平台 | 程式庫路徑設定 |
|---|---|
| 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 |
./RAStart.sh
./RAStop.sh
Agent Controller 6.0.1 版無法在單一工作站上安裝多個產品實例。當您執行另一個安裝時（不管是使用獨立式安裝或作為產品內的內嵌安裝），Agent Controller 會針對起始新安裝作業的產品名稱記錄一個參照。
如果 Agent Controller 已安裝多次 - 換句話說，有多個參照數（不管是使用獨立式安裝或作為產品內的內嵌安裝）， 它只會在最後一個參照產品解除安裝之後，才會解除安裝；因為最後一個參照產品仍然需要 Agent Controller。
如果您在另一個產品仍然需要 Agent Controller 時嘗試將它解除安裝， 解除安裝作業會繼續進行，但您會收到訊息「本產品無法解除安裝，因為另一個產品需要它。」
如果您有舊版的 Agent Controller 或從 Hyades Data Collection Engine 衍生而來的任何軟體，請先將它停止和解除安裝，之後再安裝這個版本。
重要事項：Agent Controller for OS/400 (iSeries) 需要安裝 IBM XML Toolkit for iSeries (5733-XT1)。請洽詢 iSeries 供應商來取得一份 IBM XML Toolkit for iSeries。
CRTLIB HYADESDC CRTLIB IBMRAC
CRTSAVF HYADESDC/HYADESDC
CRTSAVF IBMRAC/IBMRAC
CRTSAVF IBMRAC/IBMRTA
RSTOBJ OBJ(*ALL) SAVLIB(HYADESDC) DEV(*SAVF) SAVF(HYADESDC/HYADESDC)
RSTOBJ OBJ(*ALL) SAVLIB(IBMRAC) DEV(*SAVF) SAVF(IBMRAC/IBMRAC)
RSTOBJ OBJ(*ALL) SAVLIB(IBMRAC) DEV(*SAVF) SAVF(IBMRAC/IBMRTA)
RST DEV('/QSYS.LIB/HYADESDC.LIB/HYADESIFS.FILE') OBJ('/opt/hyadesdc/*')
RST DEV('/QSYS.LIB/IBMRAC.LIB/IBMRACIFS.FILE') OBJ('/opt/hyadesdc/*') ALWOBJDIF(*ALL)
RST DEV('/QSYS.LIB/IBMRAC.LIB/IBMRTAIFS.FILE') OBJ('/opt/hyadesdc/*') ALWOBJDIF(*ALL)
./SetConfig.sh
ADDLIBLE HYADESDC ADDLIBLE IBMRAC
SBMJOB CMD(CALL RASERVER) JOBD(RASTART)
ENDJOB JOB(RASTART)
如果您有舊版的 Agent Controller 或從 Hyades Data Collection Engine 衍生而來的任何軟體，請先將它停止和解除安裝，之後再安裝這個版本。
重要事項： Agent Controller for z/OS (zSeries) 需要安裝 XML C++ Parser 1.4 for z/OS，其可於 www.ibm.com/servers/eserver/zseries/software/xml/download/cparser_download.html 取得。
pax -ppx -rf ibmrac.os390.pax
pax -ppx -rf ../../tptpdc.os390.pax
pax -ppx -rf ../../ibmrta.os390.pax
./createLinks.sh
extattr +p /usr/lpp/IBM/AgentController/lib/*.so
extattr +p /usr/lpp/IBM/AgentController/plugins/com.ibm.rational.pd.probekit/lib/*.so
./SetConfig.sh
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
./RAStart.sh
./RAStop.sh
./removeLinks.sh
rm -rf /usr/lpp/IBM/AgentController
下列清單包含在所有平台中使用 Agent Controller 安全特性的提示和要訣：
這一節討論關於安裝和解除安裝 Agent Controller 的已知問題和限制。除非另有說明，否則，下列資訊適用於支援使用 Agent Controller 的所有作業系統。
Agent Controller 可能無法在非 Windows 平台中啟動，且會出現下列訊息：
無法啟動 RAServer。
這個失敗通常是在 TCP/IP 埠 10002 無法使用時造成的。 依預設，Agent Controller 會利用這個埠來接聽。 可能是 Agent Controller 啟動時，系統中所執行的其他程序正在使用這個埠，也可能是 Agent Controller 剛停止， 又在埠釋出之前重新啟動。
如果 Agent Controller 無法啟動，您可以依照下列方式來啟動它：
如果您在安裝或解除安裝期間發生錯誤，這可能是因為執行中的程序已載入 Agent Controller 的物件檔。 如果要確保這些物件檔是可修改的，請執行下列動作：
如果需要產品新訊、事件、支援和其他資訊，請造訪產品首頁：
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 的產品、程式或服務，使用者必須自行負責作業的評估和驗證責任。
這份文件可能含有 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 產品的性能問題應直接洽詢該產品供應商。
有關 IBM 未來方向或意圖之一切聲明，若有變更或撤銷，恕不另行通知，且該等聲明僅表目標之意。
這份資訊含有日常商業運作所用的資料和報告範例。
為了盡可能地加以完整說明，範例中含有個人、公司、品牌及產品的名稱。
所有這些名稱全為虛構，任何與實際商場企業使用的名稱及地址類似之處，純屬巧合。
程式設計介面資訊之目的，是要協助您利用這個程式來建立應用軟體。
通用程式設計介面可讓您撰寫應用軟體，以取得本程式工具的服務。
不過，這份資訊也可能包含診斷、修正和調整資訊。提供診斷、修正和調整資訊，是要協助您進行應用軟體的除錯。
警告：請勿將這份診斷、修正和調整資訊當作程式設計介面使用，因為它隨時會改變。
下列詞彙是 International Business Machines Corporation 在美國及/或其他國家或地區的商標：
Java 和所有以 Java 為基礎的商標是 Sun Microsystems, Inc. 在美國及/或其他國家或地區的商標。
Windows 和 Windows NT 是 Microsoft(R) Corporation 在美國及/或其他國家或地區的商標。
Intel 和 Pentium 是 Intel Corporation 或其子公司在美國及/或其他國家或地區的商標或註冊商標。
UNIX 是 The Open Group 在美國和其他國家或地區的註冊商標。
Linux 是 Linus Torvalds 在美國及/或其他國家或地區的商標。