Ficheiros de configuração do Controlador de Agentes
A configuração do Controlador de Agentes é especificado por dois conjuntos de ficheiros de configuração.
O primeiro conjunto é a configuração base que descrever as predefinições do motor.
O segundo conjunto é a configuração do conector que descreve as definições específicas da aplicação do motor.
Este documento descreve detalhadamente cada configuração e como escrever extensões de configuração.
O directório <directório de instalação> referido neste documento corresponde ao caminho onde o Controlador de Agentes é descomprimido. Este directório é também referido como %RASERVER_HOME% nos ficheiros de configuração.
Configuração base
A configuração base consiste no <directório de instalação>/config/serviceconfig.xml do ficheiro, que é construído utilizando o <directório de instalação>/config/serviceconfig.xsd do esquema XML.
Isto especifica as predefinições como variáveis de ambiente do sistema, configurações de aplicações e conectividade do Controlador de Agentes. A configuração base estará disponível para todas as configurações e é carregada quando o serviço do motor for iniciado. Os programadores da aplicação não deverão modificar este ficheiro de configuração base, uma vez que quaisquer alterações na configuração base serão globais. As configurações de conectores (descritas a seguir) deverão ser utilizadas para especificar as definições específicas do conector e da aplicação.
Configuração do conector
Cada aplicação definida pelo utilizador deverá ter o respectivo ficheiro de configuração e dependências a colocar sob
o directório do conector <directório de instalação>/plugin/<plug-in name> onde <plug-in name>
é um nome único que identifica a aplicação. O ficheiro de configuração do conector pluginconfig.xml deverá ser colocado sob o subdirectório config do directório onde se encontra o conector.
Normalmente, os ficheiros JAR são colocados sob o subdirectório lib do directório do conector.
Os programadores podem utilizar o <directório de instalação>/config/pluginconfig.xsd do esquema XML para ajudar na construção do ficheiro de configuração do conector.
Elementos e Atributos
Elemento: AgentControllerConfiguration
Este é o elemento raiz da configuração base. As definições são utilizadas para iniciar o serviço do motor.
Utilizado por: Configuração base
Sub-elementos: AgentControllerEnvironment, Application, Hosts, Service, Agent, Option, Plugin
Atributos:
- activeConfiguration
- especificar qual a configuração a carregar no arranque do motor
- filePort
- especificar a porta na qual aguarda o serviço de transferência de ficheiros do Controlador de Agentes. O valor predefinido é 10005.
- isDataMultiplexed
- especificar se deve ser transmitidos os dados de perfilamento e registo através do canal de controlo do Controlador de Agentes. Por predefinição, o canal de dados utiliza uma porta arbitrária para a transmissão de dados e poderá ficar bloqueada com a existência de uma firewall. Transferir os dados através do canal de controlo irá permitir que se abra um conjunto de portas predefinidas para os pedidos de ligação de entrada através de uma firewall. Estas portas incluem a porta predefinida 10002, a porta segura 10003, e a porta do servidor de ficheiros 10005. O valor predefinido para este atributo é false.
- jvm
- caminho completo da biblioteca de tempo de execução dinâmico da Máquina Virtual Java (jvm.dll ou libjvm.so)
- loggingDetail
- activar registo de número de linha do motor se estiver especificada a opção HIGH
- loggingDirectory
- directório onde o ficheiro de registo do motor servicelog.log foi criado
- loggingLevel
- filtro de gravidade para registar mensagens
- port
- porta de motor para escutar a ligação de cliente não segura de entrada
- processPolling
- especificar se a execução activa está ou não activada para o estado do processo. Este atributo é usado principalmente em sistemas Windows para assegurar que o Controlador de Agentes é notificado sempre que um processo é concluído. O valor predefinido é true.
- securedPort
- porta de motor para escutar a ligação de cliente segura de entrada
- version
- versão de motor
Elemento: PluginConfiguration
Este é o elemento raiz da configuração do conector. As definições são carregadas após a configuração base ser carregada.
Utilizado por: Configuração do conector
Sub-elementos: AgentControllerEnvironment, Application, Service, Agent, Option
Atributos:
- requires
- uma lista separada por vírgulas dos nomes dos conectores dos quais depende esta configuração. Desde TPTP 4.0, foi adicionado um sufixo de identificador de versão aos nomes dos conectores. Consiste num carácter de traço de sublinhado seguido do número da versão para a edição. Por exemplo: org.eclipse.tptp.platform.agentcontroller_4.0.0. Para assegurar a compatibilidade do conector para as aplicações que têm dependências em conectores de edições anteriores (conectores que não têm um sufixo de identificador de versão), tem a opção de especificar o nome do conector para o atributo "requires", excluindo o identificador da versão. Neste caso, o carregador de configuração do Controlador de Agentes irá primeiro tentar localizar o nome completo do conector, incluindo o sufixo do identificador de versão. Se não conseguir, o carregador de configuração irá então procurar o nome do conector, excluindo o sufixo de identificador de versão. Se existir mais do que um conector com o mesmo nome, será utilizado o primeiro nome de conector devolvido pelo sistema operativo.
Elemento: AgentControllerEnvironment
Este é um substituto para as variáveis de ambiente global que foram uma contribuição desta configuração.
Estas variáveis estão publicadas no sistema e estão disponíveis para todas as outras configurações, incluindo a configuração base.
Utilizado por: AgentControllerConfiguration, PluginConfiguration
Sub-elementos: Variable
Atributos:
- configuration
- nome da configuração onde serão adicionadas as variáveis de ambiente
Elemento: Application
Este é um substituto para o ambiente específico da aplicação. As definições são visíveis apenas para esta aplicação específica.
Utilizado por: AgentControllerConfiguration, PluginConfiguration
Sub-elementos: Variable, Parameter
Atributos:
- configuration
- nome da configuração onde será adicionada a aplicação
- executable
- nome da aplicação, os clientes devem utilizar este nome para identificar esta aplicação
- path
- o caminho real, totalmente qualificado do programa no qual deverá ser executada a aplicação
- location
- directório de trabalho desta aplicação
- extends
- o nome da configuração que a mesma aplicação já definiu, isto irá adicionar as definições actuais no topo
Elemento: Hosts
Este é um substituto da informação do sistema central. É utilizado pelo motor para permitir/não permitir que determinados sistemas centrais estabeleçam ligação.
Utilizado por: AgentControllerConfiguration
Sub-elementos: Allow, Deny
Atributos:
configurationnome da configuração que utilizar esta informação do sistema central
Elemento: Allow
Este especifica quais os sistema centrais que têm permissão para estabelecer ligação com o motor.
Utilizado por: Hosts
Atributos:
- host
- nome ou endereço de IP do sistema central
- net
- sub-rede
- mask
- máscara de sub-rede
Elemento: Deny
Este especifica quais os sistemas centrais que não têm permissão para estabelecer ligação com o motor.
Utilizado por: Hosts
Atributos:
- host
- nome ou endereço de IP do sistema central
- net
- sub-rede
- mask
- máscara de sub-rede
Elemento: Service
Este elemento especifica qual o módulo definido pelo utilizador para carregar no arranque do motor.
Utilizado por: AgentControllerConfiguration, PluginConfiguration
Sub-elementos: Option
Atributos:
- configuration
- nome da configuração que deve carregar este serviço
- name
- nome do serviço
- path
- o caminho totalmente qualificado da biblioteca de carregamento dinâmico
Elemento: Agent
Este elemento especifica as informações específicas do agente.
Utilizado por: AgentControllerConfiguration, PluginConfiguration
Sub-elementos: Option
Atributos:
- configuration
- nome da configuração que utiliza esta configuração de agente
- name
- nome do agente
- type
- tipo do agente
- dataChannelSize
- quantidade de memória partilhada a atribuir para comunicação entre processos
- logFile
- caminho totalmente qualificado para o ficheiro de registo que escreve as mensagens enviadas pelo agente
- client
- especifica se o agente é dinâmico ou autónomo
Elemento: Option
Este é utilizado para armazenar um par de nome-valor .
Utilizador por: AgentControllerConfiguration, PluginConfiguration, Service, Agent
Atributos:
- name
- nome da opção (ou seja, espaço do nome)
- type
- tipo da opção (ou seja, nome da opção)
- value
- valor da opção
Elemento: Plugin
Este especifica o directório a pesquisar para procurar configurações do conector.
Utilizado por: AgentControllerConfiguration
Atributos:
patho directório totalmente qualificado onde procurar configurações do conector
Elemento: Variable
Variável do ambiente.
Utilizado por: Application, AgentControllerEnvironment
Atributos:
- name
- nome da variável de ambiente (por exemplo, CLASSPATH)
- value
- valor da variável de ambiente
- position
- especifica se o valor irá ser anexado, anexado previamente ou se irá substituir o valor existente
Elemento: Parameter
O parâmetro do programa.
Utilizado por: Application
Atributos:
- value
- valor do parâmetro do programa
- position
- especifica se o parâmetro irá ser anexado, anexado previamente ou se irá substituir o parâmetro existente