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 configurações padrão do mecanismo. O segundo conjunto
é a configuração de plug-in que descreve as configurações especificadas pelo aplicativo do mecanismo. 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. Este diretório é chamado também de %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.
Isto especifica as configurações padrão, tais como variáveis de ambiente do sistema, configurações do aplicativo
e conectividade do Agent Controller. A configuração base estará disponível para todas as configurações
e será carregada quando o serviço de mecanismo for iniciado. Os desenvolvedores de aplicativos não devem modificar
este arquivo de configuração base, pois todas as alterações na configuração base serão globais. As configurações
de plug-in (descritas abaixo) devem ser utilizadas para especificar as configurações específicas do 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 de plug-in> em que <nome de 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
Este é o elemento raiz da configuração base. As configurações são utilizadas para iniciar o serviço de mecanismo.
Utilizado por: Configuração Base
Subelementos: AgentControllerEnvironment, Aplicativo, Hosts, Serviço, Agente, Opção, Plug-in
Atributos:
- activeConfiguration
- especificar a configuração que deverá ser carregada na inicialização do mecanismo
- filePort
- especificar a porta na qual o serviço de transferência de arquivos do Agent Controller é atendido. O valor padrão é 10005.
- isDataMultiplexed
- especificar se o traçado de perfil e os dados de log 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 bloqueada pela existência de um firewall. A transferência de 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 segura 1003 e a porta do servidor de arquivos 10005. O valor padrão deste atributo é falso.
- jvm
- caminho completo da biblioteca de tempo de execução de Java Virtual Machine (jvm.dll ou libjvm.so)
- loggingDetail
- ativar o log do número de linha do mecanismo se HIGH estiver especificado
- loggingDirectory
- diretório em que o arquivo de log do mecanismo servicelog.log é criado
- loggingLevel
- filtro de severidade para mensagens de log
- porta
- porta do mecanismo para atendimento da conexão não segura do cliente de entrada
- processPolling
- especificar se a verificação ativa do status do processo está ou não ativada. Este atributo é utilizado principalmente em sistemas Windows para garantir que o Agent Controller seja notificado sempre que um processo for concluído. O valor padrão é verdadeiro.
- securedPort
- porta de mecanismo para atendimento de conexão segura do cliente de entrada
- versão
- versão do mecanismo
Elemento: PluginConfiguration
Este é o elemento raiz da configuração de plug-in. As configurações são carregadas depois que a configuração base for carregada.
Utilizado por: Configuração de Plug-in
Subelementos: AgentControllerEnvironment, Aplicativo, Serviço, Agente, Opção
Atributos:
- requer
- uma lista de nome(s) de plug-ins separados por vírgula da qual está configuração depende
Elemento: AgentControllerEnvironment
Este é um marcador da(s) variável(is) de ambiente global contribuídas por esta configuração.
Elas são publicadas no sistema e estão disponíveis para todas as outras configurações, incluindo a configuração base.
Utilizado por: AgentControllerConfiguration, PluginConfiguration
Subelementos: Variável
Atributos:
- configuração
- nome da configuração em que as variáveis de ambiente devem ser incluídas
Elemento: Aplicativo
Este é um marcador do ambiente específico do aplicativo. As configurações internas são visíveis apenas neste aplicativo específico.
Utilizado por: AgentControllerConfiguration, PluginConfiguration
Subelementos: Variável, Parâmetro
Atributos:
- configuração
- nome da configuração em que o aplicativo deverá ser incluído
- executável
- nome do aplicativo, os clientes devem utilizar esse nome para identificar este aplicativo
- caminho
- o caminho completo, real do programa no qual este aplicativo deve ser executado
- local
- diretório de trabalho deste aplicativo
- extensões
- o nome da configuração na qual o mesmo aplicativo já está definido; isto incluirá as configurações atuais no início da página
Elemento: Hosts
Este é um marcador das informações do host. Isto é utilizado pelo mecanismo para permitir / não permitir que determinado(s) host(s) se conecte(m).
Utilizado por: AgentControllerConfiguration
Subelementos: Permitir, Negar
Atributos:
configuraçãonome da configuração na qual essas informações de host são utilizadas
Elemento: Permitir
Isto especifica qual(is) host(s) têm permissão para conectar ao mecanismo.
Utilizado por: Hosts
Atributos:
- host
- nome ou endereço IP do host
- rede
- sub-rede
- máscara
- máscara de sub-rede
Elemento: Negar
Isto especifica qual(is) host(s) não têm permissão para conectar ao mecanismo.
Utilizado por: Hosts
Atributos:
- host
- nome ou endereço IP do host
- rede
- sub-rede
- máscara
- máscara de sub-rede
Elemento: Serviço
Isto especifica qual módulo definido pelo usuário deverá ser carregado na inicialização do mecanismo.
Utilizado por: AgentControllerConfiguration, PluginConfiguration
Subelementos: Opção
Atributos:
- configuração
- nome da configuração na qual este serviço deverá ser carregado
- nome
- nome do serviço
- caminho
- o caminho completo da biblioteca de carregamento dinâmico
Elemento: Agente
Isto especifica informações específicas do agente.
Utilizado por: AgentControllerConfiguration, PluginConfiguration
Subelementos: Opção
Atributos:
- configuração
- nome da configuração na qual esta configuração de agente é utilizada
- nome
- nome do agente
- tipo
- tipo do agente
- dataChannelSize
- quantidade de memória compartilhada a ser alocada para comunicação entre processos
- logFile
- caminho completo do arquivo de log que grava as mensagens enviadas pelo agente
- cliente
- especificar se este agente é dinâmico ou headless
Elemento: Opção
Isto é utilizado para armazenar um par nome-valor.
Utilizado por: AgentControllerConfiguration, PluginConfiguration, Serviço, Agente
Atributos:
- nome
- nome da opção (p. ex. espaço de nomes)
- tipo
- tipo da opção (p. ex. nome da opção)
- valor
- valor da opção
Elemento: Plug-in
Isto especifica o diretório a ser consultado para obter as configurações de plug-in
Utilizado por: AgentControllerConfiguration
Atributos:
caminhodiretório completo a ser consultado para obter as configurações de plug-in
Elemento: Variável
Variável do ambiente.
Utilizado por: Aplicativo, AgentControllerEnvironment
Atributos:
- nome
- nome da variável de ambiente (por ex. CLASSPATH)
- valor
- valor da variável de ambiente
- posição
- especificar se este valor deve ser anexado, incluído ou substituir o valor existente
Elemento: Parâmetro
Parâmetro do programa.
Utilizado por: Aplicativo
Atributos:
- valor
- valor do parâmetro do programa
- posição
- especificar se este parâmetro deve ser anexado, incluído ou substituir o parâmetro existente