Arquivos de Configuração do Agent Controller

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
filePort
especifica a porta em que o serviço de transferência de arquivos do Agent Controller está atendendo. O valor padrão é 10005.
isDataMultiplexed
especifica se o traçado de perfil e o registro de dados em log devem ser transmitidos pelo canal de controle do Agent Controller. Por padrão, o canal de controle utiliza uma porta arbitrária para a transmissão de dados e pode ser bloqueado pela existência de um firewall. A transferência dos dados pelo canal de controle permitirá que um conjuntos de portas predefinidas sejam abertas para receber pedidos de conexão através de um firewall. Essas portas incluem: a porta padrão 10002, a porta protegida 1003 e a porta do servidor de arquivos 10005. O valor padrão desse atributo é false.
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
porta
porta do mecanismo para atender à conexão do cliente não segura de entrada
processPolling
especifica se a verificação ativa de status do processo está ativada ou não. Este atributo é utilizado principalmente em sistemas Windows para assegurar que o Agent Controller é notificado sempre que um processo termina. O valor padrão é true.
securedPort
porta do mecanismo para atender à conexão do cliente segura de entrada
versão
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:
configuração
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:
configuração
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
caminho
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 a 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:
configuração
nome da configuração com a 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:
configuração
nome da configuração com a qual esse serviço deve ser carregado
nome
nome do serviço
caminho
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:
configuração
nome da configuração com a qual essa configuração do agente é utilizada
nome
nome do agente
tipo
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
cliente
especifica se esse agente é dinâmico ou headless
Elemento: Option
Utilizado para armazenar um par nome-valor. Utilizado por: AgentControllerConfiguration, PluginConfiguration, Service, Agent Atributos:
nome
nome da opção (e.g. espaço de nomes)
tipo
tipo da opção (e.g. nome da opção)
Valor
valor da opção


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

Utilizado por: AgentControllerConfiguration

Atributos:
caminho
diretório completo para procura de configurações

Elemento: Variable
Variável de ambiente.

Utilizado por: Application, AgentControllerEnvironment

Atributos:
nome
nome da variável de ambiente (e.g. CLASSPATH)
Valor
valor da variável de ambiente
posição
especifica se o valor deve ser anexado, pré-anexado ou substituir o valor existente
Elemento: Parameter
Parâmetro do programa.

Utilizado por: Application

Atributos:
Valor
valor do parâmetro do programa
posição
especifica se esse parâmetro deve ser anexado, pré-anexado ou substituir o parâmetro existente



(C) Copyright IBM Corporation 2000, 2005. Todos os Direitos Reservados.