Arquivos de Configuração do Agent Controller

Conteúdo

Introdução
Configuração Base
Configuração de Plug-in
Elementos e Atributos

Introdução

A configuração do Agent Controller é especificada por dois conjuntos de arquivos de configuração. O primeiro conjunto é a configuração base que descreve as definições padrão do mecanismo. O segundo conjunto é a configuração de plug-in que descreve as definições do mecanismo específicas do aplicativo. Este documento descreve os detalhes de cada configuração e como gravar extensões de configuração.

O diretório <diretório_de_instalação> referido neste documento corresponde ao caminho onde o Agent Controller é descompactado. Esse diretório também é referido como %RASERVER_HOME% nos arquivos de configuração.

Configuração Base

A configuração base consiste no arquivo <diretório_de_instalação>/config/serviceconfig.xml que é construído utilizando o esquema XML <diretório_de_instalação>/config/serviceconfig.xsd. Isso especifica as definições padrão, como variáveis de ambiente do sistema, configurações de aplicativo e conectividade do Agent Controller. A configuração base estará disponível em todas as configurações e é carregada quando o serviço do mecanismo é iniciado. Os desenvolvedores de aplicativos não modificam esse arquivo de configuração base porque todas as alterações na configuração base serão globais. As configurações de plug-in (descritas a seguir) devem ser utilizadas para especificar definições determinadas de plug-in e de aplicativo.

Configuração de Plug-in

Cada aplicativo definido pelo usuário deve ter seu arquivo de configuração e dependências colocados no diretório de plug-in <diretório_de_instalação>/plugin/<nome_do_plug-in> em que <nome_do_plug-in> é um nome exclusivo que identifica o aplicativo. O arquivo de configuração de plug-in pluginconfig.xml deve ser colocado no subdiretório config do diretório de plug-in. Normalmente, os arquivos JAR são colocados no subdiretório lib do diretório de plug-in. Os desenvolvedores podem utilizar o esquema XML <diretório_de_instalação>/config/pluginconfig.xsd para ajudar a construir o arquivo de configuração de plug-in.

Elementos e Atributos

Elemento: AgentControllerConfiguration
Esse é o elemento raiz da configuração base. As definições são utilizadas para iniciar o serviço de mecanismo.

Utilizado por: Configuração Base

Subelementos: AgentControllerEnvironment, Application, Hosts, Service, Agent, Option, Plugin

Atributos:

activeConfiguration: especifica qual configuração deve ser carregada na inicialização do mecanismo
jvm: caminho completo da biblioteca de tempo de execução dinâmica da Java Virtual Machine (jvm.dll ou libjvm.so)
loggingDetail: ativação do registro do número de linha do mecanismo, se HIGH estiver especificado
loggingDirectory: diretório em que o arquivo de log de mecanismo servicelog.log é criado
loggingLevel: filtro de gravidade para mensagens de log
port: porta do mecanismo para atender à conexão do cliente não segura de entrada
securedPort: porta do mecanismo para atender à conexão do cliente segura de entrada
version: versão do mecanismo

Elemento: PluginConfiguration
Esse é o elemento raiz da configuração de plug-in. As definições são carregadas após a configuração base ser carregada.

Utilizado por: Configuração de Plug-in

Subelementos: AgentControllerEnvironment, Application, Service, Agent, Option

Atributos:

requires: uma lista de nome(s) de plug-in separada por vírgulas da qual essa configuração depende

Elemento: AgentControllerEnvironment
Esse é um marcador para variáveis de ambiente globais contribuídas por essa configuração. Elas são publicadas para o sistema e estão disponíveis para todas as outras configurações, incluindo a configuração base.

Utilizado por: AgentControllerConfiguration, PluginConfiguration

Subelementos: Variable

Atributos:

configuration: nome da configuração onde as variáveis de ambiente devem ser incluídas

Elemento: Application
Esse é um marcador para um ambiente específico do aplicativo. As definições nele estão disponíveis apenas para esse aplicativo específico.

Utilizado por: AgentControllerConfiguration, PluginConfiguration

Subelementos: Variable, Parameter

Atributos:

configuration: nome da configuração onde o aplicativo deve ser incluído
executable: nome do aplicativo, os clientes devem utilizar esse nome para identificar esse aplicativo
path: o caminho completo real do programa no qual esse aplicativo deve executar
location: diretório de trabalho desse aplicativo
extends: o nome da configuração com o qual o mesmo aplicativo já está definido, isso incluirá as definições atuais no início da página

Elemento: Hosts
Esse é um marcador para informações sobre o host. Ele é utilizado pelo mecanismo para permitir/não permitir a conexão de determinados hosts.

Utilizado por: AgentControllerConfiguration

Subelementos: Allow, Deny

Atributos:
configuration

nome da configuração com o qual essas informações sobre o host são utilizadas

Elemento: Allow
Especifica quais hosts têm permissão para conectar-se ao mecanismo.

Utilizado por: Hosts

Atributos:

host: nome ou endereço IP do host
net: sub-rede
mask: máscara de sub-rede

Elemento: Deny
Especifica quais hosts não têm permissão para conectar-se ao mecanismo.

Utilizado por: Hosts

Atributos:

host: nome ou endereço IP do host
net: sub-rede
mask: máscara de sub-rede

Elemento: Service
Especifica qual módulo definido pelo usuário carregar na inicialização do mecanismo.

Utilizado por: AgentControllerConfiguration, PluginConfiguration

Subelementos: Option

Atributos:

configuration: nome da configuração com o qual esse serviço deve ser carregado
nome: nome do serviço
path: o caminho completo da biblioteca de carregamento dinâmico

Elemento: Agent
Especifica informações determinadas sobre o agente.

Utilizado por: AgentControllerConfiguration, PluginConfiguration

Subelementos: Option

Atributos:

configuration: nome da configuração com o qual essa configuração do agente é utilizada
name: nome do agente
type: tipo do agente
dataChannelSize: quantidade de memória compartilhada para alocar comunicação entre processos
logFile: caminho completo para o arquivo de log que grava as mensagens enviadas pelo agente
client: especifica se esse agente é dinâmico ou headless

Elemento: Option
Utilizado para armazenar um par nome-valor. Utilizado por: AgentControllerConfiguration, PluginConfiguration, Service, Agent Atributos:

name: nome da opção (i.e. espaço de nomes)
type: tipo da opção (i.e. nome da opção)
value: valor da opção

Elemento: Plugin
Especifica o diretório para procura de configurações de plug-in

Utilizado por: AgentControllerConfiguration

Atributos:
path

diretório completo para procura de configurações

Elemento: Variable
Variável de ambiente.

Utilizado por: Application, AgentControllerEnvironment

Atributos:

name: nome da variável de ambiente (e.g. CLASSPATH)
value: valor da variável de ambiente
position: especifica se o valor deve ser anexado, pré-anexado ou substituir o valor existente

Elemento: Parameter
Parâmetro do programa.

Utilizado por: Application

Atributos:

value: valor do parâmetro do programa
position: especifica se esse parâmetro deve ser anexado, pré-anexado ou substituir o parâmetro existente