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 a todas as configurações e será carregada quando o serviço de mecanismo for 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 os dados de traçado de perfil e de registro devem ser transmitidos pelo canal de controle do Agent Controller. Por padrão, o canal de dados utiliza uma porta arbitrária para 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 conjunto de portas predefinidas seja aberto para pedidos de conexão de entrada por meio de um firewall. Essas portas incluem a porta padrão 10002, a porta protegida 10003 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 registro de mecanismo servicelog.log é criado
loggingLevel
filtro de gravidade para mensagens de registro
port
porta do mecanismo para atender à conexão do cliente não segura de entrada
processPolling
especifica se a verificação ativa do status do processo está ativada ou não. Esse atributo é utilizado principalmente em sistemas Windows para verificar se o Agent Controller é notificado sempre que um processo é concluído. O valor padrão é true.
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írgula da qual essa configuração depende. A partir do TPTP 4.0, um sufixo de identificador de versão foi incluído nos nomes de plug-in. Consiste em um caractere de sublinhado seguido pelo número da versão para o release. Por exemplo: org.eclipse.tptp.platform.agentcontroller_4.0.0. Para garantir a compatibilidade de plug-in em aplicativos que têm dependências de plug-ins de releases anteriores (os plug-ins que não têm um sufixo de identificador de versão), você tem a opção de especificar o nome do plug-in para o atributo "requires", excluindo o identificador de versão. Nesse caso, o loader de configuração do Agent Controller primeiro tentará localizar o nome completo do plug-in, incluindo o sufixo de identificador de versão. Se malsucedido, o loader de configuração procurará o nome do plug-in excluindo o sufixo de identificador de versão. Se houver mais de um plug-in com o mesmo nome, o primeiro nome do plug-in retornado pelo sistema operacional será utilizado.

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
caminho
o caminho completo real do programa no qual esse aplicativo deve executar
local
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:
configuration
nome da configuração com a qual essas informações sobre o host são utilizadas

Elemento: Allow
Isso 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
Isso 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 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:
configuration
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 registro 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:
nome
nome da opção (e.g. espaço de nomes)
tipo
tipo da opção (e.g. nome da opção)
value
valor da opção


Elemento: Plugin
Isso 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 de plug-in

Elemento: Variable
Variável de ambiente.

Utilizado por: Application, AgentControllerEnvironment

Atributos:
nome
nome da variável de ambiente (e.g. CLASSPATH)
value
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:
value
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, 2006. Todos os direitos reservados.