Angepasste Plug-ins konfigurieren, die für Agent Controller implementiert wurden

Angepasste Plug-ins können für Agent Controller implementiert und auf fernen Hosts ausgeführt werden. Die Plug-ins werden im Verzeichnis plugin des Installationsverzeichnisses von Agent Controller installiert. Jedes Plug-in verfügt über seine eigene Datei pluginconfig.xml, in der die Einstellungen der Ausführungsumgebung und der Anwendungsumgebung, in der das Plug-in ausgeführt werden soll, angegeben werden.

Ausführungsumgebung konfigurieren

Die Ausführungsumgebung für angepasste Plug-ins sollte eine angepasste Klassenpfaddefinition enthalten. Hierdurch wird sichergestellt, dass nur die erforderlichen JAR-Dateien für das angepasste Plug-in ausgeführt werden. Gehen Sie folgendermaßen vor, um die Ausführungsumgebung anzupassen:

  1. Finden Sie die Konfigurationsdatei pluginconfig.xml für das angepasste Plug-in. Diese befindet sich normalerweise im Installationsverzeichnis von Agent Controller unter /plugin/<angepasstes_plugin>/, wobei angepasstes_plugin der Name des Plug-in-Verzeichnisses ist.
  2. Öffnen Sie die Datei in einem Editor und suchen Sie nach dem Element <AgentControllerEnvironment>. Wenn dieses Element nicht existiert, so erstellen Sie es.
  3. Fügen Sie das Unterelement <Variable> hinzu. Geben Sie den Namen des Attributs Name im Format KLASSENPFAD_<org>_<myapp>, wobei org_myapp der Name des Plug-in-Verzeichnisses ist. Hierbei wird der Punkt '.' durch ein Unterstreichungszeichen ersetzt '_'. Geben Sie den Wert des AttributsPosition als 'anhängen' an. Geben Sie für das Attribut value die JAR-Datei im Verzeichnis des angepassten Plug-ins an. Im folgenden Beispiel wird ein angepasstes Element <AgentControllerEnvironment> dargestellt:
    <AgentControllerEnvironment configuration="default">
      <Variable name="CLASSPATH_ORG_MYAPP" position="append" value="%PLUGINS_HOME%/org.myapp/one.jar"/>
      <Variable name="CLASSPATH_ORG_MYAPP" position="append" value="%PLUGINS_HOME%/org.myapp/two.jar"/>
      <Variable name="CLASSPATH_ORG_MYAPP" position="append" value="%PLUGINS_HOME%/org.myapp/three.jar"/>
    </AgentControllerEnvironment>
    
    
  4. Speichern Sie die Änderungen.
  5. Starten Sie Agent Controller erneut.

    Hinweis: Der Umgebung kann eine beliebige Anzahl <Variable>-Elemente hinzugefügt werden.  Dabei gilt für die Regeln die Bedienungsreihenfolge der Erstkommenden.

Anwendungsumgebung konfigurieren

Die Anwendungsumgebung eines Plug-ins wird im Element <Anwendung > in der Datei pluginconfig.xml definiert. Diese Einstellungen in diesem Element sind nur für die Anwendung sichtbar. Über das Element<Anwendung> können Sie Ihre Anwendung auch so konfigurieren, das sie JAR-Dateien aus anderen Anwendungen verwendet, die für Agent Controller implementiert sind. Gehen Sie folgendermaßen vor, um die Anwendungsumgebung zu konfigurieren:

  1. Finden Sie die Konfigurationsdatei pluginconfig.xml für das angepasste Plug-in. Diese befindet sich normalerweise im Installationsverzeichnis von Agent Controller unter /plugin/<angepasstes_plugin>/, wobei angepasstes_plugin der Name des Plug-in-Verzeichnisses ist.
  2. Öffnen Sie die Datei in einem Editor und suchen Sie nach dem Element <Anwendung>. Das Element sollte folgendermaßen definiert werden:
    <Application configuration="default" executable="myapp2" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%">
    </Application>
    
    Hierbei gilt folgendes:
  3. Indem Sie das Unterelement Variable hinzufügen, können Sie Ihre Anwendung so konfigurieren, dass Sie JAR-Dateien von anderen Anwendungen verwendet. Geben Sie den Wert des Attributs name als CLASSPATH an. Geben Sie für den Wert des Attributs position die Ausführungsumgebung an. Geben Sie für das Attribut value das Plug-in-Verzeichnis der anderen Anwendung an, die Sie verwenden möchten. Im folgenden Beispiel wird eine Datei pluginconfig.xml für myapp2 dargestellt, die JAR-Dateien aus einer anderen Ausführungsumgebung namens org.myapp verwendet.
    <?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. Speichern Sie die Änderungen.
  5. Starten Sie Agent Controller erneut.

Verwandte Aufgaben
Konfigurationsdateien lokalisieren
Agent Controller verwalten
 


(C) Copyright IBM Corporation 2000, 2006. Alle Rechte vorbehalten.