Konfigurasjonsfiler for agentkontrolleren
Konfigurasjonen til agentkontrolleren er spesifisert i to sett med konfigurasjonsfiler. Det første settet inneholder basiskonfigurasjonen som beskriver standardinnstillinger for motoren. Det andre settet inneholder plugin-konfigurasjonen som beskriver applikasjonsbestemte innstillinger for motoren. Dette dokumentet inneholder detaljerte opplysninger om hver
konfigurasjon, og hvordan du skriver konfigurasjonsutvidelser.
Katalogen <installeringskatalog> som det blir henvist
til i dette dokumentet, tilsvarer banen der agentkontrolleren pakkes
ut. Denne katalogen kalles også %RASERVER_HOME%
i konfigurasjonsfilene.
Basiskonfigurasjon
Basiskonfigurasjonen består av filen <installeringskatalog>/config/serviceconfig.xml som konstrueres
ved hjelp av XML-skjemaet <installeringskatalog>/config/serviceconfig.xsd. Den angir standardinnstillingene, for eksempel systemmiljøvariabler, applikasjonskonfigurasjoner og
tilknytning for agentkontrolleren. Basiskonfigurasjonen er tilgjengelig for alle konfigurasjoner og lastes
inn når motortjenesten startes. Applikasjonsutviklere bør ikke endre
basiskonfigurasjonen, fordi endringer i basiskonfigurasjonen blir
globale. Plugin-konfigurasjoner (beskrevet nedenfor) bør brukes for å oppgi plugin- og applikasjonsspesifikke innstillinger.
Plugin-konfigurasjon
Alle brukerdefinerte applikasjoner bør ha sin egen konfigurasjonsfil og avhengigheter som i plugin-katalogen <installeringskatalog>/plugin/<plugin-navne> der <plugin-navn>
er et unikt navn som identifiserer applikasjonen. Plugin-konfigurasjonsfilen pluginconfig.xml
bør være plassert i config-underkatalogen i plugin-katalogen. JAR-filer er vanligvis plassert i underkatalogen lib i plugin-katalogen. Utviklere kan bruke XML-skjemaet
<installeringskatalog>/config/pluginconfig.xsd som
hjelp når de konstruerer plugin-konfigurasjonsfilen.
Elementer og attributter
Element: AgentControllerConfiguration
Dette er rotelementet i basiskonfigurasjonen. Innstillingene blir brukt til å starte motortjenesten.
Brukes av: basiskonfigurasjonen
Underelementer: AgentControllerEnvironment, Application, Hosts, Service, Agent, Option, Plugin
Attributter:
- activeConfiguration
- oppgi hvilken konfigurasjon som skal lastes inn når motoren startes
- filePort
- oppgi hvilken port Agentkontroller-filoverføringstjenesten lytter til. Standardverdien er 10005.
- isDataMultiplexed
- oppgi om profilering og logging av data skal sendes over kontrollkanalen til agentkontrolleren. Datakanalen bruker som standard en vilkårlig port ved dataoverføring og kan være blokkert av en brannmur. Overføring av data via
kontrollkanalen tillater et sett med forhåndsdefinerte porter som
åpnes for innkommende tilkoblingsforespørsler gjennom en brannmur.
Disse portene inkluderer standardporten 10002, den sikre porten 10003 og filserverporten 10005. Standardverdien for dette attributtet er false.
- jvm
- fullt kvalifisert bane til det dynamiske JVM-kjøretidsbiblioteket (jvm.dll eller libjvm.so)
- loggingDetail
- aktiver linjenummerlogging for motoren hvis HIGH er spesifisert
- loggingDirectory
- katalog der motorloggfilen servicelog.log blir opprettet
- loggingLevel
- alvorsgradfilter for loggmeldinger
- port
- motorport for lytting til innkommende, usikret klienttilkobling
- processPolling
- oppgi om aktiv prosesstatuskontroll skal aktiveres eller ikke.
Dette attributtet blir i hovedsak brukt på Windows-systemer for å
sikre at agentkontrolleren blir varslet når en prosess blir avsluttet. Standardverdien er true.
- securedPort
- motorport for lytting til innkommende, sikret klienttilkobling
- version
- versjonen til motoren
Element: PluginConfiguration
Dette er rotelementet til plugin-konfigurasjonen. Innstillingene blir lastet inn etter at basiskonfigurasjonen er lastet inn.
Brukes av: Plug-in Configuration
Underelementer: AgentControllerEnvironment, Application, Service, Agent, Option
Attributter:
- requires
- en kommaseparert liste over plugin-navn som denne konfigurasjonen er avhengig av. Fra og med TPTP 4.0
er det lagt til et suffiks for versjons-ID i plugin-navn. Det består av et understrekingstegn etterfulgt av versjonsnummeret for utgaven. For eksempel org.eclipse.tptp.platform.agentcontroller_4.0.0. For å sikre plugin-kompatibilitet for applikasjoner som har
avhengigheter med plugin-moduler fra tidligere utgaver (plugin-moduler
som ikke har versjons-ID-suffiks), kan du oppgi plugin-navnet for
attributtet "requires" uten versjons-IDen. I dette tilfellet vil innlastingsprogrammet for agentkontrollerens konfigurasjon først forsøke å finne det fullstendige plugin-navnet med versjons-ID-suffikset.
Hvis det ikke lykkes, søker innlastingsprogrammet etter plugin-navnet uten versjons-ID-suffikset. Hvis det er flere plugin-moduler med samme navn, brukes det første plugin-navnet som blir returnert av operativsystemet.
Element: AgentControllerEnvironment
Dette er en plassholder for globale miljøvariabler fra denne konfigurasjonen. Disse blir publisert til systemet og gjøres tilgjengelige for alle konfigurasjoner, inkludert basiskonfigurasjonen.
Brukes av: AgentControllerConfiguration, PluginConfiguration
Underelementer: Variable
Attributter:
- configuration
- navnet på konfigurasjonen der miljøvariablene skal legges til
Element: Application
Dette er en plassholder for applikasjonsspesifikke miljøer. Innstillingene i denne er bare synlige for denne bestemte applikasjonen.
Brukes av: AgentControllerConfiguration, PluginConfiguration
Underelementer: Variable, Parameter
Attributter:
- configuration
- navnet på konfigurasjonen der applikasjonen skal legges til
- executable
- navnet på applikasjonen, klienter må bruke dette navnet for å identifisere denne applikasjonen
- path
- den faktiske, fullt kvalifiserte banen til programmet som denne applikasjonen skal kjøre
- location
- arbeidskatalogen til denne applikasjonen
- extends
- konfigurasjonsnavnet som den samme applikasjonen allerede er definert for, dette vil legge til de gjeldende innstillingene øverst
Element: Hosts
Dette er en plassholder for vertsinformasjon. Den blir brukt av motoren for å tillate/ikke tillate tilkobling fra bestemte verter.
Brukes av: AgentControllerConfiguration
Underelementer: Allow, Deny
Attributter:
configurationnavnet på konfigurasjonen som denne vertsinformasjonen bruker
Element: Allow
Dette angir hvilke(n) vert(er) som kan koble seg til motoren.
Brukes av: Hosts
Attributter:
- host
- navn eller IP-adresse til verten
- net
- delnett
- mask
- delnettmaske
Element: Deny
Dette angir hvilke(n) vert(er) som ikke kan koble seg til motoren.
Brukes av: Hosts
Attributter:
- host
- navn eller IP-adresse til verten
- net
- delnett
- mask
- delnettmaske
Element: Service
Dette angir den brukerdefinerte modulen som skal lastes inn når motoren starter.
Brukes av: AgentControllerConfiguration, PluginConfiguration
Underelementer: Option
Attributter:
- configuration
- navnet på konfigurasjonen som denne tjenesten skal lastes inn for
- name
- navnet på tjenesten
- path
- den fullt kvalifiserte banen til det dynamiske innlastingsbiblioteket
Element: Agent
Dette angir agentspesifikk informasjon.
Brukes av: AgentControllerConfiguration, PluginConfiguration
Underelementer: Option
Attributter:
- configuration
- navnet på konfigurasjonen som denne agentkonfigurasjonen brukes for
- name
- agentnavnet
- type
- agenttypen
- dataChannelSize
- mengden delt minne som skal tildeles til kommunikasjon mellom prosesser
- logFile
- fullt kvalifisert bane til loggfilen som skriver meldingene som sendes av agenten
- client
- oppgi om denne agenten er dynamisk eller hodeløs
Element: Option
Denne brukes til å lagre et navneverdipar.
Brukes av: AgentControllerConfiguration, PluginConfiguration, Service, Agent
Attributter:
- name
- navnet på alternativet (for eksempel navneområde)
- type
- typen alternativ (for eksempel alternativnavn)
- value
- verdien til alternativet
Element: Plugin
Dette angir katalogen der du skal se etter plugin-konfigurasjoner.
Brukes av: AgentControllerConfiguration
Attributter:
pathfullt kvalifisert katalog for å se etter plugin-konfigurasjoner
Element: Variable
Miljøvariabel.
Brukes av: Application, AgentControllerEnvironment
Attributter:
- name
- navnet på miljøvariabelen (for eksempel CLASSPATH)
- value
- verdien til miljøvariabelen
- position
- oppgi om denne verdien skal tilføyes, forhåndstilføyes eller erstatte en eksisterende verdi
Element: Parameter
Programparameter.
Brukes av: Application
Attributter:
- value
- verdien til programparameteren
- position
- oppgi om denne parameteren skal tilføyes, forhåndstilføyes eller erstatte en eksisterende parameter