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:
configurationNavnet 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:
pathDet 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.