Visão Geral da Configuração do Agente e do Agent Controller
Nota
Ao fazer referência a locais de arquivo e diretório neste documento,
<install-home> é o diretório em que o pacote do Agent Controller foi descompactado.
Introdução
Há três arquivos de configuração utilizados para gerenciar o comportamento do Agent
Controller e dos agentes:
-
O arquivo de configuração serviceconfig.xml
é lido pelo Agent Controller durante sua inicialização para
determinar as configurações de conectividade, o nível de registro global e as configurações globais
para ativação do aplicativo e do agente. É lido também pelos agentes que estão tentando
se registrar em um determinado Agent Controller. Cada instância de
um Agent Controller em execução no mesmo sistema exige seu próprio
arquivo serviceconfig.xml com configurações de conectividade exclusivas.
Consulte
O
Arquivo serviceconfig.xml para obter
informações de referência sobre os elementos desse arquivo de configuração.
-
As informações de configuração estática
para cada agente estão localizadas em um
arquivo agent.xml. Esse arquivo contém informações que o
Agent Controller precisa saber a respeito de um determinado agente. Isso
inclui como ativar o agente (nome do caminho do executável, argumentos de linha
de comando, etc.), quais conjuntos de comandos (interfaces) o agente suporta,
restrições sobre quantas instâncias em execução desse agente são permitidas e
quantos usuários simultâneos de um agente são permitidos. O
Agent Controller consulta o diretório especificado pelo elemento Agent
no arquivo serviceconfig.xml
(definido normalmente como
<install-home>\agents)
para localizar esses arquivos de configuração. Cada agente possui um diretório exclusivo nomeado para ele
e o arquivo agent.xml está localizado nesse diretório (por ex.,
<install-home>\agents\org.eclipse.tptp.TimeCollector\agent.xml). Quando um
agente é solicitado, o Agent Controller utiliza o nome especificado no arquivo de configuração agent.xml
para localizá-lo.
Consulte
O
Arquivo
agent.xml para obter
informações de referência sobre os elementos desse arquivo de configuração.
Nota
Se a interface antiga do agent controller
estiver sendo utilizada para iniciar os agentes, a presença de um agent.xml não terá
efeito. Com a interface antiga, o cliente deverá saber o nome do processo que
deseja iniciar e esses nomes serão definidos pelos aliases do aplicativo. Um
alias de aplicativo deverá ser colocado em um pluginconfig.xml ou no
serviceconfig.xml. Um alias de aplicativo definido em um agent.xml será
ignorado.
-
O arquivo pluginconfig.xml é utilizado por qualquer aplicativo (incluindo um agente) que
precisa estender as configurações do ambiente ou a lista de aliases do aplicativo definida
em serviceconfig.xml. O termo "plugin" pode
ser entendido incorretamente, porque o
aplicativo não precisa estar na forma de um plug-in do Eclipse, embora
seja o que foi utilizado originalmente. O Agent Controller consulta o
diretório especificado pelo elemento Plugin
no arquivo serviceconfig.xml
(definido normalmente como
<install-home>\plugins). Cada aplicativo possui um diretório
exclusivo nomeado para ele e o arquivo pluginconfig.xml deve estar localizado
no diretório \config dentro desse diretório. Consulte O Arquivo
pluginconfig.xml para obter
informações de referência sobre os elementos desse arquivo de configuração.
-
As informações de configuração dinâmica
para cada agente estão localizadas em um
arquivo
agentconfig.xml. Esse arquivo é opcional. Espera-se que ele contenha informações
de configuração que um agente utiliza durante sua inicialização ou em qualquer
ponto durante sua execução. O conteúdo e o uso são definidos pelo
criador do agente associado. O arquivo agentconfig.xml
está localizado normalmente em um diretório \config
abaixo do
diretório nomeado para o agente de interesse (por ex.,
<install-home>\agents\org.eclipse.tptp.TimeCollector\config\agentconfig.xml).
Esse diretório de configuração
pode ser
especificado no
arquivo
agent.xml. Dependendo de como
o próprio agente foi implementado, esse arquivo de configuração poderá ser lido
pelo agente apenas uma vez, muitas vezes ou nunca. O Agent
Controller nunca lê esse arquivo.
Atualmente, não há sugestões de elementos para esse arquivo, portanto, nenhum exemplo de
referência será fornecido.
Referência Relacionada
O Arquivo serviceconfig.xml
O Arquivo
agent.xml
O Arquivo pluginconfig.xml
Direitos Autorais (C) 2005, 2006 Intel Corporation.