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:
configuration
sen 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:
path
tä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



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