Agentin ja agentin ohjaimen kokoonpanon yleiskuvaus
Huomautus
Tässä asiakirjassa olevissa viittauksissa tiedosto- ja hakemistosijainteihin
<install-home> on hakemisto, jonne agentin ohjaimen paketti
on purettu.
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ällaisia tietoja ovat
muun muassa agentin aloitustapa (esimerkiksi ohjelmatiedoston polun nimi
ja komentorivin argumentit), agentin tukemat komennot (rajapinnat)
sekä tiedot siitä, kuinka monta agentin ilmentymää voi olla ajossa ja
kuinka monta samanaikaista käyttäjää agentilla voi 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) 2005, 2006 Intel Corporation.