Agentin ohjaimen kokoonpanotiedostot
Kaksi kokoonpanotiedostojen joukkoa määrittää agentin ohjaimen kokoonpanon.
Ensimmäinen joukko on peruskokoonpano, joka kuvaa perusosan oletusasetukset.
Toinen joukko on lisäosan kokoonpanomääritys, joka kuvaa perusosan sovelluskohtaiset asetukset.
Tässä asiakirjassa kuvataan tarkasti kutakin kokoonpanoa sekä sitä, miten kokoonpanolaajennuksia kirjoitetaan.
Tämän asiakirjan viittaukset kohtaan <asennushakemisto> tarkoittavat polkua, johon agentin ohjain on purettu. Hakemistoon viitataan kokoonpanotiedostoissa myös nimellä %RASERVER_HOME%.
Peruskokoonpano
Peruskokoonpano koostuu tiedostosta <asennushakemisto>/config/serviceconfig.xml, joka on luotu käyttämällä XML-skeemaa <asennushakemisto>/config/serviceconfig.xsd.
Skeema määrittää oletusasetukset, kuten järjestelmän ympäristömuuttujat, sovellusten kokoonpanot ja agentin ohjaimen yhteysasetukset. Peruskokoonpano on kaikkien kokoonpanojen käytettävissä, ja se latautuu perusosapalvelun aloituksen yhteydessä. Sovelluskehittäjien ei pidä muokata tätä peruskokoonpanotiedostoa, sillä peruskokoonpanoon tehdyt muutokset vaikuttavat kaikkialle. Lisäosien asetukset ja sovelluskohtaiset asetukset tulee määrittää käyttämällä lisäosien kokoonpanoja (näitä kuvataan edempänä).
Lisäosan kokoonpano
Käyttäjän määrittämien sovellusten kokoonpanotiedostot ja riippuvuudet tulee sijoittaa lisäosan hakemistoon <asennushakemisto>/plugin/<lisäosan_nimi>, jossa <lisäosan_nimi>
on sovelluksen tunnistukseen käytettävä yksilöllinen nimi. Lisäosan kokoonpanotiedosto pluginconfig.xml
tulee sijoittaa lisäosan hakemiston config-alihakemistoon.
JAR-tiedostot sijoitetaan yleensä lisäosan hakemiston lib-alihakemistoon.
Sovelluskehittäjät voivat käyttää XML-skeemaa <asennushakemisto>/config/pluginconfig.xsd apunaan, kun he määrittävät lisäosan kokoonpanotiedostoa.
Elementit ja määritteet
Elementti: AgentControllerConfiguration
Tämä on peruskokoonpanon pääelementti. Asetuksia käytetään perusosapalvelun aloitukseen.
Käyttävä metodi: Base Configuration
Alielementit: AgentControllerEnvironment, Application, Hosts, Service, Agent, Option, Plugin
Määritteet:
- activeConfiguration
- tämä määrittää, minkä kokoonpanon järjestelmä lataa perusosan aloituksen yhteydessä.
- filePort
- tämä määrittää portin, jota agentin ohjaimen tiedostonsiirtopalvelu kuuntelee. Oletusarvo on 10005.
- isDataMultiplexed
- tämä määrittää, tuleeko profilointi- ja kirjaustiedot välittää agentin ohjaimen ohjauskanavan kautta. Oletusarvon mukaan tietokanava käyttää tiedonsiirtoon ennalta määrittämätöntä porttia, minkä palomuuri saattaa estää. Jos tiedot siirretään ohjauskanavan kautta, palomuuriin voidaan avata ennalta määritettyjä portteja tulevia yhteyspyyntöjä varten. Näihin portteihin sisältyvät oletusportti 10002, suojattu portti 10003 ja tiedostopalvelimen portti 10005. Tämän määritteen oletusarvo on false.
- jvm
- Java VM -näennäiskoneen dynaamisen ajonaikaisen kirjaston täysin määritetty polku (jvm.dll tai libjvm.so)
- loggingDetail
- ottaa perusosan rivinumeroiden kirjauksen käyttöön, jos arvoksi on määritetty SUURI
- loggingDirectory
- hakemisto, johon järjestelmä luo perusosan lokitiedoston servicelog.log
- loggingLevel
- lokisanomien vakavuussuodatin
- port
- perusosan portti, jota käytetään saapuvan suojaamattoman työasemayhteyden kuunteluun
- processPolling
- tämä määrittää, onko prosessin tilan aktiivinen tarkistus käytössä. Tätä määritettä käytetään ensisijaisesti Windows-järjestelmissä varmistamaan, että agentin ohjaimelle ilmoitetaan prosessin päättymisestä. Oletusarvo on true.
- securedPort
- perusosan portti, jota käytetään saapuvan suojatun työasemayhteyden kuunteluun
- version
- perusosan versio
Elementti: PluginConfiguration
Tämä on lisäosan kokoonpanon pääosa. Järjestelmä lataa asetukset, kun peruskokoonpano on ladattu.
Käyttäjä: Configuration
Alielementit: AgentControllerEnvironment, Application, Service, Agent, Option
Määritteet:
- requires
- Pilkuilla eroteltu luettelo niiden lisäosien nimistä, joista tämä kokoonpano on riippuvainen. Versiosta TPTP 4.0 lähtien lisäosien nimiin on lisätty version tunnisteloppuliite. Se koostuu alaviivasta ja laitoksen versionumerosta. Esimerkki: org.eclipse.tptp.platform.agentcontroller_4.0.0. Voit varmistaa lisäosien yhteensopivuuden sellaisten sovellusten kanssa, joihin liittyy riippuvuuksia aiempien laitosten lisäosiin (lisäosiin, joilla ei ole versiotunnistemuotoista loppuliitettä), määrittämällä "requires"-määritteeseen lisäosan nimen ilman versiotunnistetta. Tällöin agentin ohjaimen kokoonpanon lataustoiminto yrittää ensin paikantaa koko lisäosan nimen, mukaan lukien version tunnisteloppuliite.
Jos paikannus ei onnistu, kokoonpanon lataustoiminto hakee lisäosan nimeä ilman version tunnisteloppuliitettä. Jos tarjolla on useita samannimisiä lisäosia, otetaan käyttöön ensimmäinen käyttöjärjestelmän palauttama lisäosan nimi.
Elementti: AgentControllerEnvironment
Tämä on paikkamerkki kokoonpanon toimittamille yleisille ympäristömuuttujille.
Ympäristömuuttujat julkaistaan järjestelmään, ja ne ovat kaikkien muiden kokoonpanojen käytettävissä, myös peruskokoonpanon.
Käyttävät metodit: AgentControllerConfiguration, PluginConfiguration
Alielementit: Variable
Määritteet:
- configuration
- sen kokoonpanon nimi, johon ympäristömuuttujat lisätään
Elementti: Application
Tämä on sovelluskohtaisen ympäristön paikkamerkki. Siihen liittyvät asetukset näkyvät vain kyseisessä sovelluksessa.
Käyttävät metodit: AgentControllerConfiguration, PluginConfiguration
Alielementit: Variable, Parameter
Määritteet:
- configuration
- sen kokoonpanon nimi, johon sovellus lisätään
- executable
- sovelluksen nimi, työasemien on käytettävä tätä nimeä sovelluksen yksilöintiin
- path
- sen ohjelman täysin määritetty polku, joka sovelluksen tulee ajaa
- location
- sovelluksen työhakemisto
- extends
- kokoonpanon nimi, jonka sama sovellus on jo määrittänyt; tämä lisää nykyiset asetukset aiempien lisäksi
Elementti: Hosts
Tämä on pääkonetietojen paikkamerkki. Tämän avulla perusosa sallii tiettyjen pääkoneiden yhteydenmuodostuksen tai estää tiettyjen pääkoneiden yhteydenmuodostuksen.
Käyttävä metodi: AgentControllerConfiguration
Alielementit: Allow, Deny
Määritteet:
configurationsen kokoonpanon nimi, jossa näitä pääkonetietoja käytetään
Elementti: Allow
Tämä määrittää, mitkä pääkoneet voivat muodostaa yhteyden perusosaan.
Käyttävä metodi: Hosts
Määritteet:
- host
- pääkoneen nimi tai IP-osoite
- net
- aliverkko
- mask
- aliverkon peite
Elementti: Deny
Tämä määrittää, mitkä pääkoneet eivät saa muodostaa yhteyttä peruskoneeseen.
Käyttävä metodi: Hosts
Määritteet:
- host
- pääkoneen nimi tai IP-osoite
- net
- aliverkko
- mask
- aliverkon peite
Elementti: Service
Tämä määrittää, mikä käyttäjän määrittämä moduuli ladataan perusosan aloituksen yhteydessä.
Käyttävät metodit: AgentControllerConfiguration, PluginConfiguration
Alielementti: Option
Määritteet:
- configuration
- sen kokoonpanon nimi, joka tämän palvelun tulee ladata
- name
- palvelun nimi
- path
- dynaamisen latauskirjaston täysin määritetty nimi
Elementti: Agent
Tämä määrittää agenttikohtaiset tiedot.
Käyttävät metodit: AgentControllerConfiguration, PluginConfiguration
Alielementti: Option
Määritteet:
- configuration
- sen kokoonpanon nimi, jossa tätä agentin kokoonpanoa käytetään
- name
- agentin nimi
- type
- agentin laji
- dataChannelSize
- prosessien väliseen viestintänä varattava jaetun muistin määrä
- logFile
- sen lokitiedoston täysin määritetty nimi, joka kirjoittaa agentin lähettämät sanomat
- client
- tämä määrittää, onko agentti dynaaminen vai päätelaitteeton
Elementti: Option
Tähän tallennetaan nimi-arvo-pari.
Käyttävät metodit: AgentControllerConfiguration, PluginConfiguration, Service, Agent
Määritteet:
- name
- asetuksen nimi (eli nimitila)
- type
- asetuksen laji (eli asetus)
- value
- asetuksen arvo
Elementti: Plugin
Tämä määrittää hakemiston, josta haetaan lisäosien kokoonpanoja
Käyttävä metodi: AgentControllerConfiguration
Määritteet:
pathtäysin määritetty hakemisto, josta haetaan lisäosien kokoonpanoja
Elementti: Variable
Ympäristömuuttuja.
Käyttävät metodit: Application, AgentControllerEnvironment
Määritteet:
- name
- ympäristömuuttujan nimi (esimerkiksi CLASSPATH)
- value
- ympäristömuuttujan arvo
- position
- tämä määrittää, tuleeko arvo asettaa nykyisen arvon eteen vai jälkeen vai tuleeko sen korvata nykyinen arvo
Elementti: Parameter
Ohjelman parametri.
Käyttävä metodi: Application
Määritteet:
- value
- ohjelmaparametrin arvo
- position
- tämä määrittää, tuleeko parametri asettaa nykyisen parametrin eteen vai jälkeen vai tuleeko sen korvata nykyinen parametri