Ü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:
configuration
a 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:
path
a 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



(C) Copyright IBM Corporation 2000, 2006. Minden jog fenntartva.