Archivos de configuración del controlador de agentes
La configuración del controlador de agentes 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 el controlador de agentes. 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 del controlador de agentes. 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 del controlador de agentes está a la escucha. El valor por omisión es 10005.
- isDataMultiplexed
- especificar si los datos de perfilado y anotaciones se deben transmitir a través del canal de control del controlador de agentes. Por omisión, el canal de datos utiliza un puerto arbitrario para la transmisión de datos que puede estar bloqueado debido a la existencia de un cortafuegos. La transferencia de datos a través del canal de control permite abrir un conjunto de puertos predefinidos para las peticiones de conexión entrantes a través de un cortafuegos. Estos puertos incluyen el puerto por omisión 10002, el puerto protegido 1003 y el puerto de servidor de archivos 10005. El valor por omisión para este atributo es falso.
- jvm
- vía de acceso completa 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 se habilita o no la comprobación activa del estado de proceso. Este atributo se utiliza, básicamente, en sistemas Windows a fin de asegurar que se notifica al controlador de agentes cada vez que termina un proceso. El valor por omisión es verdadero.
- 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 nombres de plug-ins de los que depende esta configuración
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
- vía de acceso real completa 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 sistema principal. Lo utiliza el motor para permitir / no
permitir la conexión de determinados sistemas principales.
Utilizado por: AgentControllerConfiguration
Subelementos: Allow, Deny
Atributos:
configurationnombre de la configuración que utiliza esta información de sistema principal
Elemento: Allow
Esto especifica qué sistemas principales pueden conectar con el motor.
Utilizado por: Sistemas principales
Atributos:
- host
- nombre o dirección IP del sistema principal
- net
- subred
- mask
- máscara de subred
Elemento: Deny
Esto especifica qué sistemas principales no pueden conectar con el motor.
Utilizado por: Sistemas principales
Atributos:
- host
- nombre o dirección IP del sistema principal
- 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
- vía de acceso completa 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 completa para el archivo de anotaciones que escribe los mensajes que envía 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 completo 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 añadirse, anteponerse 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 añadirse, anteponerse o sustituir al parámetro existente