Archivos de configuración de Agent Controller
La configuración de Agent Controller se especifica en dos conjuntos de
archivos de configuración.
El primer conjunto es la configuración ase, que describe los valores por omisión del
motor. El segundo conjunto es la configuración del conector, que describe los valores específicos
de aplicación del motor. En este documento se describe cada configuración en detalle, y 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 coloca el paquete Agent Controller. A
este directorio también se le hace referencia como %RASERVER_HOME% en los
archivos de configuración.
Configuración base
La configuración base se compone del archivo <directorio de
instalación>/config/serviceconfig.xml, que se construye utilizando el esquema
XML <directorio de instalación>/config/serviceconfig.xsd.
Así se especifican los valores por omisión, como las variables de entorno del sistema, las configuraciones
de aplicación y la conectividad del Agent Controller. La configuración base estará disponible para
todas las demás configuraciones, y se carga cuando se inicia el servicio motor. Los desarrolladores
de aplicaciones no deberían modificar este archivo de configuración base, ya que los cambios
serían globales. Hay que utilizar las configuraciones de conector (que se describen más adelante)
para especificar los valores concretos de conector y aplicación.
Configuración de Plugin
Cada aplicación definida por el usuario debe tener su propio archivo de configuración y dependencias,
situados en el directorio de conector <directorio de instalación>/plugin/<nombre de
conector> donde <nombre de conector> es un nombre exclusivo que identifica a la
aplicación. El archivo de configuración de conector pluginconfig.xml
se debe colocar en el subdirectorio config del directorio del conector.
Por lo general, los archivos JAR se colocan en el subdirectorio lib del
directorio del conector.
Los desarrolladores pueden utilizar el esquema XML <directorio de
instalación>/config/pluginconfig.xsd como ayuda para la construcción
del archivo de configuración del conector.
Elementos y atributos
Elemento: AgentControllerConfiguration
Es el elemento raíz de la configuración base. Estos valores se utilizan para el inicio del servicio motor.
Usado por: Configuración base
Elementos subordinados: AgentControllerEnvironment, Application, Hosts, Service, Agent, Option, Plugin
Atributos:
- activeConfiguration
- especifica la configuración que se carga en el inicio del motor
- filePort
- especifica el puerto en el que atiende el servicio de transferencia de archivos
de Agent Controller. El valor por omisión es 10005.
- isDataMultiplexed
- especifica si el perfil y anotación de datos se debería transmitir por el canal de control de Agent Controller. Por omisión, el canal de datos utiliza un puerto arbitrario para la transmisión de datos, y puede estar bloqueado por la existencia de un cortafuegos. La transferencia de datos sobre el canal de control permitiría la apertura de un grupo de puertos predefinidos para las peticiones de conexión de entradas a través del cortafuegos. Entre estos puertos se encuentra el puerto por omisión 10002, el puerto seguro 1003, y el puerto de servidor de archivos 10005. El valor por omisión para este atributo es false.
- jvm
- vía de acceso completa para la biblioteca dinámica en tiempo de ejecución de la Máquina virtual Java (jvm.dll o libjvm.so)
- loggingDetail
- si se especifica HIGH, permite la anotación del número de línea del motor
- loggingDirectory
- directorio en el que se crea el archivo de anotaciones servicelog.log del motor
- loggingLevel
- filtro de gravedad para los mensajes de anotaciones
- port
- puerto en el que el motor atiende las conexiones de entrada no seguras de clientes
- processPolling
- especifica si está habilitada la comprobación activa del estado de procesos. Este atributo lo utilizan principalmente sistemas Windows para asegurarse que Agent Controller recibe notificación cuando un proceso termine. El valor por omisión es true.
- securedPort
- puerto en el que el motor atiende las conexiones de entrada seguras de clientes
- version
- versión del motor
Elemento: PluginConfiguration
Es el elemento raíz de la configuración del conector. Los valores se cargan una vez que se ha cargado la configuración base.
Usado por: Configuración de conector
Elementos subordinados: AgentControllerEnvironment, Application, Service, Agent, Option
Atributos:
- requires
- lista separada por comas del nombre o nombres de conector de los que depende esta configuración
Elemento: AgentControllerEnvironment
Es un indicador para las variables de entorno global que esta configuración aporta.
Se publican en el sistema y están disponibles para el resto de configuraciones, incluyendo la configuración base.
Usado por: AgentControllerConfiguration, PluginConfiguration
Elementos subordinados: Variable
Atributos:
- configuration
- nombre de la configuración en la que se añadirán las variables de entorno
Elemento: Application
Es un indicador para el entorno específico de la aplicación. Los valores dentro de este indicador sólo son visibles para esta aplicación concreta.
Usado por: AgentControllerConfiguration, PluginConfiguration
Elementos subordinados: Variable, Parameter
Atributos:
- configuration
- nombre de la configuración a la que se añadirá la aplicación
- executable
- nombre de aplicación; los clientes deben utilizar este nombre para identificar esta aplicación
- path
- vía de acceso completa del programa que esta aplicación debe ejecutar
- location
- directorio de trabajo de esta aplicación
- extends
- nombre de configuración para el que ya está definida la misma aplicación; se añadirá a la parte superior de los valores actuales
Elemento: Hosts
Es un indicador para la información del sistema principal. Lo utiliza el motor para permitir/denegar la conexión de determinados sistemas principales.
Usado por: AgentControllerConfiguration
Elementos subordinados: Allow, Deny
Atributos:
configurationnombre de la configuración en la que se utilizará esta información de sistema principal
Elemento: Allow
Especifica los sistemas principales que tienen permiso de conexión al motor.
Usado por: Hosts
Atributos:
- host
- nombre o dirección IP del sistema principal
- net
- subred
- mask
- máscara de subred
Elemento: Deny
Especifica los sistemas principales que no tienen permiso de conexión al motor.
Usado por: Hosts
Atributos:
- host
- nombre o dirección IP del sistema principal
- net
- subred
- mask
- máscara de subred
Elemento: Service
Especifica el módulo definido por el usuario que se cargará en el inicio del motor.
Usado por: AgentControllerConfiguration, PluginConfiguration
Elementos subordinados: Option
Atributos:
- configuration
- nombre de la configuración en la que se cargará este servicio
- name
- nombre del servicio
- path
- vía de acceso completa para la biblioteca de carga dinámica
Elemento: Agent
Especifica información concreta del agente.
Usado por: AgentControllerConfiguration, PluginConfiguration
Elementos subordinados: Option
Atributos:
- configuration
- nombre de la configuración en la que se utilizará esta configuración de agente
- name
- nombre del agente
- type
- tipo del agente
- dataChannelSize
- cantidad de memoria compartida a asignar para la comunicación entre procesos
- logFile
- vía de acceso completa para el archivo de anotaciones que registra los mensajes enviados por el agente
- client
- especifica si este agente es dinámico o sin cabecera
Elemento: Option
Se utiliza para almacenar una pareja nombre-valor.
Usado por: AgentControllerConfiguration, PluginConfiguration, Service, Agent
Atributos:
- name
- nombre de la opción (p.e. espacionombres)
- type
- tipo de la opción (p.e. nombre opción)
- value
- valor de la opción
Elemento: Plugin
Especifica el directorio en el que buscar configuraciones de conector
Usado por: AgentControllerConfiguration
Atributos:
pathdirectorio completo en el que buscar configuraciones de conector
Elemento: Variable
Variable de entorno.
Usado por: Application, AgentControllerEnvironment
Atributos:
- name
- nombre de la variable de entorno (p.e. CLASSPATH)
- value
- valor de la variable de entorno
- position
- especifica si este valor se añade antes o después del valor existente, o si lo sustituye
Elemento: Parameter
Parámetro de programa.
Usado por: Application
Atributos:
- value
- valor del parámetro de programa
- position
- especifica si este parámetro se añade antes o después del parámetro existente, o si lo sustituye