File di configurazione di Agent Controller

Contenuto

Introduzione
Configurazione di base
Configurazione plugin
Elementi e attributi

Introduzione

La configurazione di Agent Controller viene specificata da due insiemi di file di configurazione. Il primo rappresenta la configurazione di base che descrive le impostazioni predefinite del motore. Il secondo rappresenta la configurazione plugin che descrive le impostazioni specifiche dell'applicazione del motore. Questo documento descrive i dettagli di ciascuna configurazione e come scrivere le estensioni delle configurazioni.

La directory <install directory> indicata in questo documento corrisponde al percorso in cui Agent Controller viene estratto dal pacchetto. Questa directory viene anche indicata come %RASERVER_HOME% nei file di configurazione.

Configurazione di base

La configurazione di base è composta dal file <install directory>/config/serviceconfig.xml, che viene generato utilizzando lo schema XML <install directory>/config/serviceconfig.xsd. Questo specifica le impostazioni predefinite quale le variabili di ambiente del sistema, le configurazioni delle applicazioni e la connettività di Agent Controller. La configurazione di base sarà disponibile a tutte le configurazioni e viene caricata durante l'avvio del motore. Gli sviluppatori delle applicazioni non devono modificare questo file di configurazione di base poiché qualsiasi modifica applicata a questo file sarà globale. Le configurazioni plugin (descritte di seguito) devono essere utilizzate per specificare le impostazioni specifiche delle applicazioni e del plugin.

Configurazione plugin

Ciascuna applicazione definita dall'utente deve avere il proprio file di configurazione e le proprie dipendenze nella directory plugin <install directory>/plugin/<plugin name> dove <plugin name> è un nome univoco che identifica l'applicazione. Il file di configurazione plugin pluginconfig.xml deve trovarsi nella sottodirectory config della directory plugin. Di norma, i file JAR si trovano nella sottodirectory lib della directory plugin. Gli sviluppatori possono utilizzare lo schema XML <install directory>/config/pluginconfig.xsd per la creazione del file di configurazione plugin.

Elementi e attributi

Elemento: AgentControllerConfiguration
È l'elemento principale della configurazione di base. Le impostazioni vengono utilizzate per avviare il servizio motore.

Utilizzato da: Configurazione di base

Elementi secondari: AgentControllerEnvironment, Application, Hosts, Service, Agent, Option, Plugin

Attributi:

activeConfiguration: specifica la configurazione da caricare durante l'avvio del motore
jvm: percorso completo della libreria di runtime dinamica JVM (Java Virtual Machine), jvm.dll o libjvm.so
loggingDetail: abilita la registrazione log dei numeri riga del motore se è specificato il valore HIGH
loggingDirectory: directory in cui viene creato il file di log servicelog.log
loggingLevel: filtro di gravità per i messaggi di log
port: porta del motore per ascoltare la connessione al client non protetta in entrata
securedPort: porta del motore per ascoltare la connessione al client protetta in entrata
version: versione del motore

Elemento: PluginConfiguration
È l'elemento principale della configurazione plugin. Le impostazioni vengono caricate in seguito al caricamento della configurazione di base.

Utilizzato da: Configurazione plugin

Elementi secondari: AgentControllerEnvironment, Application, Service, Agent, Option

Attributi:

requires: un elenco separato da virgole di nomi plugin da cui dipende la configurazione

Elemento: AgentControllerEnvironment
È il segnaposto per le variabili di ambiente globali fornite da questa configurazione. Queste variabili sono pubblicate sul sistema e disponibili per tutte le configurazioni, compresa la configurazione di base.

Utilizzato da: AgentControllerConfiguration, PluginConfiguration

Elementi secondari: Variable

Attributi:

configuration: nome della configurazione in cui aggiungere le variabili di ambiente

Elemento: Application
È un segnaposto per l'ambiente specifico dell'applicazione. Le impostazioni sono visibili solo a questa determinata applicazione.

Utilizzato da: AgentControllerConfiguration, PluginConfiguration

Elementi secondari: Variable, Parameter

Attributi:

configuration: nome della configurazione in cui aggiungere l'applicazione
executable: nome dell'applicazione che i client devono utilizzare per identificarla
path: il percorso reale e completo del programma che questa applicazione deve eseguire
location: directory attiva di questa applicazione
extends: il nome della configurazione in cui è stata già definita la stessa applicazione e che aggiungerà le impostazioni correnti in cima

Elemento: Hosts
È un segnaposto per le informazioni sugli host. Viene utilizzato dal motore per consentire / impedire ad alcuni host di connettersi.

Utilizzato da: AgentControllerConfiguration

Elementi secondari: Allow, Deny

Attributi:
configuration

nome della configurazione in cui vengono utilizzate le informazioni sugli host

Elemento: Allow
Specifica gli host ai quali è consentito connettersi al motore.

Utilizzato da: Hosts

Attributi:

host: nome o indirizzo IP dell'host
net: rete secondaria
mask: maschera della rete secondaria

Elemento: Deny
Specifica gli host ai quali non è consentito connettersi al motore.

Utilizzato da: Hosts

Attributi:

host: nome o indirizzo IP dell'host
net: rete secondaria
mask: maschera della rete secondaria

Elemento: Service
Specifica il modulo definito dall'utente da caricare durante l'avvio del motore.

Utilizzato da: AgentControllerConfiguration, PluginConfiguration

Elementi secondari: Option

Attributi:

configuration: nome della configurazione in cui questo servizio deve essere caricato
name: nome del servizio
path: percorso completo della libreria di caricamento dinamica

Elemento: Agent
Specifica le informazioni specifiche dell'agente.

Utilizzato da: AgentControllerConfiguration, PluginConfiguration

Elementi secondari: Option

Attributi:

configuration: nome della configurazione in cui viene utilizzata questa configurazione dell'agente
name: nome dell'agente
type: tipo dell'agente
dataChannelSize: quantità di memoria condivisa da assegnare per la comunicazione tra i processi
logFile: percorso completo per il file di log che scrive i messaggi inviati dall'agente
client: specifica se questo agente è dinamico o headless

Elemento: Option
Viene utilizzato per memorizzare una coppia nome-valore. Utilizzato da: AgentControllerConfiguration, PluginConfiguration, Service, Agent Attributi:

name: nome dell'opzione (ad es. spazio nome)
type: tipo dell'opzione (ad es. nome opzione)
value: valore dell'opzione

Elemento: Plugin
Specifica la directory in cui cercare le configurazioni plugin

Utilizzato da: AgentControllerConfiguration

Attributi:
path

directory completa in cui cercare le configurazioni plugin

Elemento: Variable
Variabile di ambiente.

Utilizzato da: Application, AgentControllerEnvironment

Attributi:

name: nome della variabile di ambiente (ad es. CLASSPATH)
value: valore della variabile di ambiente
position: specifica se questo valore deve essere aggiunto, preceduto o sostituisce il valore esistente

Elemento: Parameter
Parametro del programma.

Utilizzato da: Application

Attributi:

value: valore del parametro del programma
position: specifica se questo parametro deve essere aggiunto, preceduto o sostituisce il parametro esistente