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



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