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:
configurationnamnet 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:
pathfullstä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