Configurazione dei plugin personalizzati distribuiti su Agent Controller

I plugin personalizzati possono essere distribuiti su Agent Controller ed essere eseguiti su host remoti. I plugin vengono installati nella directory plugin, che si trova nella directory di installazione di Agent Controller. Ciascun plugin avrà un proprio file pluginconfig.xml che specifica le impostazioni dell'ambiente di esecuzione e dell'applicazione in cui eseguire il plugin.

Configurazione dell'ambiente di esecuzione

L'ambiente di esecuzione dei plugin personalizzati dovrebbe contenere una definizione di percorso classi personalizzata. In tal modo, verranno eseguiti solo i file jar necessari per il plugin personalizzato. Per personalizzare l'ambiente di esecuzione:

  1. Individuare il file di configurazione pluginconfig.xml relativo al plugin personalizzato. Di solito, questo file si trova nella directory di installazione di Agent Controller, in /plugin/<custom_plugin>/, dove custom_plugin è il nome della directory del plugin.
  2. Aprire il file in un editor e ricercare l'elemento <AgentControllerEnvironment> Se questo elemento non esiste, crearlo.
  3. Aggiungere l'elemento secondario <Variable>. Specificare il valore dell'attributo name nel formato CLASSPATH_<org>_<myapp>, dove org_myapp è il nome della directory del plugin con il punto '.' sostituito da un simbolo di sottolineatura '_'. Specificare l'attributo position del valore come 'append'. Specificare l'attributo value come file jar nella directory dei plugin personalizzati. Di seguito è riportato un esempio dell'elemento personalizzato <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. Salvare le modifiche.
  5. Riavviare Agent Controller.

    Nota: all'ambiente è possibile aggiungere un qualsiasi numero di <variabili>.  Le regole verranno elaborate in base all'ordine di ricezione.

Configurazione dell'ambiente dell'applicazione

L'ambiente dell'applicazione per un plugin viene definito nell'elemento <Application> nel file pluginconfig.xml. Queste impostazioni sono visibili solo all'applicazione. È anche possibile configurare l'applicazione perché utilizzi file jar di altre applicazioni distribuite su Agent Controller utilizzando l'elemento <Application>. Per configurare l'ambiente dell'applicazione:

  1. Individuare il file di configurazione pluginconfig.xml relativo al plugin personalizzato. Di solito, questo file si trova nella directory di installazione di Agent Controller, in /plugin/<custom_plugin>/, dove custom_plugin è il nome della directory del plugin.
  2. Aprire il file in un editor e ricercare l'elemento <Application>. L'elemento dovrebbe avere la seguente definizione:
    <Application configuration="default" executable="myapp2" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%">
    </Application>
    
    dove
  3. Per configurare l'applicazione perché utilizzi file jar di altre applicazioni, aggiungere l'elemento secondario Variable. Specificare il valore dell'attributo name come CLASSPATH. Specificare l'attributo position del valore come ambiente di esecuzione. Specificare l'attributo value come directory dei plugin dell'altra applicazione che si desidera utilizzare. Di seguito viene riportato un esempio di pluginconfig.xml per myapp2 che utilizza file jar di un altro ambiente di esecuzione chiamato 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. Salvare le modifiche.
  5. Riavviare Agent Controller.

Attività correlate
Individuazione dei file di configurazione
Gestione di Agent Controller
 


(C) Copyright IBM Corporation 2000, 2006. Tutti i diritti riservati.