Fichiers de configuration d'Agent Controller

La configuration d'Agent Controller est définie par deux ensembles de fichiers de configuration. Le premier ensemble est la configuration de base qui décrit les paramètres par défaut du moteur. Le deuxième est la configuration du plug-in qui décrit les paramètres spécifiques à l'application du moteur. Le présent document décrit de manière détaillée chaque configuration et indique comment rédiger des extensions de configuration.

Le répertoire <répertoire d'installation> indiqué dans ce document correspond au chemin dans lequel se trouvent les fichiers Agent Controller. Dans les fichiers de configuration %RASERVER_HOME% fait également référence à ce répertoire.

Configuration de base

La configuration de base est composée du fichier <répertoire d'installation>/config/serviceconfig.xml généré à l'aide du schéma XML <répertoire d'installation>/config/serviceconfig.xsd. Ce fichier définit les paramètres par défaut, tels que les variables d'environnement système, les configurations d'applications et la connectivité d'Agent Controller. La configuration de base sera disponible pour toutes les configurations et est chargée lors du démarrage du service du moteur. Les développeurs d'application ne doivent pas modifier ce fichier de configuration de base car toute modification effectuée dans la configuration de base sera globale. Les configurations de plug-in (décrites ci-dessous) doivent être utilisées pour spécifier les paramètres spécifiques à l'application et au plug-in.

Configuration du plug-in

Chaque application définie par l'utilisateur doit disposer de son propre fichier de configuration et de dépendances se trouvant dans le répertoire du plug-in <répertoire d'installation>/plugin/<nom du plug-in><nom du plug-in> correspond à un nom unique qui identifie l'application. Le fichier de configuration du plug-in pluginconfig.xml doit se trouver dans le sous-répertoire config du répertoire du plug-in. Généralement, les fichiers JAR se trouvent dans le sous-répertoire lib du répertoire du plug-in. Les développeurs peuvent utiliser le schéma XML <répertoire d'installation>/config/pluginconfig.xsd afin de créer plus facilement le fichier de configuration du plug-in.

Eléments et attributs

Elément : AgentControllerConfiguration
Elément principal de la configuration de base. Les paramètres permettent de démarrer le service du moteur.

Utilisé par : Configuration de base

Sous-éléments : AgentControllerEnvironment, Application, Hosts, Service, Agent, Option, Plugin

Attributs :
activeConfiguration
Indique la configuration à charger lors du démarrage du moteur
filePort
spécifiez le port que le service de transfert de fichiers d'Agent Controller écoute. La valeur par défaut est 10005.
isDataMultiplexed
spécifiez si des données de profilage et de journalisation doivent être transmises par le canal de contrôle d'Agent Controller. Par défaut, le canal de données utilise un port arbitraire pour la transmission de données et peut être bloqué par l'existence d'un pare-feu. Transférer les données par le canal de contrôle permet d'ouvrir un ensemble de ports prédéfinis pour les demandes de connexion entrantes au travers d'un pare-feu. Ces ports comportent le port par défaut 10002, le port sécurisé 1003 et le port du serveur de fichiers 10005. La valeur par défaut de cet attribut est false.
jvm
Chemin complet de la bibliothèque d'exécution dynamique (jvm.dll ou libjvm.so) de la machine JVM (Java Virtual Machine)
loggingDetail
Active la journalisation du numéro de ligne du moteur si HIGH est indiqué
loggingDirectory
Répertoire dans lequel le fichier journal du moteur servicelog.log est créé
loggingLevel
Filtre de gravité des messages journaux
port
Port du moteur pour l'écoute de la connexion client non sécurisée entrante
processPolling
spécifiez si vous souhaitez activer ou non le contrôle actif de l'état des processus. Cet attribut est principalement utilisé sur les systèmes Windows pour s'assurer qu'Agent Controller est prévenu chaque fois qu'un processus s'arrête. La valeur par défaut est true.
securedPort
Port du moteur pour l'écoute de la connexion client sécurisée entrante
version
version du moteur

Elément : PluginConfiguration
Elément principal de la configuration du plug-in. Les paramètres sont chargés une fois la configuration de base chargée.

Utilisé par : Configuration du plug-in

