Konfigurationsfiler för agentkontrollanten

Konfigurationen för agentkontrollanten specificeras i två uppsättningar konfigurationsfiler. Den första uppsättningen är baskonfigurationen, som beskriver standardinställningarna för motorn. Den andra uppsättningen är konfigurationen för insticksprogrammet, som beskriver de tillämpningsspecifika inställningarna för motorn. I det här dokumentet beskrivs informationen för varje konfiguration och hur du skriver konfigurationsutökningar.

Katalogen <install directory> som refereras till i det här dokumentet motsvarar till den sökväg där agentkontrollanten packas upp. Katalogen refereras också till som %RASERVER_HOME% i konfigurationsfilerna.

Baskonfiguration

Baskonfigurationen består av filen <install directory>/config/serviceconfig.xml som konstrueras med XML-schemat <install directory>/config/serviceconfig.xsd. Den anger standardinställningarna, t.ex. systemmiljövariabler, tillämpningskonfigurationer och anslutning för agentkontrollanten. Baskonfigurationen är tillgänglig för alla konfigurationer och läses in när motortjänsten startas. Tillämpningsutvecklare bör inte ändra baskonfigurationsfilen, eftersom ändringar i baskonfigurationen blir globala. Konfigurationer för insticksprogram (beskrivs nedan) bör användas till att ange insticksprograms- och tillämpningsspecifika inställningar.

Konfiguration för insticksprogram

Varje användardefinierad tillämpning bör ha konfigurationsfilen och beroendena placerade i katalogen för insticksprogrammet <install directory>/plugin/<plug-in name> där <plug-in name> är ett unikt namn som identifierar tillämpningen. Konfigurationsfilen för insticksprogrammet pluginconfig.xml bör placeras i underkatalogen config för katalogen för insticksprogrammet. JAR-filer placeras vanligen i underkatalogen lib för katalogen för insticksprogrammet. Utvecklare kan använda XML-schemat <install directory>/config/pluginconfig.xsd till att hjälpa till att konstruera konfigurationsfilen för insticksprogrammet.

Element och attribut

Element: AgentControllerConfiguration
Det här är rotelementet för baskonfigurationen. Inställningarna används för att starta motortjänsten.

Används av: Baskonfiguration

Underelement: AgentControllerEnvironment, Application, Hosts, Service, Agent, Option, Plugin

Attribut:
activeConfiguration
ange vilken konfiguration som ska läsas in när motorn startar
filePort
ange vilken port som filöverföringstjänsten för agentkontrollanten lyssnar på. Standardvärdet är 10005.
isDataMultiplexed
ange om profilerings- och loggningsdata ska överföras via kontrollkanalen för agentkontrollanten. Som standard använder datakanalen en godtycklig port för dataöverföring och kan blockeras av att en brandvägg finns. Om data överförs via kontrollkanalen kan en uppsättning fördefinierade portar öppnas för inkommande anslutningsbegäran genom en brandvägg. Till de portarna hör standardporten 10002, den säkrade porten 10003 och filserverporten 10005. Standardvärdet för attributet är false (falskt).
jvm
fullständig sökväg för Java Virtual Machine dynamiskt runtime-bibliotek (jvm.dll eller libjvm.so)
loggingDetail
aktivera radnummerloggning av motorn om HIGH anges
loggingDirectory
katalog där motorloggfilen servicelog.log skapas
loggingLevel
allvarlighetsgradsfilter för loggmeddelanden
port
motorport för att lyssna på inkommande osäkrad klientanslutning
processPolling
ange om aktiv kontroll av processtatus är aktiverad. Attributet används i första hand i Windows-system för att se till att agentkontrollanten meddelas när en process har avslutats. Standardvärdet är true (sant).
securedPort
motorport för att lyssna på inkommande säkrad klientanslutning
version
motorns version

Element: PluginConfiguration
Det här är rotelementet för konfigurationen för insticksprogrammet. Inställningarna läses in när baskonfigurationen har lästs in.

Används av: Konfiguration för insticksprogram

Underelement: AgentControllerEnvironment, Application, Service, Agent, Option

