如果您已在「代理程式編輯器」的 Runtime Configuration 視窗中新增了任何自訂配置內容,如果代理程式支援多個實例,或者如果代理程式使用任何需要配置(例如,使用者 ID 和密碼)的預先定義資料來源,則您必須先配置代理程式,然後它才能啟動。
開始之前
在 Windows 系統上,使用管理者指令行 Shell
來安裝並配置代理程式。 要啟動管理者 Shell,請從 Windows 的「程式」功能表中選取命令提示字元,按一下滑鼠右鍵,然後按一下以系統管理員身分執行。
關於這項作業
在配置處理程序中,您可以:
- 如果代理程式支援多個實例,請設定實例名稱來建立或變更實例。
- 設定任何可用於代理程式的配置內容。
- 如果代理程式支援子節點,請建立並配置子節點。
在 Windows 系統上,若要設定任何配置內容或建立任何子節點,您必須使用無聲自動配置程序。 在 install_dir\samples 目錄中提供了無聲自動配置回應檔範例,其名稱為 agentname_silent_config.txt。 如有必要,請建立此檔案的副本並設定配置變數。
在 Linux 和 UNIX 系統上,您可以選擇性地使用無聲自動配置程序。 或者,您可以使用互動式程序。 如果您在未指定回應檔名的情況下啟動配置指令,則配置公用程式會提示您輸入配置值。
程序
-
切換至 install_dir/bin 目錄。
- 執行下列指令,以配置代理程式:
- 如果該代理程式不支援多個實例:
在 Windows 系統上:name-agent.bat
config [response_file]
在 Linux 和 UNIX 系統上:./name-agent.sh
config [response_file]
- 如果代理程式支援多個實例:
在 Windows 系統上:name-agent.bat
config instance_name [response_file]
在 Linux 和 UNIX 系統上:./name-agent.sh
config instance_name [response_file]
其中:
- instance_name 是實例名稱。
如果不存在具有此名稱的實例,則會建立該實例。
如果該實例已存在,則會重新配置該實例。 您必須至少建立一個實例才能使用代理程式。
- response_file 是無聲自動配置回應檔的名稱。
提示: 如果您的代理程式使用 JMX 資料來源連接至遠端 WebSphere Application Server,請確保執行代理程式的主機上也已安裝 WebSphere Application Server,並將 Java home 設定設為本端 WebSphere Application Server 使用的 Java 執行時期環境。
提示: 對於 Java API、JDBC、JMX、HTTP 或 SOAP 資料來源,您可以使用
設定來控制代理程式追蹤記載。 在此設定中設定下列值:
-DJAVA_TRACE_MAX_FILES=files -DJAVA_TRACE_MAX_FILE_SIZE=size
其中,
files 是保留的追蹤日誌檔數目上限(預設值為 4),
size 是日誌檔大小上限 (KB)(預設值為 5000)。 例如,您可以設定下列值:
-DJAVA_TRACE_MAX_FILES=7 -DJAVA_TRACE_MAX_FILE_SIZE=100
在此情況下,代理程式將 100 KB 寫入第一個日誌檔,然後切換至第二個日誌檔,以此類推。 在七個日誌檔中各寫入 100 KB 之後,將改寫第一個日誌檔。