Ügynökvezérlő konfigurációs fájlok
Az ügynökvezérlő konfigurációkat két konfigurációs fájl készlet tartalmazza.
Az első készletben az alap konfigurációk szerepelnek, amelyek az alrendszer
alapértelmezett konfigurációit írják le.
A második készletben a bedolgozó konfigurációk szerepelnek, amelyek az alrendszer
alkalmazások speciális konfigurációit írják le.
Ez a dokumentum az egyes konfigurációk részleteivel és azok kiterjesztésének
írásának módjával foglalkozik.
A dokumentumban a <telepítési könyvtár> megnevezés annak az
elérési útnak felel meg, ahova az ügynökvezérlő ki lett csomagolva. A
konfigurációs fájlokban ez %RASERVER_HOME% könyvtárként jelenik meg.
Alap konfigurációk
Az alap konfiguráció a <telepítési
könyvtár>/config/serviceconfig.xml fájlban található, amely a
<telepítési könyvtár>/config/serviceconfig.xsd XML séma
használatával lett összeállítva.
Ez az olyan alapértelmezett konfigurációkat adja meg, mint az ügynökvezérlő
környezeti változói, alkalmazás konfigurációi és összekapcsolhatósága. Az alap konfigurációk minden konfiguráció számára elérhetők, és az alrendszer
szolgáltatás indulásakor kerülnek betöltésre. Az alkalmazás fejlesztőknek nem ajánlott
az alap konfigurációk módosítása, mivel ezek a változások globálisan érvényesek. A
bedolgozó konfigurációk (lásd alább) a bedolgozókhoz és alkalmazásokhoz tartozó
speciális konfigurációkhoz használhatók.
Bedolgozó konfigurációk
Minden felhasználó által megadott alkalmazásnak kell rendelkeznie egy konfigurációs fájllal és a függőségek
leírásával a bedolgozó könyvtárában (<telepítési könyvtár>/plugin/<bedolgozó neve>, ahol a
<bedolgozó neve> egy egyedi név, amely az alkalmazást azonosítja). A pluginconfig.xml konfigurációs fájlnak a bedolgozó
könyvtárának config alkönyvtárában kell elhelyezkednie.
Jellemzően a JAR fájlok a bedolgozó könyvtárának lib alkönyvtárában
helyezkednek el.
A fejlesztők a <telepítési könyvtár>/config/pluginconfig.xsd XML
sémát használhatják segítségül a bedolgozó konfigurációs fájl összeállításához.
Elemek és jellemzők
Elem: AgentControllerConfiguration
Ez az alap konfiguráció gyökéreleme. A konfigurációk az alrendszer szolgáltatás
indítására használhatók.
Használó: Alap konfiguráció
Részelemek: AgentControllerEnvironment, Application, Hosts, Service,
Agent, Option, Plugin
Jellemzők:
- activeConfiguration
- az alrendszer indításakor betöltendő konfigurációt
határozza meg
- filePort
- megadja, melyik porton figyel az ügynökvezérlő fájltovábbítási
szolgáltatása. Az alapértelmezett érték a 10005.
- isDataMultiplexed
- megadja, hogy a profil- és naplózási adatok
továbbíthatók-e az ügynökvezérlő vezérlőcsatornáján. Az adatcsatorna alapértelmezésben egy tetszőleges portot használ az adatátvitelre, és ezt egy tűzfal blokkolhatja. Az adatok továbbítása a vezérlőcsatornán lehetővé teszi egy sor előre meghatározott port megnyitását a bejövő kérések számára a tűzfalon keresztül. Ezek közé tartozik az alapértelmezett
10002-es port, a védett 10003-as port és a fájlkiszolgáló 10005-ös port. attribútum Az alapértelmezett értéke a false.
- jvm
- a Java virtuális gép (JVM) dinamikus futási függvénytárának
(jvm.dll vagy libjvm.so) teljes képzésű elérési útja
- loggingDetail
- HIGH érték esetén lehetővé teszi az alrendszer
sorainak számának naplózását
- loggingDirectory
- a servicelog.log naplófájl létrehozásának
könyvtára
- loggingLevel
- fontossági szűrő a naplóüzenetekhez
- port
- alrendszer port a bejövő, nem biztonságos ügyfélcsatlakozások figyelésére
- processPolling
- megadja, hogy a feldolgozási állapot aktív ellenőrzése engedélyezve
van-e. Ez az attribútum első sorban Windows rendszereken használatos annak biztosítására, hogy
az ügynökvezérlő értesítést kapjon, amikor egy folyamat lezárásra került. Az alapértelmezett érték a true.
- securedPort
- alrendszer port a bejövő biztonságos ügyfélcsatlakozások figyelésére
- version
- az alrendszer verziószáma
Elem: PluginConfiguration
Ez a bedolgozó konfiguráció gyökéreleme. Ezek a konfigurációk az alap konfigurációk
betöltése után kerülnek betöltésre.
Használó: Bedolgozó konfigurációk
Részelemek: AgentControllerEnvironment, Application, Service, Agent,
Option
Jellemzők:
- requires
- vesszővel elválasztott lista azon bedolgozó(k) nevével, amely(ek)től ezen konfigurációk függnek. A TPTP 4.0 verziójában megjelent egy verzióazonosító utótag a bedolgozók
nevében. Egy aláhúzás karakterből és a kiadás verziószámából áll. Például
org.eclipse.tptp.platform.agentcontroller_4.0.0. A korábbi kiadások (verziószám utótaggal nem rendelkező) bedolgozóitól függő alkalmazások
kompatibilitásának megőrzése végett a "requires" attribútumban a
bedolgozó neve a verzióazonosító nélkül is meghatározható. Ebben az esetben az ügynökvezérlő konfiguráció betöltője először a verzióazonosító
utótagot is tartalmazó teljes név alapján próbálja megkeresni a bedolgozót.
Ha ez sikertelen, akkor a konfiguráció betöltője a verzióazonosító utótag nélkül próbálja megkeresni a bedolgozót. Ha ugyanazon a néven több
bedolgozó is van, akkor az operációs rendszer által elsőként visszaadott bedolgozónév kerül felhasználásra.
Elem: AgentControllerEnvironment
Ezen konfigurációval közreműködő globális környezeti változó(k) helyőrzője.
Ezek közzétettek a rendszer számára és minden más konfiguráció számára elérhetők,
beleértve az alap konfigurációkat is.
Használó: AgentControllerConfiguration, PluginConfiguration
Részelemek: Variable
Jellemzők:
- configuration
- azon konfiguráció neve, ahova a környezeti változók
hozzáadásra kerülnek
Elem: Application
Alkalmazásfüggő környezet helyőrzője. Az ebben szereplő konfigurációk csak az
adott alkalmazás számára láthatók.
Használó: AgentControllerConfiguration, PluginConfiguration
Részelemek: Variable, Parameter
Jellemzők:
- configuration
- azon konfiguráció neve, ahova az alkalmazás hozzáadásra
kerül
- executable
- az alkalmazás neve, amellyel az ügyfelek azonosítják
az alkalmazást.
- path
- az alkalmazás által futtatandó program aktuális, teljes
képzésű elérési útja
- location
- az alkalmazás munkakönyvtára
- extends
- az alkalmazás által már megadott konfiguráció neve, ez
veszi fel a jelenlegi konfigurációkat
Elem: Hosts
A hosztinformációk helyőrzője. Az alrendszer használja adott hoszt(ok)hoz
csatlakozás engedélyezésére / tiltására.
Használó: AgentControllerConfiguration
Részelemek: Allow, Deny
Jellemzők:
configurationa hosztinformációk által használt konfiguráció neve
Elem: Allow
Azt határozza meg, hogy melyik hoszt(ok) csatlakozhat(nak) az alrendszerhez.
Használó: Hosts
Jellemzők:
- host
- a hoszt neve vagy IP címe
- net
- alhálózat
- mask
- alhálózati maszk
Elem: Deny
Azt határozza meg, hogy melyik hoszt(ok) nem csatlakozhat(nak) az alrendszerhez.
Használó: Hosts
Jellemzők:
- host
- a hoszt neve vagy IP címe
- net
- alhálózat
- mask
- alhálózati maszk
Elem: Service
Az alrendszer indításakor betöltendő felhasználó által meghatározott modult
adja meg.
Használó: AgentControllerConfiguration, PluginConfiguration
Részelemek: Option
Jellemzők:
- configuration
- a szolgáltatás által betöltendő konfiguráció neve
- name
- a szolgáltatás neve
- path
- a dinamikus betöltésű függvénytár teljes képzésű elérési útja
Elem: Agent
Az ügynökkel kapcsolatos információkat határozza meg.
Használó: AgentControllerConfiguration, PluginConfiguration
Részelemek: Option
Jellemzők:
- configuration
- az ügynök konfiguráció által használt konfiguráció neve
- name
- az ügynök neve
- type
- az ügynök típusa
- dataChannelSize
- a folyamatközti kommunikáció számára lefoglalandó
megosztott memória mennyisége
- logFile
- az ügynök által küldött üzeneteket tartalmazó naplófájl
teljes képzésű elérési útja
- client
- azt határozza meg, hogy az ügynök dinamikus vagy nem
Elem: Option
Név-érték pár tárolására szolgál.
Használó: AgentControllerConfiguration, PluginConfiguration, Service,
Agent
Jellemzők:
- name
- a konfiguráció neve (pl.: névtartomány)
- type
- a konfiguráció típusa (pl.: konfiguráció név)
- value
- a konfiguráció értéke
Elem: Plugin
A bedolgozó konfigurációkat tartalmazó könyvtárt adja meg.
Használó: AgentControllerConfiguration
Jellemzők:
patha bedolgozó konfigurációkat tartalmazó teljes képzésű könyvtár
Elem: Variable
Környezeti változó.
Használó: Application, AgentControllerEnvironment
Jellemzők:
- name
- a környezeti változó neve (pl.: CLASSPATH)
- value
- a környezeti változó értéke
- position
- azt határozza meg, hogy az értéket hozzáfűzni kell a létező érték végéhez, elejéhez, vagy a létező értéket ki kell cserélni ezzel az értékkel
Elem: Parameter
Programparaméter.
Használó: Application
Jellemzők:
- value
- a programparaméter értéke
- position
- azt határozza meg, hogy a paramétert hozzáfűzni kell a
létező paraméter végéhez, elejéhez, vagy a létező paramétert ki kell cserélni
ezzel a paraméterrel