Konfigurationsfiler til Agent Controller

Agent Controller-konfigurationen er angivet af to sæt konfigurationsfiler. Det første sæt er basiskonfigurationen, som beskriver programmets standardindstillinger. Det andet sæt er plugin-konfigurationen, som beskriver de programspecifikke indstillinger. Dette dokument beskriver detaljerne i de enkelte konfigurationer, og hvordan du skriver konfigurationsudvidelserne.

Biblioteket <installationsbibliotek>, der refereres til i dette dokument, svarer til den sti, hvor Agent Controller pakkes ud. Dette bibliotek kaldes også %RASERVER_HOME% i konfigurationsfilerne.

Basiskonfiguration

Basiskonfigurationen består af filen <installationsbibliotek>/config/serviceconfig.xml, som er konstrueret vha. XML-skemaet <installationsbibliotek>/config/serviceconfig.xsd. Dette angiver standardindstillingerne, f.eks. miljøvariabler, programkonfigurationer og forbindelsesindstillinger for Agent Controller. Basiskonfigurationen vil være tilgængelig for alle konfigurationer og indlæses, når programservicen startes. Programudviklere bør ikke ændre denne basiskonfigurationsfil, da ændringer i basiskonfigurationsfilen bliver globale. Plugin-konfigurationer (beskrevet nedenfor) skal bruges til at angive plugin- og programspecifikke indstillinger.

Plugin-konfiguration

Alle brugerdefinerede programmer skal have deres konfigurationsfiler og afhængigheder placeret under plugin-biblioteket <installationsbibliotek>/plugin/<plugin-navn>, hvor <plugin-navn> er et entydigt navn, som identificerer programmet. Plugin-konfigurationsfilen pluginconfig.xml skal være placeret under underbiblioteket config i plugin-biblioteket. Typisk er JAR-filer placeret under underbiblioteket lib i plugin-biblioteket. Udviklere kan bruge XML-skemaet <installationsbibliotek>/config/pluginconfig.xsd som en hjælp ved konstruktionen af plugin-konfigurationsfilen.

Elementer og attributter

Element: AgentControllerConfiguration
Dette er rodelementet til basiskonfigurationen. Indstillingerne bruges til start af programservicen.

Bruges af: Basiskonfiguration

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

Attributter:
activeConfiguration
Angiv, hvilken konfiguration der indlæses ved programstart.
filePort
Angiv den port, som filoverførselsservicen i Agent Controller lytter til. Standardværdien er 10005.
isDataMultiplexed
Angiv, om profilering og logning af data skal overføres over kontrolkanalen i Agent Controller. Som standard bruger datakanalen en vilkårlig port til dataoverførsel, og den kan blive blokeret, hvis der findes en firewall. Hvis data overføres over kontrolkanalen, bliver det muligt for et sæt foruddefinerede porte at blive åbnet for indgående forbindelsesanmodninger gennem en firewall. Disse porte inkluderer standardport 10002, sikkerhedsport 10003 og filserverport 10005. Standardværdien for denne attribut er false.
jvm
Fuldstændig sti til det dynamiske Java Virtual Machine-runtimebibliotek (jvm.dll eller libjvm.so)
loggingDetail
Aktivér logning af linjenummer for programmet, hvis HIGH er angivet.
loggingDirectory
Bibliotek, hvor programmets logfil servicelog.log oprettes.
loggingLevel
Niveaufilter for logmeddelelser.
port
Programport til aflytning af indgående ikke-sikret klientforbindelse.
processPolling
Angiv, om aktiv kontrol af processtatus aktiveres eller ej. Denne attribut bruges til at begynde med på Windows-systemer til at sikre, at Agent Controller får besked, når en proces er afsluttet. Standardværdien er true.
securedPort
Programport til aflytning af indgående sikret klientforbindelse.
version
Programmets version.

Element: PluginConfiguration
Dette er rodelementet til plugin-konfigurationen. Indstillingerne indlæses, efter at basiskonfigurationen er indlæst.

Bruges af: Plugin-konfiguration

Underelementer: AgentControllerEnvironment, Application, Service, Agent, Option

