Konfigurationsdateien von Agent Controller

Die Konfiguration von Agent Controller wird mit zwei Gruppen von Konfigurationsdateien festgelegt. Die erste Gruppe ist die Basiskonfiguration, die die Standardeinstellungen der Steuerkomponente beschreibt. Die zweite Gruppe ist die Plug-in-Konfiguration, die die anwendungsspezifischen Einstellungen der Steuerkomponente beschreibt. In diesem Dokument werden die Details der einzelnen Konfigurationen und die Vorgehensweise zum Schreiben von Konfigurationserweiterungen beschrieben.

Das in diesem Dokument erwähnte Verzeichnis <installationsverzeichnis>, entspricht dem Pfad, in dem Agent Controller entpackt wird. Dieses Verzeichnis wird in den Konfigurationsdateien auch als %RASERVER_HOME% bezeichnet.

Basiskonfiguration

Die Basiskonfiguration besteht aus der Datei <installationsverzeichnis>/config/serviceconfig.xml, die mit dem XML-Schema <installationsverzeichnis>/config/serviceconfig.xsd erstellt wird. Damit werden die Standardeinstellungen wie die Systemumgebungsvariablen, die Anwendungskonfigurationen und die Konnektivität von Agent Controller festgelegt. Die Basiskonfiguration steht allen Konfigurationen zur Verfügung und wird beim Start des Steuerkomponentenservice geladen. Anwendungsentwickler sollten diese Basiskonfigurationsdateien nicht ändern, da sich alle Änderungen in der Basiskonfiguration global auswirken. Zum Festlegen von Plug-in- und anwendungsspezifischen Einstellungen sollten die (nachstehend beschriebenen) Plug-in-Konfigurationen verwendet werden.

Plug-in-Konfiguration

Die Konfigurationsdatei und die Abhängigkeiten der einzelnen benutzerdefinierten Anwendungen sollten im Plug-in-Verzeichnis <installationsverzeichnis>/plugin/<plug-in-name> platziert werden. Dabei steht <plug-in-name> für einen eindeutigen Namen zur Kennzeichnung der Anwendung. Die Plug-in-Konfigurationsdatei pluginconfig.xml sollte im Unterverzeichnis config des Plug-in-Verzeichnisses platziert werden. In der Regel werden JAR-Dateien im Unterverzeichnis lib des Plug-in-Verzeichnisses platziert. Entwickler können das XML-Schema <installationsverzeichnis>/config/pluginconfig.xsd zu Hilfe nehmen, um die Plug-in-Konfigurationsdatei zu erstellen.

Elemente und Attribute

Element: AgentControllerConfiguration
Das Stammelement der Basiskonfiguration. Die Einstellungen werden zum Start des Steuerkomponentenservice verwendet.

Verwendung durch: Basiskonfiguration

Unterelemente: AgentControllerEnvironment, Application, Hosts, Service, Agent, Option, Plugin

Attribute:
activeConfiguration
Gibt an, welche Konfiguration beim Start der Steuerkomponente geladen werden soll.
filePort
Gibt den Port an, an dem der Dateiübertragungsservice von Agent Controller empfangsbereit ist. Der Standardwert ist 10005.
isDataMultiplexed
Gibt an, ob Profilermittlungs- und Protokolldaten über den Steuerkanal von Agent Controller übertragen werden sollen. Standardmäßig verwendet der Datenkanal zur Datenübertragung einen beliebigen Port und wird beim Vorhandensein einer Firewall möglicherweise blockiert. Bei der Übertragung der Daten über den Steuerkanal können einige vordefinierte Ports für eingehende Verbindungsanforderungen durch eine Firewall geöffnet werden. Dies sind der Standardport 10002, der sichere Port 1003 und der Dateiserverport 10005. Der Standardwert für dieses Attribut lautet 'false'.
jvm
Der vollständig qualifizierte Pfad zur dynamischen Laufzeitbibliothek der Java Virtual Machine (jvm.dll oder libjvm.so).
loggingDetail
Aktiviert bei der Angabe von 'HIGH' die Zeilennummerprotokollierung der Steuerkomponente.
loggingDirectory
Das Verzeichnis, in dem die Protokolldatei servicelog.log der Steuerkomponente erstellt wird.
loggingLevel
Der Schweregradfilter für Protokollnachrichten.
port
Der Port der Steuerkomponente, der für eingehende, nicht gesicherte Clientverbindungen empfangsbereit ist.
processPolling
Gibt an, ob die aktive Prozess-Statusprüfung aktiviert ist oder nicht. Dieses Attribut wird hauptsächlich auf Windows-Systemen verwendet, um sicherzustellen, dass Agent Controller über den Abschluss eines Prozesses benachrichtigt wird. Der Standardwert ist 'true'.
securedPort
Der Port der Steuerkomponente, der für eingehende, gesicherte Clientverbindungen empfangsbereit ist.
version
Die Version der Steuerkomponente.

Element: PluginConfiguration
Das Stammelement der Plug-in-Konfiguration. Die Einstellungen werden nach dem Laden der Basiskonfiguration geladen.

