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:
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
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:
path
Directorio 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



(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.