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



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