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çãonome 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:
caminhodiretó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