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 su cui è in ascolto il servizio di trasferimento file di Agent Controller. Il valore predefinito è 10005.
isDataMultiplexed
specifica la necessità di trasmettere i dati di profilo e di registrazione sul canale di controllo di Agent Controller. Per impostazione predefinita, il canale dei dati utilizza una porta arbitraria per la trasmissione dei dati e può essere bloccato dalla presenza di un firewall. Il trasferimento dei dati sul canale di controllo permetterà a un insieme di porte predefinite di essere aperte per le richieste di connessione in entrata attraverso un firewall. Queste porte comprendono la porta predefinita 10002, la porta sicura 1003 e la porta 10005 del server di file. 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 attivare o meno la verifica se lo stato del processo è abilitato. Questo attributo viene utilizzato principalmente su sistemi Windows per assicurare che avvenga la notifica all'Agent Controller ogni volta che un processo è terminato. 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
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
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:
name
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:
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, 2005. Tutti i diritti riservati.