Attributter:
requires
En kommasepareret liste over plugin-navne, som denne konfiguration er afhængig af. Fra og med TPTP 4.0 er der tilføjet en versions-id efter plugin-navnene. Den består af et understregningstegn, efterfulgt af versionsnummeret for den pågældende release. Eksempel: org.eclipse.tptp.platform.agentcontroller_4.0.0. For at sikre plugin-kompatibilitet for programmer, der har afhængigheder på plugins fra tidligere releases (plugins, der ikke har en efterstillet versions-id), har du mulighed for at angive plugin-navnet for attributten "requires", uden versions-id. I så fald forsøger funktionen til indlæsning af konfigurationen i Agent Controller først at finde det fulde plugin-navn, inklusive versions-id. Hvis det ikke lykkes, søger funktionen efter plugin-navnet uden versions-id. Hvis der er flere plugins med samme navn, anvendes det første plugin-navn, som styresystemet returnerer.

Element: AgentControllerEnvironment
Dette er en pladsholder for globale miljøvariabler, som denne konfiguration tilfører. Disse publiceres til systemet og er tilgængelige for alle andre konfigurationer inklusive basiskonfigurationen.

Bruges af: AgentControllerConfiguration, PluginConfiguration

Underelementer: Variable

Attributter:
configuration
Navnet på den konfiguration, hvor miljøvariablerne skal tilføjes.

Element: Application
Dette er en pladsholder for programspecifikt miljø. Indstillingerne er kun synlige for dette bestemte program.

Bruges af: AgentControllerConfiguration, PluginConfiguration

Underelementer: Variable, Parameter

Attributter:
configuration
Navnet på den konfiguration, hvor programmet skal tilføjes.
executable
Navnet på programmet. Klienter skal bruge dette navn til at identificere programmet.
path
Den faktiske, fuldstændige sti til det program, som dette program skal udføre.
location
Dette programs arbejdsbibliotek.
extends
Det konfigurationsnavn, som samme program allerede er defineret under. De aktuelle indstillinger tilføjes øverst.

Element: Hosts
Dette er en pladsholder for værtsoplysninger. Dette bruges af programmet til at tillade/ophæve bestemte værters tilladelse til at oprette forbindelse.

Bruges af: AgentControllerConfiguration

Underelementer: Allow, Deny

Attributter:
configuration
Navnet på den konfiguration, hvor disse værtsoplysninger bruges.

Element: Allow
Dette angiver, hvilke værter der har tilladelse til at oprette forbindelse til programmet.

Bruges af: Hosts

Attributter:
host
Værtens navn eller IP-adresse.
net
undernet
mask
undernetmaske
Element: Deny
Dette angiver, hvilke værter der ikke længere har tilladelse til at oprette forbindelse til programmet.

Bruges af: Hosts

Attributter:
host
Værtens navn eller IP-adresse.
net
undernet
mask
undernetmaske

Element: Service
Dette angiver, hvilket brugerdefineret modul der skal indlæses ved programstart.

Bruges af: AgentControllerConfiguration, PluginConfiguration

Underelementer: Option

Attributter:
configuration
Navnet på den konfiguration, hvor denne service skal indlæses.
name
Navnet på servicen.
path
Den fuldstændige sti til det dynamiske indlæsningsbibliotek.


Element: Agent
Dette angiver agentspecifikke oplysninger.

Bruges af: AgentControllerConfiguration, PluginConfiguration

Underelementer: Option

Attributter:
configuration
Navnet på den konfiguration, hvor denne agentkonfiguration bruges.
name
Navnet på agenten.
type
Agentens type.
dataChannelSize
Den del af den fælles hukommelse, som skal allokeres til kommunikation mellem interne processer.
logFile
Den fuldstændige sti til den logfil, hvor de meddelelser, der sendes af agenten, skrives.
client
Angiv, om denne agent er dynamisk eller hovedløs.
Element: Option
Dette bruges til at gemme et navne-/værdipar. Bruges af: AgentControllerConfiguration, PluginConfiguration, Service, Agent Attributter:
name
Navnet på indstillingen (dvs. navneområde).
type
Indstillingens type (dvs. indstillingsnavn).
value
Indstillingens værdi.


Element: Plugin
Dette angiver det bibliotek, hvor plugin-konfigurationerne skal findes.

Bruges af: AgentControllerConfiguration

Attributter:
path
Det fuldstændige bibliotek, hvor plugin-konfigurationerne skal findes.

Element: Variable
Miljøvariabel.

Bruges af: Application, AgentControllerEnvironment

Attributter:
name
Navnet på miljøvariablen (f.eks. CLASSPATH).
value
Værdien af miljøvariablen.
position
Angiv, om denne værdi skal tilføjes efter, tilføjes før eller erstatte den eksisterende værdi.
Element: Parameter
Programparameter.

Bruges af: Application

Attributter:
value
Værdien af programparameteren.
position
Angiver, om denne værdi skal tilføjes efter, tilføjes før eller erstatte den eksisterende værdi.



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