Configurando Plug-ins Customizados Implementados no Agent Controller

Os plug-ins customizados podem ser implementados no Agent Controller e executados nos hosts remotos. Os plug-ins são instalados no diretório plugin do diretório de instalação do Agent Controller. Cada plug-in terá seu próprio pluginconfig.xml especificando o ambiente de execução e as configurações do ambiente do aplicativo no qual o plug-in deve ser executado.

Configurando o Ambiente de Execução

O ambiente de execução para plug-ins personalizados contém uma definição de caminho de classe personalizada. Isso garante que apenas os arquivos jar necessários para o plug-in customizado sejam executados. Para customizar o ambiente de execução:

  1. Localize o arquivo de configuração pluginconfig.xml do plug-in customizado. Normalmente, ele está localizado no diretório de instalação do Agent Controller, sob /plugin/<custom_plugin>/ em que custom_plugin é o nome do diretório do plug-in.
  2. Abra-o em um editor e procure o elemento <AgentControllerEnvironment>. Se esse elemento não existir, crie-o.
  3. Inclua o subelemento <Variable>. Especifique o valor do atributo name no formato CLASSPATH_<org>_<myapp> em que org_myapp é o nome do diretório do plug-in com o ponto '.' substituído por um sublinhado '_'. Especifique o valor do atributo position como 'append'. Especifique o atributo value como o arquivo jar no diretório do plug-in customizado. O seguinte é um exemplo do elemento <AgentControllerEnvironment> customizado:
    <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. Salve as alterações.
  5. Reinicie o Agent Controller.

    Nota: É possível adicionar qualquer número de elementos <Variable> ao ambiente.  As regras são processadas de acordo com "a que chegar primeiro é a que serve".

Configurando o Ambiente do Aplicativo

O ambiente do aplicativo de um plug-in é definido dentro do elemento <Aplicativo> no arquivo pluginconfig.xml. Essas configurações nesse elemento são visíveis apenas para o aplicativo. Você também pode configurar o aplicativo para utilizar arquivos jar de outros aplicativos implementados no Agent Controller utilizando o elemento <Aplicativo>. Para configurar o ambiente do aplicativo:

  1. Localize o arquivo de configuração pluginconfig.xml do plug-in customizado. Normalmente, ele está localizado no diretório de instalação do Agent Controller, sob /plugin/<custom_plugin>/ em que custom_plugin é o nome do diretório do plug-in.
  2. Abra-o em um editor e procure o elemento <Aplicativo>. O elemento deve ser definido da seguinte maneira:
      <Application configuration="default" executable="myapp2" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%">
       </Application>
    em que
  3. Para configurar o aplicativo para utilizar arquivos jar de outros aplicativos, inclua o subelemento Variable. Especifique o valor do atributo name como CLASSPATH. Especifique o valor do atributo position como o ambiente de execução. Especifique o atributo value como o diretório do plug-in do outro aplicativo que você deseja utilizar. O seguinte é um exemplo de um pluginconfig.xml para myapp2 que utiliza arquivos jar de outro ambiente de execução denominado org.myapp.
    <?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. Salve as alterações.
  5. Reinicie o Agent Controller.

Tarefas Relacionadas
Localizando os Arquivos de Configuração
Administrando o Agent Controller
 


(C) Direitos Autorais IBM Corporation 2000, 2006. Todos os Direitos Reservados.