代理程序和代理控制器配置概述
注意
在本文档中,当引用文件和目录位置时,<install-home> 是指代理控制器软件包的解压缩目录。
简介
有三个配置文件用来管理代理控制器和代理程序的行为:
-
代理控制器在启动期间将读取 serviceconfig.xml 配置文件,以确定连接设置、全局日志记录级别以及用于启动应用程序和代理程序的全局设置。代理程序在尝试向特定代理控制器注册它们自己时也将读取此文件。在同一系统上运行的每个代理控制器实例都需要自已的
serviceconfig.xml 文件来提供独特的连接设置。要了解有关此配置文件的元素的参考信息,请参阅
serviceconfig.xml
文件。
-
每个代理程序的静态配置信息都在 agent.xml 文件中。此文件包含代理控制器需要了解的有关特定代理程序的信息。这些信息包括如何启动该代理程序(可执行文件路径名以及命令行参数等内容)、该代理程序支持的命令集(接口)、允许同时运行的代理程序实例数以及所允许的并发代理程序用户数目。代理控制器在
serviceconfig.xml 文件中
Agent 元素指定的目录(通常定义为
<安装根目录>\agents)中查找这些配置文件。每个代理程序都有自己的唯一同名目录,并且
agent.xml 文件在该目录中(例如,<install-home>\agents\org.eclipse.tptp.TimeCollector\agent.xml)。当某个代理程序被请求时,代理控制器将使用 agent.xml 配置文件中指定的名称来查找它。请参阅
agent.xml 文件以了解有关此配置文件的元素的参考信息。
注意
如果使用了旧代理控制器接口来启动代理程序,则 agent.xml 不起作用。对于旧接口来说,客户机必须知道它要启动的进程的名称,那些名称是由应用程序别名定义的。必须在
pluginconfig.xml 或 serviceconfig.xml
中指定应用程序别名。将忽略 agent.xml 中定义的应用程序别名。
-
任何需要对 serviceconfig.xml 中定义的环境设置或应用程序别名列表进行扩展的应用程序(包括代理程序)都将使用 pluginconfig.xml 文件。虽然最初使用了“插件”这一术语,但由于应用程序不必具有 Eclipse 插件形式,所以此术语可能会令人产生误解。代理控制器将查找 serviceconfig.xml 文件中
Plugin 元素指定的目录(通常定义为
<安装根目录>\plugins)。每个应用程序都有与其同名的唯一目录,pluginconfig.xml 文件必须在该目录的
\config 子目录中。请参阅
pluginconfig.xml
文件以了解有关此配置文件的元素的参考信息。
-
每个代理程序的动态配置信息都在 agentconfig.xml 文件中。此文件是可选的。此文件预期包含代理程序在启动期间或执行期间使用的配置信息。此文件的内容和用法由相关代理程序的创建者定义。agentconfig.xml 文件通常在相关代理程序的同名目录下的
\config 目录中(例如,<install-home>\agents\org.eclipse.tptp.TimeCollector\config\agentconfig.xml)。可以在
agent.xml 文件中指定此配置目录。根据代理程序本身实现方式的不同,该代理程序可以只读取此配置文件一次、读取多次或者完全不读取。代理控制器不读取此文件。目前,此文件没有建议的元素,因此未提供参考示例。
相关参考
serviceconfig.xml 文件
agent.xml 文件
pluginconfig.xml 文件
Copyright (C) 2005, 2006 Intel Corporation.