Sommario
Nota
In questo documento, quando si fa riferimento a percorsi di file o directory, <home-installazione> rappresenta la directory in cui è stato decompresso il pacchetto dell'Agent Controller. This directory is also referred to as %TPTP_AC_HOME% in the configuration files.
Il file serviceconfig.xml viene letto dall'Agent Controller per ottenere le impostazioni configurabili dall'utente. Viene letto una sola volta, all'avvio. Le modifiche a questo file sono generalmente limitate, in quanto qualsiasi modifica ad esso ha effetto su tutti gli utenti.
Il file serviceconfig.xml contiene i seguenti segmenti:
Se è stato definita la variabile di ambiente TPTP_AC_HOME, l'Agent Controller ricerca config/serviceconfig.xml nel percorso definito dalla variabile, altrimenti ricerca nel proprio percorso di installazione. The default location for the serviceconfig.xml file is <install-home>/config/serviceconfig.xml.
Ogni istanza dell'Agent Controller in esecuzione sullo stesso sistema richiede la propria versione del file serviceconfig.xml con configurazioni del livello di trasporto differenti.
Nota
Gli agenti leggono il file serviceconfig.xml anche per ottenere le informazioni dal segmento Connessione, che consentono all'agente di comunicare con un particolare Agent Controller.
Gli agenti leggono la propria riga comandi per ottenere un percorso alternativo in cui trovare il file serviceconfig.xml. The predefined option name for specifying the location is -serviceconfig followed by the pathname of the configuration file. If not specified on the command line, the agent looks for serviceconfig.xml in the same locations as described above for the Agent Controller.
La gerarchia degli elementi contenuti nel file serviceconfig.xml viene mostrata di seguito. L'ordine degli elementi appartenenti allo stesso livello non è rilevante. Si prevede una sola ricorrenza di ciascuno dei livelli principali di elementi (ovvero AgentControllerEnvironment, Logging, Agent, Plugin, ProcessController, Connection, ApplicationAliases, PeerConnectionTransport) is expected. I collegamenti ipertestuali nella gerarchia conducono alla descrizione formale dell'elemento nella sezione Elementi e attributi.
AgentControllerConfiguration
AgentControllerEnvironment
Variable
Logging
Agent
Plugin
ProcessController
Connection
TransportLayer
Configuration
Port
PipeName
MemName
SecuredPort
FilePort
IsDataMultiplexed
ProcessPolling
Jvm
Version
SecurityEnabled
UserDefinition
Keystore
KeystorePassword
Hosts
Allow
Deny
CommandExtractor
ApplicationAliases
Application
Variable
Parameter
PeerConnectionTransport
Elementi secondari: AgentControllerEnvironment
Logging
Agent
Plugin
ProcessController
Connection
ApplicationAliases
PeerConnectionTransport
Elemento: AgentControllerEnvironment
Definisce le impostazioni dell'ambiente globale per tutte le applicazioni e gli agenti avviati attraverso l'Agent Controller. Se
questo elemento è omesso, l'ambiente resta identico a quello dell'Agent Controller stesso. Le variabili qui definite non
hanno effetto sulle impostazioni di ambiente proprie dell'Agent Controller.
Utilizzato da: AgentControllerConfiguration
Elementi secondari: Variable
Elemento: Variable
Questo elemento Variable definisce una variabile di ambiente e la sua posizione nell'ambiente esistente in modo da costituire
l'ambiente predefinito per tutte le applicazioni e gli agenti avviati. Per un elemento AgentControllerEnvironment possono essere
definiti uno o più di questi elementi.
Utilizzato da: AgentControllerEnvironment
Attributi:
- name
- This string value specifies the name of the environment variable.
- value
- This string value specifies the value of the environment variable.
- position
- (optional) This string value is one of "append", "prepend", or "replace", indicating where to place this environment relative to the default environment.
Elemento: Logging
Definisce il livello di severità delle informazioni da registrare nel log, il formato da utilizzare e il percorso. Se questo
elemento è omesso, tutti gli avvisi critici e gravi saranno registrati, utilizzando il formato CBE, nella stessa directory in cui
è in esecuzione l'Agent Controller. Tener presente che il nome del file di log (tptpAgentCtrl.log) non è modificabile,
è configurabile solo il suo percorso.
Utilizzato da: AgentControllerConfiguration
Attributi:
- level
- (optional) This string value indicates the level of severity of messages that should be logged. Ciascun livello include se stesso e tutti gli eventi con maggiore severità. Specify one of the following (listed in order of increasing severity):
DEBUG - includes messages that provide low-level details about the internal flow of code execution of the Agent Controller and agents.- INFORMATION - includes events that are normal but may be of interest to the user of the program.
- WARNING - includes events that are unexpected but shouldn't interfere with program operation.
- CRITICAL - (default) includes events that indicate normal program operation was interrupted by an error.
- SEVERE - is restricted to events that result in program termination.
- format
- (optional) This string value specifies the format to use when writing the messages to the log file. Specify one of the following:
- CBE - (default) messages will be written in Common Base Event format (includes detailed information on the context and origin of the message) suitable for consumption by a CBE log reading utility.
- Simple - messages will be written as simple text.
directory (optional) This string value specifies the location in which the log file will be created. The default is the directory from which the Agent Controller is run.
Elemento: Agent
This required element specifies the directory in which agents that will be known
to the Agent Controller will have placed subdirectories that identify the agent
by name and contain an agent.xml configuration file with information on how to
launch and manage the agent.
Utilizzato da: AgentControllerConfiguration
Attributi:
- path
- This string value specifies the full pathname of the directory in which to look for agent configurations.
Elemento: Plugin
This element specifies the directory in which extensions to the Agent Controller
configuration will have been placed. The extensions are defined in
pluginconfig.xml configuration files. The subdirectories under the
specified directory may also contain extension-specific executable files.
Elemento: ProcessControllerUtilizzato da: AgentControllerConfiguration
Attributi:
- path
- This string value specifies the full pathname of the directory in which to look for extensions.
Elemento: ConnectionUtilizzato da: AgentControllerConfiguration
Utilizzato da: AgentControllerEnvironment
Elementi secondari: TransportLayer
Attributi:
- name
- This string value provides a name for the connection configuration.
values are custom transports that provide backward compatability for clients and agents using the original Agent Controller interfaces.Utilizzato da: Connection
Elementi secondari: Configuration
CommandExtractor
Attributi:
- loadlib
- This string value specifies the name of the library to be loaded for this transport layer, without its suffix (i.e., do not include .dll or .so). Viene utilizzata la normale ricerca di percorsi di sistema per individuare la libreria.
- tipo
- This string value provides the specific identity of this transport layer. The possible values are: TPTP_SOCKET, TPTP_NAMEDPIPE, TPTP_SHAREDMEM, TPTP_CCTL and TPTP_ACTL. Custom transport layers will use other identifiers. The TPTP_CCTL and TPTP_ACTL
Elemento: Configuration
L'elemento Configuration contiene un elemento secondario che specifica il meccanismo di comunicazione tra i processi per ciascun TransportLayer. The communication mechanisms
provided for here are socket, named-pipe, shared memory and CCTL. The ACTL
transport layer has no configuration elements. Custom TransportLayers might have
other configuration elements that are specific to those transport layers.
Utilizzato da: TransportLayer
Sub-elements: Port (only with socketTL and CCTL)
PipeName (only with namedPipeTL)
MemName (only with sharedMemTL)
SecuredPort (only with CCTL)
FilePort (only with CCTL)
IsDataMultiplexed (only with CCTL)
ProcessPolling (only with CCTL)
Jvm (only with CCTL)
Version (only with CCTL)
SecurityEnabled (only with CCTL)
UserDefinition (only with CCTL and only if security is enabled)
Keystore (only with CCTL and only if security is enabled)
KeystorePassword (only with CCTL and only if security is enabled)
Hosts (only with CCTL)
Elemento: Port
The Port element specifies the port to be used for socket communication.
The Port element is only valid when used with the
TPTP_SOCKET and TPTP_CCTL transport layers. Il suo valore intero specifica il numero di porta reale da utilizzare nella creazione delle connessione socket.
Utilizzato da: Configuration
Elemento: PipeName
L'elemento PipeName indica il livello di trasporto per la comunicazione named-pipe. L'elemento PipeName è valido solo se
utilizzato con la loadlib namedPipeTL. Il suo valore stringa specifica il named-pipe da
utilizzare nella creazione della connessione.
Utilizzato da: Configuration
Elemento: MemName
L'elemento MemName indica il livello di trasporto per la comunicazione memoria condivisa. L'elemento MemName è valido solo se
utilizzato con la loadlib sharedMemTL. Il suo valore stringa specifica il nome della
risorsa di memoria condivisa da utilizzare nella creazione della connessione.
Utilizzato da: Configuration
Element: SecuredPort
The SecuredPort element specifies the port to be used for secure socket communication.
The SecuredPort element is only valid when used with the
TPTP_CCTL transport layer. Its integer
value specifies the actual port number to use in making the secure socket connection.
Utilizzato da: Configuration
Element: FilePort
The FilePort element specifies the transport layer used for socket communication
by the File Transfer service.
The FilePort element is only valid when used with the
TPTP_CCTL transport layer. Il suo valore intero specifica il numero di porta reale da utilizzare nella creazione delle connessione socket.
Utilizzato da: Configuration
Element: IsDataMultiplexed
The IsDataMultiplexed element specifies whether profiling and logging data
should be transmitted over the control channel of the 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. This element takes a
Boolean value that defaults to "FALSE". The IsDataMultiplexed element is only valid when
used with the
TPTP_CCTL transport layer.
Utilizzato da: Configuration
Element: ProcessPolling
The ProcessPolling element specifies whether or not active checking of process
status is enabled. This attribute is used to make sure the Agent Controller
detects when a process has terminated. This element takes a Boolean value that
defaults to "TRUE". The
ProcessPolling element is only valid when used with the
TPTP_CCTL transport layer.
Utilizzato da: Configuration
Element: Jvm
The Jvm element specifies the fully qualified path of the Java Virtual Machine
dynamic runtime library (jvm.dll or libjvm.so) to be used by the File Transfer
and secure connection components. The Jvm element is only valid when used with
the
TPTP_CCTL transport layer.
Utilizzato da: Configuration
Element: Version
The Version element describes the version number of the Agent Controller that
will be reported to other components. The Version element is only valid when used
with the
TPTP_CCTL transport layer.
Utilizzato da: Configuration
Element: SecurityEnabled
The SecurityEnabled element indicates whether or not clients connecting to this
transport layer must connect to the secure port. If security is enabled
and a client attempts to connect to the non-secure port, the client will be
given the address of the secure port and the connection will be refused.
This element takes a Boolean value that defaults to "FALSE". The
SecurityEnabled element is only valid when used with the
TPTP_CCTL transport layer.
Utilizzato da: Configuration
Element: UserDefinition
The UserDefinition element describes which users may connect to this transport
layer. If this element is set to "ANY", all users which can be
authenticated with the OS will be allowed to connect. If security is
enabled, this element is required. This element takes a string value consisting
of a comma separated list of user names. The UserDefinition element is only valid when
used with the
TPTP_CCTL transport layer.
Utilizzato da: Configuration
Element: Keystore
The Keystore element specifies the location of the keystore for secure
connections. If security is enabled, this element is required. The
Keystore element is only valid when used with the
TPTP_CCTL transport layer.
Utilizzato da: Configuration
Element: KeystorePassword
The KeystorePassword element sets the password to be used with the keystore for
secure connections. If security is enabled, this element is required. The
KeystorePassword element is only valid when used with the
TPTP_CCTL transport layer.
Utilizzato da: Configuration
Elemento: Hosts
The Hosts element is used to control which hosts are allowed to
connect through this transport layer. This element consists of one or more Allow
or Deny elements. The Hosts element is only valid when used
with the
TPTP_CCTL transport layer.
Utilizzato da: Configuration
Elemento: Allow
The Allow element specifies a Host that is allowed to connect to the Agent
Controller through this transport layer.
Utilizzato da: Hosts
Attributi:
- host
- This string is the name or IP address of the host. A value of "ALL" indicates that this transport layer may accept connections from any host. A value of "LOCAL" indicates that connections should be accepted from local processes.
- net
- This attribute indicates a subnet from which to allow connections.
- mask
- This attribute indicates a subnet mask to use to allow connections.
Elemento: Deny
The Deny element specifies a Host that is not allowed to connect to the Agent
Controller through this transport layer.
Utilizzato da: Hosts
Attributi:
- host
- This string is the name or IP address of the host to deny.
- net
- This attribute indicates a subnet from which to deny connections.
- mask
- This attribute indicates a subnet mask to use to deny connections.
Elemento: CommandExtractor
Questo elemento definisce un estrattore di comandi, un componente collegabile in un livello di trasporto che estrae i
comandi dal flusso di comunicazione tra i processi. Il suo valore stringa specifica il nome della libreria da caricare privo di
suffisso (non include .dll o .so) o prefisso ("lib" per Linux).
Viene utilizzata la normale ricerca di percorsi di sistema per individuare la libreria.
Utilizzato da: TransportLayer
Elemento: ApplicationAliases
L'elemento ApplicationAliases è un elenco facoltativo di definizioni di alias di applicazioni.
Utilizzato da: AgentControllerConfiguration
Elementi secondari: Application
Attributi:
- launchAliasesOnly
- (facoltativo) Questo attributo stringa può essere "true" o "false" (impostazione predefinita). Se impostato su "true", saranno avviate solo le applicazioni che sono state definite in questo elemento. Se l'attributo è impostato su "false" o se omesso, può essere avviata qualsiasi applicazione.
Elemento: Application
L'elemento Application definisce un nome alias e le informazioni di avvio per un'applicazione.
Utilizzato da: ApplicationAliases
Elementi secondari: Variable
Parameter
Attributi:
- executable
- This string value specifies the alias name for the application executable specified in the path attribute.
- location
- (optional) This string value specifies the directory from which the executable is to be launched, sometimes referred to as the working directory for the executable while it is running.
- path
- This string value specifies the full pathname of the application to launch. Viene utilizzato al posto del nome alias quando si avvia l'eseguibile dell'applicazione.
Elemento: Variable
Questo elemento Variable definisce una variabile di ambiente e la sua posizione nell'ambiente esistente quando si avvia
l'applicazione.
Per un elemento
Application possono essere definiti uno o più di questi elementi.
Utilizzato da: Application
Attributi:
- name
- This string value specifies the name of the environment variable.
- value
- This string value specifies the value of the environment variable.
- position
- (optional) This string value is one of >"append", "prepend", or "replace", indicating where to place this environment relative to the default environment.
Elemento: Parameter
L'elemento Parameter definisce un argomento di riga comandi da fornire all'applicazione quando viene avviata. Per un elemento
Application possono essere definiti uno o più di questi elementi.
Utilizzato da: Application
Attributi:
- value
- This string value specifies a command line argument.
- position
- (optional) This string value is one of "append", "prepend", or "replace" indicating where to place this argument relative to the existing command line arguments.
Element: PeerConnectionTransport
This required element specifies the transport layer which will be used to
establish connections between the Agent Controller reading this configuration
and peer Agent Controller instances. The value name of this element must
match a Transport Layer type name for a specific transport layer declared in the Connection section
of the configuration file (e.g. TPTP_CCTL).
Utilizzato da: AgentControllerConfiguration
Questo è un esempio di file di configurazione di Agent Controller:
<?xml version="1.0" encoding="UTF-8"?>
<AgentControllerConfiguration>
<AgentControllerEnvironment configuration="default">
<Variable name="JAVA_PATH"
value="C:\Program Files\Java\j2re1.4.2_08\bin\java.exe" position="replace"/>
<Variable name="RASERVER_HOME"
value="C:\Eclipse\Projects\AgentController" position="replace"/>
<Variable name="TPTP_AC_HOME"
value="%RASERVER_HOME%" position="replace"/>
<Variable name="PLUGINS_HOME"
value="%RASERVER_HOME%\plugins" position="replace"/>
<Variable name="PATH" value="%RASERVER_HOME%\bin"
position="prepend"/>
</AgentControllerEnvironment>
<ApplicationAliases>
<Application configuration="default"
executable="java.exe" path="%JAVA_PATH%" location="%SYS_TEMP_DIR%">
<Variable
name="CLASSPATH" value="%CLASSPATH_ORG_ECLIPSE_EQUINOX_COMMON%"
position="append"/>
<Variable
name="PATH" value="%RASERVER_HOME%\bin" position="prepend"/>
</Application>
</ApplicationAliases>
<Plugin path="%PLUGINS_HOME%"/>
<Agent path="%TPTP_AC_HOME%\agents"/>
<Logging level="INFORMATION" format="CBE" directory="%TPTP_AC_HOME%\config"/>
<ProcessController>%TPTP_AC_HOME%\bin\tptpProcessController.exe</ProcessController>
<Connection name="Dev">
<TransportLayer loadlib="socketTL"
type="TPTP_SOCKET">
<Configuration>
<Port>10006</Port>
</Configuration>
<CommandExtractor>tptpCmdExtr</CommandExtractor>
</TransportLayer>
<TransportLayer loadlib="namedPipeTL"
type="TPTP_LOG">
<Configuration>
<PipeName>acmasterlog</PipeName>
</Configuration>
<CommandExtractor>tptpCmdExtr</CommandExtractor>
</TransportLayer>
<TransportLayer loadlib="namedPipeTL"
type="TPTP_NAMEDPIPE">
<Configuration>
<PipeName>acmaster</PipeName>
</Configuration>
<CommandExtractor>tptpCmdExtr</CommandExtractor>
</TransportLayer>
<TransportLayer loadlib="sharedMemTL"
type="TPTP_SHAREDMEM">
<Configuration>
<MemName>acbuffer</MemName>
</Configuration>
<CommandExtractor>tptpCmdExtr</CommandExtractor>
</TransportLayer>
<TransportLayer loadlib="tptpCCTL"
type="TPTP_CCTL">
<Configuration>
<Port>10002</Port>
<SecuredPort>10003</SecuredPort>
<FilePort>10005</FilePort>
<IsDataMultiplexed>false</IsDataMultiplexed>
<ProcessPolling>true</ProcessPolling>
<Jvm>C:\Program Files\Java\j2re1.4.2_08\bin\client\jvm.dll</Jvm>
<Version>4.2.0</Version>
<SecurityEnabled>true</SecurityEnabled>
<UserDefinition>ANY</UserDefinition>
<Keystore>C:\Eclipse\Projects\AgentController\security\tptpSampleKeystore</Keystore>
<KeystorePassword>password</KeystorePassword>
<Hosts configuration="default">
<Allow host="LOCAL"/>
</Hosts>
</Configuration>
<CommandExtractor>tptpCmdExtr</CommandExtractor>
</TransportLayer>
<TransportLayer loadlib="tptpACTL"
type="TPTP_ACTL">
<Configuration/>
<CommandExtractor>tptpCmdExtr</CommandExtractor>
</TransportLayer>
</Connection>
<PeerConnectionTransport>TPTP_CCTL</PeerConnectionTransport>
</AgentControllerConfiguration>
Copyright (C) 2005, 2006 Intel Corporation.