File di configurazione di Agent Controller

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 per tutte le configurazioni e viene caricata durante l'avvio del servizio 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
filePort
specifica la porta sulla quale è in ascolto il servizio di trasferimento file di Agent Controller. Il valore predefinito è 10005.
isDataMultiplexed
specifica se i dati di creazione profili e di registrazione log devono essere trasmessi attraverso il canale di controllo di Agent Controller. Per impostazione predefinita, il canale dati utilizza una porta arbitraria per la trasmissione dati e può essere bloccato dalla presenza di un firewall. Il trasferimento dei dati mediante il canale di controllo consentirà l'apertura di un insieme di porte predefinite per le richieste di connessione in entrata attraverso un firewall. Tra queste porte vi è la porta predefinita 10002, la porta protetta 10003 e la porta del file server 10005. Il valore predefinito per questo attributo è false.
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 in attesa di una connessione al client non protetta in entrata
processPolling
specifica se il controllo attivo dello stato dei processi è abilitato. Questo attributo viene utilizzato principalmente su sistemi Windows per assicurarsi che ad Agent Controller venga notificato il termine di un processo. Il valore predefinito è true.
securedPort
porta del motore in attesa di una connessione al client protetta in entrata
version
versione del motore

Elemento: PluginConfiguration
È l'elemento principale della configurazione di 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 Come in TPTP 4.0, ai nomi dei plugin è stato aggiunto un identificativo di versione. Consiste in un carattere di sottolineatura seguito dal numero di versione del rilascio. Ad esempio: org.eclipse.tptp.platform.agentcontroller_4.0.0. Per assicurarsi che il plugin sia compatibile per le applicazioni con dipendenze da plugin di versioni precedenti (i plugin che non hanno un suffisso identificativo della versione), è possibile specificare il nome del plugin per l'attributo "requires" escludendo l'identificativo della versione. In questo caso, il caricatore della configurazione di Agent Controller tenterà di individuare il nome del plugin completo incluso il suffisso dell'identificativo della versione. Se l'operazione ha esito negativo, il caricatore della configurazione ricercherà il nome del plugin escludendo il suffisso dell'identificativo della versione. Nel caso in cui ci fossero più plugin con lo stesso nome, verrà utilizzato il primo nome di plugin restituito dal sistema operativo.

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:
configurazione
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:
configurazione
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:
configurazione
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:
configurazione
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:
configurazione
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



(C) Copyright IBM Corporation 2000, 2006. Tutti i diritti riservati.