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:
configurazionenome 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:
pathdirectory 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