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:
configuration
nome 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:
path
o 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



(C) Copyright IBM Corporation 2000, 2006. Todos os direitos reservados.