Agentin ohjaimessa käyttöönotettujen mukautettujen lisäosien määritys

Mukautettuja lisäosia voi ottaa käyttöön agentin ohjaimessa ja ajaa etäpääkoneissa. Lisäosat on asennettu agentin ohjaimen asennushakemiston plugin-hakemistoon. Kullakin lisäosalla on oma pluginconfig.xml-tiedostonsa, jossa määritetään lisäosan ajon suoritusympäristö ja sovelluksen ympäristöasetukset.

Suoritusympäristön määritys

Mukautettujen lisäosien suoritusympäristön tulee sisältää mukautettu luokkapolun määritys. Tällöin järjestelmä suorittaa vain mukautetun lisäosan tarvitsemat jar-tiedostot. Voit mukauttaa suoritusympäristöä seuraavasti:

  1. Etsi mukautetun lisäosan pluginconfig.xml-kokoonpanotiedosto. Tiedosto sijaitsee yleensä agentin ohjaimen asennushakemistossa kohteessa /plugin/<mukautettu_lisäosa>/, jossa mukautettu_lisäosa on lisäosahakemiston nimi.
  2. Avaa kohde muokkausohjelmassa ja hae elementtiä <AgentControllerEnvironment>. Jos elementtiä ei ole, luo se.
  3. Lisää alielementti <Variable>. Määritä name-määritteen arvo käyttäen muotoa CLASSPATH_<org>_<myapp>, jossa org_myapp on lisäosahakemiston nimi niin, että piste (.) on korvattu alaviivalla (_). Määritä position-määritteen arvoksi append. Määritä value-määritteen arvoksi mukautetun lisäosan hakemistossa oleva jar-tiedosto. Seuraavassa on esimerkki mukautetusta <AgentControllerEnvironment>-elementistä:
    <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. Tallenna muutokset.
  5. Aloita agentin ohjain uudelleen.

    Huomautus: Ympäristöön voi lisätä rajoittamattoman määrän <Variable>-elementtejä. Säännöt käsitellään niiden esitysjärjestyksessä.

Sovellusympäristön määritys

Lisäosan sovellusympäristö määritetään pluginconfig.xml-tiedoston <Application>-elementissä. Tämän elementin asetukset näkyvät vain sovelluksessa. Voit määrittää sovelluksen myös käyttämään muiden agentin ohjaimessa käyttöönotettujen sovellusten jar-tiedostoja käyttämällä <Application>-elementtiä. Määritä sovellusympäristö seuraavasti:

  1. Etsi mukautetun lisäosan pluginconfig.xml-kokoonpanotiedosto. Tiedosto sijaitsee yleensä agentin ohjaimen asennushakemistossa kohteessa /plugin/<mukautettu_lisäosa>/, jossa mukautettu_lisäosa on lisäosahakemiston nimi.
  2. Avaa kohde muokkausohjelmassa ja hae elementtiä <Application>. Osan tulee olla määritetty seuraavasti:
      <Application configuration="default" executable="myapp2" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%">
      </Application>
    
    jossa
  3. Voit määrittää sovelluksen käyttämään muiden sovellusten jar-tiedostoja käyttämällä Variable-alielementtiä. Määritä name-määritteen arvoksi CLASSPATH. Määritä position-määritteen arvoksi suoritusympäristö. Määritä value-määritteen arvoksi haluamasi toisen lisäosan lisäosahakemisto. Seuraava esimerkki on myapp2-sovelluksen pluginconfig.xml-tiedosto, kun myapp2-sovellus käyttää toisen suoritusympäristön (org.myapp) jar-tiedostoja.
    <?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. Tallenna muutokset.
  5. Aloita agentin ohjain uudelleen.

Aiheeseen liittyviä tehtäviä
Kokoonpanotiedostojen paikannus
Agentin ohjaimen hallinta
 


(C) Copyright IBM Corporation 2000, 2006. All rights reserved.