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:
configuration
navnet 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:
path
fullt 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



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