Archivos de configuración de Agent Controller

Contenido

Introducción
Configuración base
Configuración del conector
Elementos y atributos

Introducción

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 conector 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 conector (descritas más abajo) deben utilizarse para especificar valores de conector y específicos de la aplicación.

Configuración del conector

Cada aplicación definida por el usuario debe tener ubicado su archivo de configuración y elementos dependientes en el directorio del conector <directorio de instalación>/plugin/<nombre de conector> donde <nombre de conector> es un nombre exclusivo que identifica la aplicación. El archivo de configuración del conector pluginconfig.xml debe situarse bajo el subdirectorio config del directorio del conector. Normalmente, los archivos JAR se sitúan en el subdirectorio lib del directorio del conector. Los desarrolladores pueden utilizar el esquema XML <directorio de instalación>/config/pluginconfig.xsd para ayudar a construir el archivo de configuración del conector.

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
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
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 conector. Los valores se cargan después de cargar la configuración base.

Utilizado por: Configuración del conector

Subelementos: AgentControllerEnvironment, Application, Service, Agent, Option

Atributos:

requires: una lista separada por comas de nombres de conectores 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: 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 sistema principal. Lo utiliza el motor para permitir / no permitir la conexión de determinados sistemas principales.

Utilizado por: AgentControllerConfiguration

Subelementos: Allow, Deny

Atributos:
configuration

nombre 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: 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 conector

Utilizado por: AgentControllerConfiguration

Atributos:
path

Directorio totalmente calificado en el que buscar configuraciones de conector

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