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 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
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 da 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 1003 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 per ascoltare la 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 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:
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
percorso
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
nome
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
nome
nome dell'agente
Tipo
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:
nome
nome dell'opzione (ad es. spazio nome)
Tipo
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:
nome
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, 2005. Tutti di diritti riservati.