Descrição Geral da Configuração do Agente e Controlador de Agentes
Nota
Quando este documento remeter para a localização de ficheiros e directórios, o directório
<install-home> é aquele em que o pacote Controlador de Agentes foi
descompactado.
Introdução
Há três ficheiros de configuração utilizados para gerir o comportamento do Controlador de Agentes
e dos Agentes:
-
O ficheiro de configuração serviceconfig.xml
é lido pelo Controlador de Agentes durante o respectivo arranque, para determinar definições de conectividade,
nível de registo global e definições globais para iniciar a aplicação e o agente. Também é lido por agentes que
tentem registar-se com um Controlador de Agentes específico. Cada instância de um Controlador de Agentes executada no
mesmo sistema requer o seu próprio ficheiro serviceconfig.xml
com definições de conectividade exclusivas.
Consulte
O
Ficheiro serviceconfig.xml para obter informações para consulta sobre os elementos deste ficheiro de configuração.
-
As informações de configuração estática para cada agente
estão localizadas num ficheiro
agent.xml. Este ficheiro contém informações das quais
o Controlador de Agentes tem de ter conhecimento relativamente a um agente específico. Estas informações
incluem a forma como lançar o agente (o nome do caminho executável, argumentos da linha
de comandos, etc.), os conjuntos de comandos (interfaces) que o agente suporta,
restrições quanto ao número de instâncias que este agente pode ter em execução e
quantos utilizadores simultâneos deste agente são permitidos. O Controlador de Agentes
procura no directório especificado pelo elemento Agente
no ficheiro serviceconfig.xml
(normalmente definido como
<install-home>\agents)
para localizar estes ficheiros de configuração. Cada agente tem um directório exclusivo com o respectivo nome
e o ficheiro agent.xml está localizado nesse directório (por exemplo,
<install-home>\agents\org.eclipse.tptp.TimeCollector\agent.xml). Quando um agente é requerido,
o Controlador de Agentes utiliza o nome especificado no ficheiro de configuração agent.xml
para localizá-lo.
Consulte
O
Ficheiro
agent.xml
para obter informações para consulta sobre os elementos deste ficheiro de configuração.
Nota
Se a interface de controlador de agentes
estiver a ser utilizada para iniciar agentes, a presença de um ficheiro agent.xml não tem qualquer efeito. Com a interface antiga, o cliente tem de saber o nome do processo que pretende iniciar e esses nomes são definidos por nomes alternativos de aplicação. Um nome
alternativo de aplicação tem de ser colocado num ficheiro pluginconfig.xml ou no ficheiro
serviceconfig.xml. Um nome alternativo de aplicação definido num ficheiro agent.xml será
ignorado.
-
O ficheiro pluginconfig.xml é utilizado por qualquer aplicação (incluindo um agente) que necessite
de expandir as definições de ambiente ou a lista de nomes alternativos de aplicação definidas em
serviceconfig.xml. O termo "plugin" poderá induzir em erro, porque a aplicação
não tem de estar em formato de plug-in Eclipse, embora esse seja o formato utilizado originalmente. O Controlador de Agentes procura no directório
especificado pelo elemento Plug-in
no ficheiro serviceconfig.xml
(normalmente definido como
<install-home>\plugins). Cada aplicação tem um directório exclusivo e o ficheiro
pluginconfig.xml tem de estar localizada no directório
\config dentro desse directório. Consulte O Ficheiro
pluginconfig.xml para obter informações para consulta
sobre os elementos deste ficheiro de configuração.
-
As informações de configuração dinâmica
para cada agente estão localizadas no ficheiro
agentconfig.xml. Este ficheiro é opcional. Espera-se que contenha
informações de configuração que um agente utiliza durante o respectivo arranque ou em
qualquer ponto durante a execução. Os conteúdos e utilização são definidos pelo
criador do agente associado. O ficheiro agentconfig.xml
está normalmente localizado num directório \config
sob o directório com o nome do agente que interessa
(por exemplo,
<install-home>\agents\org.eclipse.tptp.TimeCollector\config\agentconfig.xml).
Este directório de configuração pode ser
especificado no ficheiro
agent.xml. Consoante
a forma como o próprio agente está implementado, este ficheiro de configuração pode ser lido
pelo agente uma única vez, muitas vezes ou mesmo nunca. O Controlador
de Agentes nunca lê este ficheiro.
Actualmente, não há sugestões de elementos para este ficheiro, pelo que não é
dado qualquer exemplo.
Referência relacionada
O Ficheiro serviceconfig.xml
O Ficheiro
agent.xml
O Ficheiro pluginconfig.xml
Copyright (C) 2005, 2006 Intel Corporation.