Verwendung durch: Plug-in-Konfiguration

Unterelemente: AgentControllerEnvironment, Application, Service, Agent, Option

Attribute:
requires
Eine durch Kommata getrennte Liste mit Plug-in-Namen, von denen die Konfiguration abhängt.

Element: AgentControllerEnvironment
Ein Platzhalter für globale Umgebungsvariablen, die von dieser Konfiguration bereitgestellt werden. Diese werden für das System veröffentlicht und stehen allen anderen Konfigurationen einschließlich der Basiskonfiguration zu Verfügung.

Verwendung durch: AgentControllerConfiguration, PluginConfiguration

Unterelemente: Variable

Attribute:
configuration
Der Name der Konfiguration, der die Umgebungsvariablen hinzugefügt werden sollen.

Element: Application
Ein Platzhalter für eine anwendungsspezifische Umgebung. Die enthaltenen Einstellungen sind nur für die betreffende Anwendung einsehbar.

Verwendung durch: AgentControllerConfiguration, PluginConfiguration

Unterelemente: Variable, Parameter

Attribute:
configuration
Der Name der Konfiguration, der die Anwendung hinzugefügt werden soll.
executable
Der Name der Anwendung. Clients müssen diesen Namen zur Angabe der Anwendung verwenden.
path
Der vollständig qualifizierte Pfad des Programms, das diese Anwendung ausführen sollte.
location
Das Arbeitsverzeichnis dieser Anwendung.
extends
Der Konfigurationsname, mit dem diese Anwendung bereits definiert wurde. Dadurch werden zusätzlich die aktuellen Einstellungen hinzugefügt.

Element: Hosts
Ein Platzhalter für Hostangaben. Wird von der Steuerkomponente dazu verwendet, bestimmten Hosts das Herstellen einer Verbindung zu gestatten bzw. zu untersagen.

Verwendung durch: AgentControllerConfiguration

Unterelemente: Allow, Deny

Attribute:
configuration
Der Name der Konfiguration, mit der diese Hostangaben verwendet werden.

Element: Allow
Gibt an, welche Hosts eine Verbindung mit der Steuerkomponente herstellen dürfen.

Verwendung durch: Hosts

Attribute:
host
Der Name oder die IP-Adresse des Hosts.
net
Das Teilnetz.
mask
Die Teilnetzmaske.
Element: Deny
Gibt an, welche Hosts keine Verbindung mit der Steuerkomponente herstellen dürfen.

Verwendung durch: Hosts

Attribute:
host
Der Name oder die IP-Adresse des Hosts.
net
Das Teilnetz.
mask
Die Teilnetzmaske.

Element: Service
Gibt an, welche Benutzer das beim Start der Steuerkomponente zu ladende Modul definiert hat.

Verwendung durch: AgentControllerConfiguration, PluginConfiguration

Unterelemente: Option

Attribute:
configuration
Der Name der Konfiguration, für die dieser Service geladen werden soll.
name
Der Name des Service.
path
Der vollständig qualifizierte Pfad der dynamischen Ladungsbibliothek.


Element: Agent
Gibt agentenspezifische Informationen an.

Verwendung durch: AgentControllerConfiguration, PluginConfiguration

Unterelemente: Option

Attribute:
configuration
Der Name der Konfiguration, mit der diese Agentenkonfiguration verwendet wird.
name
Der Name des Agenten.
type
Der Typ des Agenten.
dataChannelSize
Die Menge des gemeinsam genutzten Speichers, der für die Interprozesskommunikation zugeordnet werden soll.
logFile
Der vollständig qualifizierte Pfad der Protokolldatei, in der die vom Agenten gesendeten Nachrichten aufgezeichnet werden.
client
Gibt an, ob dieser Agent dynamisch ist oder über eine Befehlszeile ausgeführt wird.
Element: Option
Wird zum Speichern von Name/Wert-Paaren verwendet. Verwendung durch: AgentControllerConfiguration, PluginConfiguration, Service, Agent Attribute:
name
Der Name der Option (z. B. namespace).
type
Der Typ der Option (z. B. option name).
value
Der Wert der Option.


Element: Plugin
Gibt das Verzeichnis an, in dem nach Plug-in-Konfigurationen gesucht werden soll.

Verwendung durch: AgentControllerConfiguration

Attribute:
path
Der vollständig qualifizierte Pfad zu dem Verzeichnis, in dem nach Plug-in-Konfigurationen gesucht werden soll.

Element: Variable
Die Umgebungsvariable.

Verwendung durch: Application, AgentControllerEnvironment

Attribute:
name
Der Name der Umgebungsvariablen (z. B. CLASSPATH).
value
Der Wert der Umgebungsvariablen.
position
Gibt an, ob dieser Wert an den vorhandenen Wert angehängt oder ihm vorangestellt wird oder ihn ersetzt.
Element: Parameter
Der Programmparameter.

Verwendung durch: Application

Attribute:
value
Der Wert des Programmparameters.
position
Gibt an, ob dieser Parameter an den vorhandenen Parameter angehängt oder ihm vorangestellt wird oder ihn ersetzt.



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