Sous-éléments : AgentControllerEnvironment, Application, Service, Agent, Option

Attributs :
requiert
une liste des noms de plug-in dont dépend cette configuration. Chaque élément de la liste est séparé par une virgule.

Elément : AgentControllerEnvironment
Signet indiquant l'emplacement des variables d'environnement globales fournies par cette configuration. Elles sont publiées sur le système et toutes les autres configurations peuvent y accéder, y compris la configuration de base.

Utilisé par : AgentControllerConfiguration, PluginConfiguration

Sous-éléments : Variable

Attributs :
configuration
nom de la configuration dans laquelle les variables d'environnement doivent être ajoutées

Elément : Application
Signet indiquant l'emplacement de l'environnement spécifique à l'application. Les paramètres de l'environnement sont visibles uniquement dans cette application particulière.

Utilisé par : AgentControllerConfiguration, PluginConfiguration

Sous-éléments : Variable, Parameter

Attributs :
configuration
nom de la configuration dans laquelle l'application doit être ajoutée
exécutable
nom de l'application. Les clients doivent utiliser ce nom pour identifier cette application
chemin
chemin complet du programme que cette application doit exécuter
emplacement
répertoire de travail de cette application
étend
nom de la configuration pour laquelle la même application est déjà définie. Ajoute les paramètres en cours dans la partie supérieure

Elément : Hosts
Signet indiquant l'emplacement des informations d'hôte. Permet au moteur de permettre ou de refuser la connexion de certains hôtes.

Utilisé par : AgentControllerConfiguration

Sous-éléments : Allow, Deny

Attributs :
configuration
nom de la configuration utilisée par les informations d'hôte

Elément : Allow
Indique quel hôte est autorisé à se connecter au moteur.

Utilisé par : Hosts

Attributs :
hôte
nom ou adresse IP de l'hôte
net
sous-réseau
masque
masque de sous-réseau
Elément : Deny
Indique quel hôte n'est pas autorisé à se connecter au moteur.

Utilisé par : Hosts

Attributs :
hôte
nom ou adresse IP de l'hôte
net
sous-réseau
masque
masque de sous-réseau

Elément : Service
Indique quel module défini par l'utilisateur à charger lors du démarrage du moteur.

Utilisé par : AgentControllerConfiguration, PluginConfiguration

Sous-éléments : Option

Attributs :
configuration
nom de la configuration avec laquelle ce service doit être chargé
nom
nom du service
chemin
chemin complet de la bibliothèque de chargement dynamique


Elément : Agent
Indique les informations spécifiques à l'agent.

Utilisé par : AgentControllerConfiguration, PluginConfiguration

Sous-éléments : Option

Attributs :
configuration
nom de la configuration avec laquelle cette configuration d'agent est utilisée
nom
nom de l'agent
type
type de l'agent
dataChannelSize
quantité de mémoire partagée à allouer pour les communications entre les processus
Fichier journal
chemin complet du fichier journal dans lequel l'agent place les messages
client
indique si cet agent est dynamique ou sans en-tête
Elément : Option
Permet de stocker une paire nom-valeur. Utilisé par : AgentControllerConfiguration, PluginConfiguration, Service, Agent Attributs :
nom
nom de l'option (c'est-à-dire espace de nom)
type
type de l'option (c'est-à-dire nom de l'option)
valeur
valeur de l'option


Elément : Plugin
Indique le répertoire dans lequel rechercher des configurations de plug-in

Utilisé par : AgentControllerConfiguration

Attributs :
chemin
répertoire complet dans lequel rechercher des configurations de plug-in

Elément : Variable
Variable d'environnement.

Utilisé par : Application, AgentControllerEnvironment

Attributs :
nom
nom de la variable d'environnement (par exemple, CLASSPATH)
valeur
valeur de la variable d'environnement
emplacement
indique si cette valeur doit être ajoutée, ajoutée au début ou si elle doit remplacer la valeur existante
Elément : Parameter
Paramètre du programme.

Utilisé par : Application

Attributs :
valeur
valeur du paramètre de programme
emplacement
indique si ce paramètre doit être ajouté, ajouté au début ou s'il doit remplacer le paramètre existant



(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.