配置部署在代理控制器上的定制插件

定制插件可以部署在代理控制器上以及在远程主机上运行。 这些插件安装在代理控制器安装目录的 plugin 目录中。 每个插件均具有自己的 pluginconfig.xml,它指定了插件运行时应采用的执行环境设置和应用程序环境设置。

配置执行环境

定制插件的执行环境应包含定制类路径定义。这将确保仅运行定制插件所需的 jar 文件。要定制执行环境:

  1. 找到定制插件的 pluginconfig.xml 配置文件。此文件通常位于代理控制器安装目录的 /plugin/<custom_plugin>/ 中,其中 custom_plugin 是插件目录的名称。
  2. 在编辑器中打开它,并搜索 <AgentControllerEnvironment> 元素。如果此元素不存在,则创建该元素。
  3. 添加子元素 <Variable>。采用格式 CLASSPATH_<org>_<myapp> 来指定 name 属性的值,其中 org_myapp 是插件目录名称,且点“.”被替换为下划线“_”。将值 position 属性指定为“append”。 将 value 属性指定为定制插件目录中的 jar 文件。以下是定制的 <AgentControllerEnvironment> 元素的示例:
    <AgentControllerEnvironment configuration="default">
      <Variable name="CLASSPATH_ORG_MYAPP" position="append" value="%PLUGINS_HOME%/org.myapp/one.jar"/>
      <Variable name="CLASSPATH_ORG_MYAPP" position="append" value="%PLUGINS_HOME%/org.myapp/two.jar"/>
      <Variable name="CLASSPATH_ORG_MYAPP" position="append" value="%PLUGINS_HOME%/org.myapp/three.jar"/>
    	</AgentControllerEnvironment>
    
  4. 保存更改。
  5. 然后,重新启动代理控制器。

    注意:可以将任意数目的 <Variable> 元素添加到环境中。将以先到先服务方式处理这些规则。 

配置应用程序环境

插件的应用程序环境在 pluginconfig.xml 文件的 <Application> 元素中定义。此元素中的这些设置仅对应用程序是可视的。您还可以使用 <Application> 元素来配置应用程序,以便从部署在代理控制器上的其他应用程序使用 jar 文件。 要配置应用程序环境:

  1. 找到定制插件的 pluginconfig.xml 配置文件。此文件通常位于代理控制器安装目录的 /plugin/<custom_plugin>/ 中,其中 custom_plugin 是插件目录的名称。
  2. 在编辑器中打开该文件,然后搜索 <Application> 元素。您应该如下所示定义该元素:
      <Application configuration="default" executable="myapp2" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%">
        </Application>
    
    其中,
  3. 要配置应用程序以从其他应用程序使用 jar 文件,请添加子元素 Variable。将 name 属性的值指定为 CLASSPATH。将值 position 属性指定为执行环境 将 value 属性指定为要使用的其他应用程序的插件目录。以下是用于 myapp2 的 pluginconfig.xml 的示例,myapp2 从另一个名为 org.myapp 的执行环境使用 jar 文件。
    <?xml version="1.0" encoding="UTF-8"?>
    <PluginConfiguration>
      <Application configuration="default" executable="myapp2" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%">
        <Variable name="CLASSPATH" position="append" value="%CLASSPATH_ORG_MYAPP%"/>
        </Application>
      <Option name="my.proj2" type="version" value="1.0.0"/>
    </PluginConfiguration>
    
  4. 保存更改。
  5. 然后,重新启动代理控制器。

相关任务
查找配置文件
管理代理控制器
 


(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.