Configurar conectores personalizados implementados no Controlador de Agentes

Os conectores personalizados podem ser implementados no Controlador de Agentes e podem ser executados em sistemas centrais remotos. Os conectores são instalados no directório de instalação plugin do Controlador de Agentes. Cada conector terá o seu próprio ficheiro pluginconfig.xml que especifica a ambiente de execução e as definições de ambiente da aplicação nos quais deverá ser executado o conector.

Configurar o ambiente de execução

O ambiente de execução para plug-ins personalizados deve conter uma definição de caminho de classe personalizada. Isto irá assegurar que apenas são executados os ficheiros jar necessários para o conector personalizado. Para personalizar o ambiente de execução:

  1. Localizar o ficheiro de configuração pluginconfig.xml para o conector personalizado. Normalmente, encontra-se no directório de instalação do Controlador de Agentes, sob /plugin/<conector_personalizado>/ onde conector_personalizado é o nome do directório do conector.
  2. Abrir o ficheiro no editor e procurar o elemento <AgentControllerEnvironment>. Se este elemento não existir, criar o elemento.
  3. Adicionar o sub-elemento <Variable>. Especificar o valor do atributo name no formato CLASSPATH_<org>_<myapp> onde org_myapp é o nome do directório do conector com o ponto '.' substituído por traço de sublinhado '_'. Especificar o valor do atributo position como 'append'. Especificar o atributo value como o ficheiro jar no directório do conector personalizado. A seguir encontra-se um exemplo do elemento <AgentControllerEnvironment> personalizado:
    <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. Guardar as alterações.
  5. Reiniciar o Controlador de Agentes.

    Nota: Pode ser adicionado qualquer número de elementos <Variable> ao ambiente.   As regras são processadas segundo o critério de processar primeiro o primeiro a chegar.

Configurar o ambiente da aplicação

O ambiente da aplicação para um conector é definido dentro do elemento <Application> no ficheiro pluginconfig.xml. Estas definições neste elemento são visíveis apenas para a aplicação. Pode também configurar a aplicação para utilizar ficheiros jar de outras aplicações implementadas no Controlador de Agentes utilizando o elemento <Application>. Para configurar o ambiente da aplicação:

  1. Localizar o ficheiro de configuração pluginconfig.xml para o conector personalizado. Normalmente, encontra-se no directório de instalação do Controlador de Agentes, sob /plugin/<conector_personalizado>/ onde conector_personalizado é o nome do directório do conector.
  2. Abrir o ficheiro no editor e procurar o elemento <Application>. Este elemento deverá estar definido do seguinte modo:
      <Application configuration="default" executable="myapp2" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%">
        </Application>
    
    onde
  3. Para configurar a aplicação para utilizar ficheiros jar de outras aplicações, adicionar o sub-elemento Variable. Especificar o valor do atributo name como CLASSPATH. Especificar o valor do atributo position como o ambiente de execução. Especificar o atributo value como o directório do conector da outra aplicação que pretende utilizar. A seguir encontra-se um exemplo de um pluginconfig.xml para myapp2 que utiliza ficheiros jar de outro ambiente de execução chamado 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. Guardar as alterações.
  5. Reiniciar o Controlador de Agentes.

Tarefas relacionadas
Localizar os ficheiros de configuração
Administrar o Controlador de Agentes
 


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