代理程式和 Agent Controller 配置概觀
附註
表示此文件中的檔案和目錄位置時,
<install-home> 是 Agent Controller 套件的解壓縮目錄。
簡介
有三個配置檔用來管理 Agent Controller 和代理程式的行為:
-
Agent Controller 在啟動時會讀取 serviceconfig.xml 配置檔來判斷應用程式和代理程式啟動的連線設定、廣域日誌記載層次及廣域設定。
試圖向特定 Agent Controller 登錄自身的代理程式也會讀取它。
執行於相同系統的每個 Agent Controller 實例都需要它自己的 serviceconfig.xml 檔,其中含有專屬的連線設定。
請參閱 serviceconfig.xml 檔,以取得這個配置檔之元素的參照資訊。
-
每個代理程式的靜態配置資訊都是在 agent.xml 檔中。
這個檔案含有 Agent Controller 必須知道的特定代理程式相關資訊。
這包括如何啟動代理程式(執行檔路徑名稱、指令行引數等)、代理程式支援哪些指令集(介面)、這個代理程式能夠有多少執行中實例的限制,以及代理程式可以同時有多少位使用者。
Agent Controller 會查看 serviceconfig.xml 檔中的 Agent 元素(通常定義為 <install-home>\agents)所指定的目錄來尋找這些配置檔。
每個代理程式都有針對它來命名的唯一目錄,agent.xml 檔在這個目錄內(如 <install-home>\agents\org.eclipse.tptp.TimeCollector\agent.xml)。
當要求代理程式時,Agent Controller 會利用 agent.xml 配置檔所指定的名稱來尋找它。
請參閱 agent.xml檔,以取得這個配置檔之元素的參照資訊。
附註
如果利用舊 Agent Controller 介面來啟動代理程式,agent.xml 的存在便沒有作用。
當使用舊介面時,用戶端必須知道它要啟動之程序的名稱,以及應用程式別名所定義的名稱。
應用程式別名必須放在 pluginconfig.xml 或 serviceconfig.xml 中。
定義在 agent.xml 中的應用程式別名會被忽略。
-
任何必須延伸 serviceconfig.xml 所定義之環境設定或應用程式別名清單的應用程式(包含代理程式)都會使用 pluginconfig.xml 檔。「外掛程式」一詞可能會造成誤導,因為雖然應用程式最初採用 Eclipe 外掛程式的形式,但並不一定要如此。
Agent Controller 會查看 serviceconfig.xml 檔中的 Plugin 元素(通常定義為 <install-home>\plugins)所指定的目錄。
每個應用程式都有針對它來命名的唯一目錄,且 pluginconfig.xml 檔必須在這個目錄的 \config 目錄內。
請參閱 pluginconfig.xml 檔,以取得這個配置檔之元素的參照資訊。
-
每個代理程式的動態配置資訊都是在 agentconfig.xml 檔中。
這個檔案是選用的。
預期它會包含代理程式在啟動期間或在執行期間的任何點上所用的配置資訊。
內容和用法由相關代理程式的建立者來定義。
agentconfig.xml 檔通常在 \config 目錄中,在針對相關代理程式而命名的目錄之下(如 <install-home>\agents\org.eclipse.tptp.TimeCollector\config\agentconfig.xml)。
這個配置目錄可以指定在 agent.xml 檔中。
依代理程式本身的實作方式而定,代理程式可能會讀取這個配置檔一次、許多次,或永不讀取。
Agent Controller 永不會讀取這個檔案。
目前這個檔案沒有建議的元素,因此,這裡也沒有提供參照範例。
相關參照
serviceconfig.xml 檔
agent.xml 檔
pluginconfig.xml 檔
Copyright (C) 2005, 2006 Intel Corporation.