Attribut:
requires
en kommaavgränsad lista över namn på insticksprogram som den här konfigurationen är beroende av. Fr.o.m. TPTP 4.0 har ett suffix som anger versions-ID lagts till namnet för insticksprogrammet. Det består av ett understreck följt av versionsnumret för utgåvan. Exempel: org.eclipse.tptp.platform.agentcontroller_4.0.0. För att säkra kompatibilitet med insticksprogrammet för tillämpningar som har beroenden på insticksprogram från tidigare utgåvor (insticksprogram som inte har suffix som anger versions-ID) kan du välja att ange namnet för insticksprogrammet för attributet "requires" undantaget versions-IDt. I det fallet försöker agentkontrollantens konfigurationsinläsningsfunktion först att hitta det fullständiga namnet för insticksprogrammet inkluderat suffixet för versions-ID. Om det inte går söker konfigurationsinläsningsfunktionen efter namnet för insticksprogrammet utan suffixet för versions- ID. Om det finns fler än ett insticksprogram med samma namn används det första namnet för insticksprogram som returneras av operativsystemet.

Element: AgentControllerEnvironment
Det här är en platshållare för globala miljövariabler som läggs till av den här konfigurationen. De publiceras för systemet och är tillgängliga för alla andra konfigurationer inräknat baskonfigurationen.

Används av: AgentControllerConfiguration, PluginConfiguration

Underelement: Variable

Attribut:
configuration
namnet för den konfiguration där miljövariablerna ska läggas till

Element: Application
Det här är en platshållare för tillämpningsspecifik miljö. Inställningarna inom den syns bara för just den här tillämpningen.

Används av: AgentControllerConfiguration, PluginConfiguration

Underelement: Variable, Parameter

Attribut:
configuration
namnet för den konfiguration där tillämpningen ska läggas till
executable
namnet för tillämpningen, klienter måste använda det namnet för att identifiera tillämpningen
path
den faktiska, fullständiga sökvägen för det program som tillämpningen ska köra
location
arbetskatalogen för tillämpningen
extends
det konfigurationsnamn som samma tillämpning redan har definierat, de aktuella inställningarna läggs till överst

Element: Hosts
Det här är en platshållare för värdinformation. Den används av motorn för att tillåta/inte tillåta att vissa värdar ansluter.

Används av: AgentControllerConfiguration

Underelement: Allow, Deny

Attribut:
configuration
namnet för den konfiguration där värdinformationen används

Element: Allow
Anger vilka värdar som tillåts ansluta till motorn.

Används av: Värdar

Attribut:
host
namnet eller IP-adressen för värden
net
subnät
mask
subnätmask
Element: Deny
Anger vilka värdar som inte tillåts ansluta till motorn.

Används av: Värdar

Attribut:
host
namnet eller IP-adressen för värden
net
subnät
mask
subnätmask

Element: Service
Anger vilken användardefinierad modul som ska läsas in vid start av motorn.

Används av: AgentControllerConfiguration, PluginConfiguration

Underelement: Option

Attribut:
configuration
namnet för den konfiguration där den här tjänsten ska läsas in
name
namnet för tjänsten
path
Den fullständiga sökvägen för det dynamiska inläsningsbiblioteket


Element: Agent
Anger agentspecifik information.

Används av: AgentControllerConfiguration, PluginConfiguration

Underelement: Option

Attribut:
configuration
namnet för den konfiguration där värdinformationen används
name
namnet för agenten
Typ
typen för agenten
dataChannelSize
den mängd delat minne som ska allokeras för kommunikation mellan processer
logFile
fullständigt kvalificerad sökväg för den loggfil som skriver de meddelanden som sänds av agenten
client
anger om agenten är dynamisk eller konsollös
Element: Option
Används för att lagra ett namn-värde-par. Används av: AgentControllerConfiguration, PluginConfiguration, Service, Agent Attribut:
name
namnet för alternativet (i.e. namnområde)
Typ
typen för alternativet (i.e. alternativnamn)
value
värdet för alternativet


Element: Plugin
Anger den katalog där konfigurationer för insticksprogram ska sökas

Används av: AgentControllerConfiguration

Attribut:
path
fullständig katalog där konfigurationer för insticksprogram ska sökas

Element: Variable
Miljövariabel.

Används av: Application, AgentControllerEnvironment

Attribut:
name
namnet för miljövariabeln (t.ex. CLASSPATH)
value
värdet för miljövariabeln
position
anger om värdet ska läggas till eller ersätta det befintliga värdet
Element: Parameter
Programparameter.

Används av: Application

Attribut:
value
värdet för programparametern
position
anger om parameter ska läggas till eller ersätta den befintliga parametern



(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.