Agentin ja agentin ohjaimen kokoonpanon yleiskuvaus

Huomautus

Tämän asiakirjan viittauksissa tiedostojen ja hakemistojen sijaintipaikkoihin <install-home>-hakemisto on hakemisto, johon agentin ohjain -pakkaus purettiin.

Johdanto

Agentin ohjaimen ja agenttien toiminnan ohjauksessa on käytössä seuraavat kolme kokoonpanotiedostoa:

• Agentin ohjain lukee serviceconfig.xml-kokoonpanotiedoston agentin ohjaimen aloituksen aikana. Tiedosto määrittää yhteysasetukset, yleisen kirjaustason ja sovellusten ja agenttien aloituksessa käytettävät yleiset asetukset.  Tiedoston lukevat lisäksi agentit, jotka yrittävät rekisteröityä tiettyyn agentin ohjaimeen. Kullekin yhdessä järjestelmässä ajettavalle agentin ohjaimen ilmentymälle on määritettävä oma serviceconfig.xml-tiedosto, jossa on yksilölliset yhteysasetukset.  Lisätietoja tämän kokoonpanotiedoston elementeistä on ohjeessa Serviceconfig.xml-tiedosto.
   
• Kunkin agentin kiinteät kokoonpanotiedot ovat agent.xml-tiedostossa. Tässä tiedostossa on tiedot, joita agentin ohjain tarvitsee tietystä agentista.  Tähän sisältyy tieto siitä, kuinka agentti aloitetaan (ohjelmatiedoston polun nimi, komentoriviargumentit jne.), mitä komentoja (rajapintoja)  agentti tukee, käyttörajoituksia sille, kuinka monta tämän agentin ilmentymää saa olla käynnissä ja kuinka monta yhtäaikaista agentin käyttäjää saa olla.  Agentin ohjain etsii näitä kokoonpanotiedostoja serviceconfig.xml-tiedoston Agent-elementtiin määritetystä hakemistosta (yleensä se on <install-home>\agents). Kullakin agentilla on oma yksilöllisesti nimetty hakemisto, jossa on agent.xml-tiedosto (esimerkiksi <install-home>\agents\org.eclipse.tptp.TimeCollector\agent.xml). Kun agentista tehdään pyyntö, agentin ohjain etsii agentin agent.xml-kokoonpanotiedostoon määritetyn nimen perusteella.  Lisätietoja tämän kokoonpanotiedoston elementeistä on ohjeessa Agent.xml-tiedosto.

Huomautus

Jos agenttien aloituksessa on käytössä agentin ohjaimen vanha rajapinta, agent.xml-tiedostolla ei ole merkitystä. Vanhaa rajapintaa käytettäessä työasemaohjelman on määritettävä aloitettavan prosessin nimi, joka on määritetty sovelluksen valenimeksi. Sovelluksen valenimimäärityksen on oltava pluginconfig.xml- tai serviceconfig.xml-tiedostossa. Järjestelmä ohittaa agent.xml-tiedostoon määritetyn sovelluksen valenimen.

• Pluginconfig.xml-tiedostoa käyttävät kaikki sovellukset (ja agentit), joita varten serviceconfig.xml-tiedostossa määritettyjä ympäristöasetuksia tai sovellusten valenimiluetteloa on laajennettava. Käytetty lisäosa-käsite voi olla harhaanjohtava, koska sovelluksen ei tarvitse olla Eclipse-lisäosa, vaikka ne ovat olleet aluksi käytössä. Agentin ohjain hakee tiedostoa serviceconfig.xml-tiedoston Plugin-elementissä määritetystä hakemistosta (yleensä tämä on <install-home>\plugins). Kullakin sovelluksella on oma yksilöllisesti nimetty hakemisto, ja pluginconfig.xml-tiedoston on oltava tämän hakemiston \config-alihakemistossa.  Lisätietoja tämän kokoonpanotiedoston elementeistä on ohjeessa Pluginconfig.xml-tiedosto.
   
• Kunkin agentin dynaamiset kokoonpanotiedot ovat agentconfig.xml-tiedostossa. Tämä tiedosto on valinnainen. Siinä pitäisi olla kokoonpanotiedot, joita agentti käyttää joko aloituksessa tai jossakin toteutusvaiheessa. Agentin luonut henkilö määrittää tiedoston sisällön ja käyttötavan.Agentconfig.xml-tiedosto on yleensä agentin päähakemiston \config-alihakemistossa (esimerkiksi <install-home>\agents\org.eclipse.tptp.TimeCollector\config\agentconfig.xml).  Voit määrittää tämän kokoonpanohakemiston agent.xml-tiedostoon.  Agentti voi käyttöönottotapansa perusteella lukea tämän kokoonpanotiedoston vain kerran tai useasti tai jättää tiedoston lukematta. Agentin ohjain ei lue tätä tiedostoa koskaan.   Tässä versiossa tälle tiedostolle ei ole elementtiehdotuksia, joten siitä ei ole esimerkkiä.
   

Aiheeseen liittyviä ohjeita

Serviceconfig.xml-tiedosto
Agent.xml-tiedosto
Pluginconfig.xml-tiedosto

Copyright (C) 2006 Intel Corporation.