Konfigurere tilpassede plugin-moduler som er distribuert på agentkontrolleren

Tilpassede plugin-moduler kan distribueres på agentkontrolleren og kjøres på eksterne verter. Plugin-modulene blir installert i plugin-installeringskatalogen til agentkontrolleren. Hver plugin har sin egen pluginconfig.xml-fil, som definerer innstillingene for utførings- og applikasjonsmiljøet som plugin-modulen skal kjøres i.

Konfigurere utføringsmiljøet

Utføringsmiljøet for tilpassede plugin-moduler bør inneholde en tilpasset classpath-definisjon. Det sikrer at bare de nødvendige jar-filene for den tilpassede plugin-modulen blir kjørt. Slik konfigurerer du utføringsmiljøet:

  1. Finn konfigurasjonsfilen pluginconfig.xml for den tilpassede plugin-modulen. Den ligger vanligvis i agentkontrollerens installeringskatalog, under /plugin/<custom_plugin>/, der custom_plugin er navnet på plugin-katalogen.
  2. Åpne filen i et redigeringsprogram og søk etter elementet <AgentControllerEnvironment>. Hvis du ikke finner elementet, oppretter du det.
  3. Legg til underelementet <Variable>. Oppgi verdien til name-attributtet i formatet CLASSPATH_<org>_<myapp>, der org_myapp er navnet på plugin-katalogen der punktumet (.) er erstattet med et understrekingstegn (_). Oppgi position-attributtverdien som 'append'. Oppgi value-attributtet som jar-filen i den tilpassede plugin-katalogen. Dette er et eksempel på det tilpassede <AgentControllerEnvironment>-elementet:
    <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. Lagre endringene.
  5. Start agentkontrolleren på nytt.

    Merk: Et hvilket som helst antall <Variable>-elementer kan legges til i miljøet.  Reglene blir behandlet etter først-til-mølla-prinsippet.

Konfigurere applikasjonsmiljøet

Applikasjonsmiljøet for en plugin-modul er definert i elementet <Application> i filen pluginconfig.xml. Innstillingene i dette elementet er bare synlige for applikasjonen. Du kan også konfigurere applikasjonen til å bruke jar-filer fra andre applikasjoner som er distribuert på agentkontrolleren, ved å bruke elementet <Application>. Slik konfigurerer du applikasjonsmiljøet:

  1. Finn konfigurasjonsfilen pluginconfig.xml for den tilpassede plugin-modulen. Den ligger vanligvis i agentkontrollerens installeringskatalog, under /plugin/<custom_plugin>/, der custom_plugin er navnet på plugin-katalogen.
  2. Åpne filen i et redigeringsprogram og søk etter elementet <Application>. Elementet bør være definert slik:
      <Application configuration="default" executable="myapp2" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%">
        </Application>
    
  3. Hvis du skal konfigurere applikasjonen til å bruke jar-filer fra andre applikasjoner, legger du til underelementet Variable. Oppgi verdien til name-attributtet som CLASSPATH. Oppgi position-verdiattributtet som utføringsmiljø. Oppgi value-attributtet som plugin-katalog til den andre applikasjonen du vil bruke. Dette er et eksempel på en pluginconfig.xml-fil for myapp2, som bruker jar-filer fra et annet utføringsmiljø som heter 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. Lagre endringene.
  5. Start agentkontrolleren på nytt.

Beslektede oppgaver
Finne konfigurasjonsfilene
Administrere agentkontrolleren
 


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