Przegląd konfiguracji agenta i komponentu Agent Controller

Uwaga

W występujących w tym dokumencie odwołaniach do położeń plików i katalogów, <install-home> jest katalogiem, do którego został wyodrębniony pakiet komponentu Agent Controller.

Wprowadzenie

Do zarządzania zachowaniem komponentu Agent Controller i agentów służą trzy pliki konfiguracyjne:

• Plik konfiguracyjny serviceconfig.xml jest wczytywany przez komponent Agent Controller podczas uruchamiania w celu określenia ustawień połączeń, globalnego poziomu rejestrowania i globalnych ustawień uruchamiania aplikacji i agentów. Plik wczytują również agenty podejmujące próbę rejestracji w danym komponencie Agent Controller. Każda instancja komponentu Agent Controller uruchamiana w tym samym systemie wymaga własnego pliku serviceconfig.xml definiującego unikalne ustawienia połączeń. Informacje na temat elementów tego pliku przedstawiono w temacie Plik serviceconfig.xml.
   
• W pliku agent.xml znajdują się statyczne dane konfiguracyjne agenta.Plik ten zawiera informacje na temat agenta niezbędne dla potrzeb komponentu Agent Controller.Informacje te opisują sposób uruchamiania agenta (ścieżkę do pliku wykonywalnego, argumenty wiersza komend itd.), obsługiwane przez agenta zestawy komend (interfejsy), ograniczenia dotyczące liczby jednocześnie uruchomionych instancji agenta oraz maksymalną liczbę równoczesnych użytkowników agenta. Komponent Agent Controller pobiera pliki konfiguracyjne z katalogu określonego przez wartość elementu Agent w pliku serviceconfig.xml (najczęściej jest to katalog <install-home>\agents).Każdy agent ma osobny katalog o unikalnej nazwie będącej jego własną nazwą, a plik agent.xml znajduje się w tym właśnie katalogu (np. <install-home>\agents\org.eclipse.tptp.TimeCollector\agent.xml). W chwili otrzymania żądania uruchomienia agenta, komponent Agent Controller wykorzystuje nazwę podaną w pliku agent.xml do zlokalizowania odpowiedniego agenta.Informacje na temat elementów tego pliku konfiguracyjnego przedstawiono w temacie Plik agent.xml.

Uwaga

Jeśli do uruchamiania agentów używany jest stary interfejs kontrolera agentów, obecność pliku agent.xml nie ma żadnego znaczenia.W przypadku starego interfejsu klient musi znać zdefiniowaną jako alias aplikacji nazwę procesu, który ma być uruchomiony.Alias aplikacji musi być zdefiniowany w pliku pluginconfig.xml lub serviceconfig.xml. Alias aplikacji zdefiniowany w pliku agent.xml zostanie zignorowany.

• Plik pluginconfig.xml używany jest przez dowolną aplikację (włącznie z agentem), która wymaga rozszerzenia ustawień środowiska lub listy aliasów aplikacji zdefiniowanej w pliku serviceconfig.xml.  Termin "wtyczka" może wprowadzać w błąd, ponieważ aplikacja nie musi mieć formy wtyczki Eclipse, pomimo że właśnie w takiej formie używana była początkowo. Komponent Agent Controller pobiera pliki konfiguracyjne z katalogu określonego przez wartość elementu Plugin w pliku serviceconfig.xml (najczęściej jest to katalog <install-home>\plugins).  Każda aplikacja ma unikalny katalog o nazwie odpowiadającej jej samej, a plik pluginconfig.xml musi się znajdować w podkatalogu \config tego katalogu. Informacje na temat elementów tego pliku konfiguracyjnego przedstawiono w temacie Plik pluginconfig.xml.
   
• W pliku agentconfig.xml znajdują się statyczne dane konfiguracyjne agenta.Plik jest ten opcjonalny.Zakładaną zawartość pliku stanowią dane konfiguracyjne wykorzystywane przez agenta podczas uruchamiania lub na dowolnym etapie wykonywania.Zawartość i sposób wykorzystania pliku są definiowane przez twórcę agenta, którego plik dotyczy. Plik agentconfig.xml znajduje się najczęściej w podkatalogu \config w katalogu o takiej samej nazwie, jak agent, którego dotyczy (np. <install-home>\agents\org.eclipse.tptp.TimeCollector\config\agentconfig.xml).Ścieżkę do katalogu konfiguracyjnego można zdefiniować w pliku agent.xml. W zależności od implementacji samego agenta, plik konfiguracyjny może być odczytywany przez agenta raz, wielokrotnie lub wcale.Komponent Agent Controller nigdy nie odczytuje tego pliku.Nie ma jak dotąd sugerowanych elementów tego pliku, więc nie zostanie dla niego podany żaden przykład.
   

Informacje pokrewne

Plik serviceconfig.xml
Plik agent.xml
Plik pluginconfig.xml

Copyright (C) 2005, 2007 Intel Corporation.