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