Archivos de configuración de Agent Controller
La configuración de Agent Controller se especifica mediante dos conjuntos de archivos de configuración.
El primer conjunto es la configuración base que describe los valores por omisión del motor.
El segundo conjunto es la configuración del plug-in que describe los valores específicos de la
aplicación del motor.
En este documento se describe detalladamente cada configuración y se muestra cómo escribir
extensiones de configuración.
El directorio <directorio de instalación> al que se hace referencia en este
documento corresponde a la vía de acceso en la que se desempaqueta Agent Controller. En los
archivos de configuración también se hace referencia a este directorio como
%RASERVER_HOME%.
Configuración base
La configuración base consta del archivo <directorio de
instalación>/config/serviceconfig.xml que se construye utilizando el esquema XML
<directorio de instalación>/config/serviceconfig.xsd.
Esto especifica los valores por omisión como por ejemplo variables de entorno del sistema,
configuraciones de aplicación y conectividad de Agent Controller. La configuración base estará disponible para todas
las configuraciones y se carga cuando se inicia el servicio motor. Los
desarrolladores de aplicaciones no deben modificar este archivo de configuración base puesto que
los cambios realizados en la configuración base serán globales. Las configuraciones de plug-in
(descritas más abajo) deben utilizarse para especificar valores de plug-in y específicos de la
aplicación.
Configuración del plug-in
Cada aplicación definida por el usuario debe tener ubicado su archivo de configuración y elementos dependientes en el
directorio del plug-in <directorio de instalación>/plugin/<nombre de plug-in> donde
<nombre de plug-in> es un nombre exclusivo que identifica la aplicación. El archivo de configuración del plug-in pluginconfig.xml debe
situarse bajo el subdirectorio config del directorio del plug-in.
Normalmente, los archivos JAR se sitúan en el subdirectorio lib del directorio del
plug-in.
Los desarrolladores pueden utilizar el esquema XML <directorio de
instalación>/config/pluginconfig.xsd para ayudar a construir el archivo de configuración
del plug-in.
Elementos y atributos
Elemento: AgentControllerConfiguration
Este es el elemento raíz de la configuración base. Los valores se utilizan para iniciar el servicio motor.
Utilizado por: Configuración base
Subelementos: AgentControllerEnvironment, Application, Hosts, Service, Agent, Option, Plugin
Atributos:
- activeConfiguration
- especificar qué configuración debe cargarse al iniciar el motor
- filePort
- especificar el puerto en el que el servicio de transferencia de archivos de
Agent Controller está a la escucha. El valor predeterminado es 10005.
- isDataMultiplexed
- especificar si los datos de perfilado y registro cronológico deben
transmitirse a través del canal de control de Agent Controller. De forma predeterminada, el canal de datos utiliza un
puerto arbitrario para la transmisión de datos y puede quedar bloqueado por la existencia de un cortafuegos. La
transferencia de los datos a través del canal de control permitirá abrir un conjunto de puertos predefinidos para las
peticiones entrantes a través de un cortafuegos. Entre estos puertos están el puerto predeterminado 10002, el puerto seguro 10003
y el puerto de servidor de archivos 10005. El valor predeterminado para este atributo es false.
- jvm
- vía de acceso totalmente calificada de la biblioteca de tiempo de ejecución dinámica de la máquina virtual Java (jvm.dll o libjvm.so)
- loggingDetail
- habilitar la anotación del número de línea del motor si se especifica HIGH
- loggingDirectory
- directorio en el que se crea el archivo de anotaciones del motor servicelog.log
- loggingLevel
- filtro de gravedad para los mensajes de anotaciones
- port
- puerto de motor para escuchar conexiones de cliente no protegidas entrantes
- processPolling
- especificar si la comprobación activa del estado del proceso está
habilitada. Este atributo se utiliza principalmente en los sistemas Windows para asegurarse de que
Agent Controller recibe una notificación cada vez que finaliza un proceso. El valor predeterminado es true.
- securedPort
- puerto de motor para escuchar conexiones de cliente protegidas entrantes
- version
- versión del motor
Elemento: PluginConfiguration
Es el elemento raíz de la configuración del plug-in. Los valores se cargan después de cargar la configuración base.
Utilizado por: Configuración del plug-in
Subelementos: AgentControllerEnvironment, Application, Service, Agent, Option
Atributos:
- requires
- una lista separada por comas de los nombres de plug-in de los que depende esta configuración. A
partir de TPTP 4.0, se ha añadido un sufijo identificador de versión a los nombres de plug-in. Consta de un carácter subrayado seguido del número de versión para el release. Por ejemplo: org.eclipse.tptp.platform.agentcontroller_4.0.0.
Para asegurar la compatibilidad de plug-ins para aplicaciones que tienen dependencias sobre plug-ins de releases
anteriores (plug-ins que no tienen un sufijo identificador de versión), tiene la opción de especificar el nombre de
plug-in para el atributo "requires" excluyendo el identificador de versión. En este caso, el cargador de
configuración de Agent Controller intentará localizar primero el nombre de plug-in completo incluyendo el sufijo
identificador de versión.
Si no lo consigue, el cargador de configuración buscará el nombre de plug-in excluyendo el sufijo identificador de
versión. Si hay más de un plug-in con el mismo nombre, se utilizará el primer nombre de plug-in devuelto por el sistema
operativo.
Elemento: AgentControllerEnvironment
Es un sustituto para las variables de entorno globales a las que contribuye esta configuración.
Estas variables están publicadas en el sistema y disponibles para el resto de configuraciones,
incluyendo la configuración base.
Utilizado por: AgentControllerConfiguration, PluginConfiguration
Subelementos: Variable
Atributos:
- configuration
- nombre de la configuración a la que deben añadirse las variables de entorno
Elemento: Application
Es un sustituto para un entorno específico de la aplicación. Los valores que alberga solo son
visibles para esta aplicación en concreto.
Utilizado por: AgentControllerConfiguration, PluginConfiguration
Subelementos: Variable, Parameter
Atributos:
- configuration
- nombre de la configuración a la que debe añadirse la aplicación
- executable
- nombre de la aplicación, los clientes deben utilizar este nombre para identificar esta aplicación
- path
- la vía de acceso real, totalmente calificada del programa que debe ejecutar esta aplicación
- location
- directorio de trabajo de esta aplicación
- extends
- el nombre de configuración que ya ha definido la misma aplicación, esto añadirá los valores actuales encima
Elemento: Hosts
Es un sustituto para la información de host. Lo utiliza el motor para permitir / no
permitir la conexión de determinados hosts.
Utilizado por: AgentControllerConfiguration
Subelementos: Allow, Deny
Atributos:
configurationnombre de la configuración que utiliza esta información de host
Elemento: Allow
Esto especifica qué hosts pueden conectar con el motor.
Utilizado por: Hosts
Atributos:
- host
- nombre o dirección IP del host
- net
- subred
- mask
- máscara de subred
Elemento: Deny
Esto especifica qué hosts no pueden conectar con el motor.
Utilizado por: Hosts
Atributos:
- host
- nombre o dirección IP del host
- net
- subred
- mask
- máscara de subred
Elemento: Service
Esto especifica qué módulo definido por el usuario debe cargarse al iniciar el motor.
Utilizado por: AgentControllerConfiguration, PluginConfiguration
Subelementos: Option
Atributos:
- configuration
- nombre de la configuración que debe cargar este servicio
- name
- nombre del servicio
- path
- la vía de acceso totalmente calificada de la biblioteca de carga dinámica
Elemento: Agent
Esto especifica información específica del agente.
Utilizado por: AgentControllerConfiguration, PluginConfiguration
Subelementos: Option
Atributos:
- configuration
- nombre de la configuración que utiliza esta configuración de agente
- name
- nombre del agente
- type
- tipo de agente
- dataChannelSize
- cantidad de memoria compartida para asignar a la comunicación interproceso
- logFile
- vía de acceso totalmente calificada para el archivo de anotaciones que escribe los mensajes enviados por el agente
- client
- especifique si este agente es dinámico o de modalidad autónoma
Elemento: Option
Esto se utiliza para almacenar un par nombre-valor.
Utilizado por: AgentControllerConfiguration, PluginConfiguration, Service, Agent
Atributos:
- name
- nombre de la opción (es decir, espacio de nombres)
- type
- tipo de la opción (es decir, nombre de la opción)
- value
- valor de la opción
Elemento: Plugin
Esto especifica el directorio en el que se deben buscar configuraciones de plug-in
Utilizado por: AgentControllerConfiguration
Atributos:
pathDirectorio totalmente calificado en el que buscar configuraciones de plug-in
Elemento: Variable
Variable de entorno.
Utilizado por: Application, AgentControllerEnvironment
Atributos:
- name
- nombre de la variable de entorno (es decir, CLASSPATH)
- value
- valor de la variable de entorno
- position
- especifique si este valor debe afijarse, prefijarse o sustituir al valor existente
Elemento: Parameter
Parámetro de programa.
Utilizado por: Application
Atributos:
- value
- valor del parámetro del programa
- position
- especificar si este parámetro debe afijarse, prefijarse o sustituir al parámetro existente