Konfigurera anpassade insticksprogram som ska placeras ut i agentkontrollanten

Anpassade insticksprogram kan placeras ut i agentkontrollanten och köras på fjärrvärdar. Insticksprogrammen installeras i plugin i installationskatalogen för agentkontrollanten. Varje insticksprogram har en egen pluginconfig.xml som anger körningsmiljön och inställningarna för den tillämpningsmiljö där insticksprogrammet ska köras.

Konfigurera körningsmiljön

Körningsmiljön för anpassade insticksprogram ska innehålla en anpassad klassökvägsdefinition. Den säkrar att endast de jar-filer som krävs för det anpassade insticksprogrammet körs. Så här anpassar du körningsmiljön:

  1. Sök rätt på konfigurationsfilen pluginconfig.xml för det anpassade insticksprogrammet. Den finns vanligen i installationskatalogen för agentkontrollanten, i /plugin/<custom_plugin>/ där custom_plugin är namnet på katalogen för insticksprogrammet.
  2. Öppna den i en redigerare och sök elementet <AgentControllerEnvironment>. Om elementet inte finns så skapar du det.
  3. Lägg till underelementet <Variable>. Ange värdet för attributet name i formatet CLASSPATH_<org>_<myapp> där org_myapp är katalognamnet för insticksprogrammet med punkten '.' ersatt med ett understreck '_'. Ange värdet för attributet position som 'append'. Ange attributet value som jar-filen i den anpassade katalogen för insticksprogrammet. Följande är ett exempel på det anpassade elementet <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. Spara ändringarna.
  5. Starta om agentkontrollanten.

    Obs! Ett valfritt antal <Variable>-element kan läggas till i miljön.  Reglerna bearbetas i den ordning de kommer.

Konfigurera tillämpningsmiljön

Tillämpningsmiljön för ett insticksprogram definieras inom elementet <Application> i filen pluginconfig.xml. De här inställningarna i elementet är endast synliga för tillämpningen. Du kan också konfigurera tillämpningen att använda jar-filer från andra tillämpningar som placerats ut i agentkontrollanten med elementet <Application>. Så här konfigurerar du tillämpningsmiljön:

  1. Sök rätt på konfigurationsfilen pluginconfig.xml för det anpassade insticksprogrammet. Den finns vanligen i installationskatalogen för agentkontrollanten, i /plugin/<custom_plugin>/ där custom_plugin är namnet på katalogen för insticksprogrammet.
  2. Öppna den i en redigerare och sök elementet <Application>. Elementet ska vara definierat enligt följande:
    <Application configuration="default" executable="myapp2" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%">
    </Application>
    
  3. Om du vill konfigurera tillämpningen att använda jar-filer från andra tillämpningar lägger du till underelementet Variable. Ange värdet för attributet name som CLASSPATH. Ange värdet för attributet position som körningsmiljö. Ange attributet value som katalogen för insticksprogrammet för den andra tillämpningen som du vill använda. Här följer ett exempel på en pluginconfig.xml för myapp2 som använder jar-filer från en annan körningsmiljö med namnet 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. Spara ändringarna.
  5. Starta om agentkontrollanten.

Närliggande uppgifter
Söka konfigurationsfilerna
Administrera agentkontrollanten
 


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