Konfigurowanie niestandardowych wtyczek wdrożonych w komponencie Agent Controller

Niestandardowe wtyczki mogą być wdrażane w komponencie Agent Controller i uruchamiane na zdalnych hostach. Wtyczki są instalowane w katalogu plugin w katalogu instalacyjnym komponentu Agent Controller. Każda wtyczka ma własny plik pluginconfig.xml określający ustawienia środowiska wykonawczego i środowiska aplikacji, w którym dana wtyczka powinna być uruchamiana.

Konfigurowanie środowiska wykonawczego

Środowisko wykonawcze dla wtyczek niestandardowych powinno zawierać własną definicję ścieżki klasy. Dzięki temu uruchamiane będą tylko pliki JAR wymagane przez daną wtyczkę niestandardową. Aby dostosować środowisko wykonawcze, wykonaj następujące czynności:

  1. Znajdź plik konfiguracyjny pluginconfig.xml dla wtyczki niestandardowej. Plik ten znajduje się zwykle w katalogu instalacyjnym komponentu Agent Controller w podkatalogu /plugin/<wtyczka_niestandardowa>/, gdzie wtyczka_niestandardowa to nazwa katalogu wtyczki.
  2. Otwórz plik w edytorze i znajdź element <AgentControllerEnvironment>.Jeśli element ten nie istnieje, utwórz go.
  3. Dodaj podelement <Variable>. Określ wartość atrybutu name w formacie CLASSPATH_<org>_<myapp>, gdzie org_myapp jest nazwą katalogu wtyczki z kropką "." zastąpioną znakiem podkreślenia "_". Ustaw wartość atrybutu position na "append". Ustaw atrybut value na plik JAR w katalogu wtyczki niestandardowej. Poniżej przedstawiono przykład dostosowanego elementu <AgentControllerEnvironment>:
    <AgentControllerEnvironment configuration="default">
      <Variable name="CLASSPATH_ORG_MYAPP" position="append" value="%PLUGINS_HOME%/org.myapp/jeden.jar"/>
      <Variable name="CLASSPATH_ORG_MYAPP" position="append" value="%PLUGINS_HOME%/org.myapp/dwa.jar"/>
      <Variable name="CLASSPATH_ORG_MYAPP" position="append" value="%PLUGINS_HOME%/org.myapp/trzy.jar"/>
    </AgentControllerEnvironment>
    
    
  4. Zapisz zmiany.
  5. Zrestartuj komponent Agent Controller.

    Uwaga: W środowisku można zdefiniować dowolną liczbę elementów <Variable>. Przetwarzanie reguł odbywa się w kolejności ich wprowadzania.

Konfigurowanie środowiska aplikacji

Środowisko aplikacji dla wtyczki jest definiowane za pomocą elementu <Application> w pliku pluginconfig.xml. Zawarte tam ustawienia są widoczne tylko dla danej aplikacji. Element <Application> można też wykorzystać do takiego skonfigurowania aplikacji, aby korzystała ona z plików JAR z innych aplikacji wdrożonych w komponencie Agent Controller. Aby skonfigurować środowisko aplikacji, wykonaj następujące czynności:

  1. Znajdź plik konfiguracyjny pluginconfig.xml dla wtyczki niestandardowej. Plik ten znajduje się zwykle w katalogu instalacyjnym komponentu Agent Controller w podkatalogu /plugin/<wtyczka_niestandardowa>/, gdzie wtyczka_niestandardowa to nazwa katalogu wtyczki.
  2. Otwórz plik w edytorze i znajdź element <Application>. Element należy zdefiniować w następujący sposób:
      <Application configuration="default" executable="myapp2" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%">
    </Application>
    
    gdzie
  3. Aby skonfigurować aplikację do użycia plików JAR z innych aplikacji, dodaj podelement Variable. Ustaw wartość atrybutu name na CLASSPATH. Ustaw wartość atrybutu position na środowisko wykonawcze. Ustaw atrybut value na katalog wtyczki innej aplikacji, który ma być użyty. Poniżej przedstawiono przykład pliku pluginconfig.xml dla aplikacji myapp2, która korzysta z plików JAR z innego środowiska wykonawczego o nazwie org.myapp.
    <?xml version="1.0" encoding="UTF-8"?>
    <PluginConfiguration>
      <Application configuration="default" executable="myapp2" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%">
        <Variable name="CLASSPATH" position="append" value="%CLASSPATH_ORG_MYAPP%"/>
      </Application>
      <Option name="my.proj2" type="version" value="1.0.0"/>
    </PluginConfiguration>
    
  4. Zapisz zmiany.
  5. Zrestartuj komponent Agent Controller.

Czynności pokrewne
Określanie położenia plików konfiguracyjnych
Administrowanie komponentem Agent Controller
 


(C) Copyright IBM Corporation 2000, 2006. Wszelkie prawa zastrzeżone.