Przegląd konfigurowania agentów 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 może być używany przez dowolną aplikację (w tym agenta), która potrzebuje rozszerzyć ustawienia środowiska lub listę aliasów aplikacji zdefiniowaną w pliku serviceconfig.xml. Słowo "plugin" w nazwie pliku może w tym przypadku być mylące, gdyż aplikacja nie musi mieć formy wtyczki Eclipse (choć takie było pierwotne przeznaczenie tego mechanizmu). 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 podktalogu \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, 2006 Intel Corporation.