Configuration Agent

Configuration Agent est un élément intégré aux différents packages répertoriés dans le tableau suivant :

Lorsque vous installez ces packages, les fichiers requis par cette API sont installés. Vous pouvez installer les packages manuellement ou par le biais de l'installation Java Desktop System. Une fois l'installation terminée, vous devez configurer et activer Configuration Agent sur votre système.

Pour accéder aux données de configuration distantes, Configuration Agent a besoin de quelques informations d'initialisation, telles que le nom d'hôte et le port du serveur LDAP. Ces informations figurent dans un ensemble de fichiers de propriétés, notamment policymgr.properties, apocd.properties et os.properties. Ces fichiers sont stockés localement dans le répertoire /etc/apoc. Vous pouvez modifier ces fichiers de propriétés manuellement ou utiliser l'assistant de configuration de Configuration Agent.

L'assistant de configuration intègre une interface graphique utilisateur qui vous guide dans les paramètres requis de Configuration Agent. Un écran d'aide est disponible pour chaque page de l'assistant. Vous pouvez lancer l'assistant en tant que super utilisateur (racine) par le biais du script /usr/bin/apoc-config. Une entrée de menu est également disponible sur le bureau sous Préférences/Système/Paramètres réseau ou sous Matériel///Carte réseau dans le gestionnaire de fichiers Nautilus.

Vous pouvez également démarrer l'assistant sans lancer l'interface graphique. Par exemple, exécutez /usr/bin/apoc-config -nodisplay pour démarrer l'assistant en mode console.

Informations d'initialisation

Figure 5–1 Configuration Agent, référentiel de configuration

Les clés du fichier de propriétés associées sont indiquées entre parenthèses, le cas échéant.

• Identificateur du serveur (Server) : nom d'hôte du serveur LDAP.

• Port du serveur (Port) : numéro de port du serveur LDAP.

• Suffixe (BaseDn) : DN de base du référentiel LDAP.

• État : état de Configuration Agent. La case à cocher peut être utilisée pour activer ou désactiver Configuration Agent. Pour pouvoir utiliser le référentiel de configuration, Configuration Agent doit être actif. L'activation inclut automatiquement l'enregistrement nécessaire avec inetd.

  ---

  Remarque –

  Pour activer ou désactiver manuellement Configuration Agent, connectez-vous en tant que racine et tapez la commande /usr/lib/apocd enable ou /usr/lib/apocd disable.

  ---

Figure 5–2 Configuration Agent, mécanisme d'authentification

• Identificateur de l'hôte (HostIdentifier) : peut être “HostName” ou “IPAddress”. L'identificateur défini doit être configuré pour correspondre au contenu de l'attribut LDAP utilisé pour identifier les hôtes. Cet attribut est défini dans les fichiers de mappage sous la forme Host/UniqueIdAttribute.

• Type d'authentification de Configuration Agent : peut être “Anonyme” ou “Simple”. Si vous sélectionnez “Anonyme”, les champs Nom d'utilisateur complet et Mot de passe sont automatiquement désactivés.

• Nom d'utilisateur complet (AuthDn) : DN complet d'un utilisateur ayant des droits d'accès en lecture et en recherche dans le référentiel.

• Mot de passe (Password) : mot de passe d'un utilisateur LDAP enregistré.

  ---

  Remarque –

  Si l'accès anonyme est activé dans le répertoire, les paramètres Nom d'utilisateur complet et Mot de passe peuvent rester vierges.

  ---

• Type d'authentification pour les applications (AuthType) : peut être “Anonyme” ou “GSSAPI”, selon le mode d'authentification des utilisateurs employé par le serveur LDAP.

  ---

  Remarque –

  Pour plus d'informations, reportez-vous aux sections Accès aux données / Authentification des utilisateurs.

  ---

Paramètres de port

Configuration Agent utilise deux ports :

• Port de l'agent (DaemonPort) : utilisé par l'agent pour communiquer avec les applications clientes (la valeur par défaut est 38900).

• Port d'administration (DaemonAdminPort) : utilisé par le contrôleur de l'agent, apocd, pour communiquer avec l'agent (la valeur par défaut est 38901).

Figure 5–3 Configuration Agent, paramètres de port

Intervalle de détection des changements

Configuration Agent recherche régulièrement les changements apportés aux données de configuration en utilisant deux intervalles :

• Intervalle de détection général (ChangeDetectionInterval) : intervalle (en minutes) entre les cycles de détection des changements des données de configuration des applications (ou clients) de bureau.

  ---

  Remarque –

  Si vous indiquez la valeur -1, la détection des changements est désactivée.

  ---

• Intervalle pour les paramètres de l'agent (DaemonChangeDetectionInterval) : intervalle en minutes entre les cycles de détection des changements des paramètres de configuration propres à l'agent.

  ---

  Remarque –

  Si vous indiquez la valeur -1, la détection des changements est désactivée.

  ---

Vous pouvez utiliser l'intervalle de détection général pour affiner la propagation des modifications des données de configuration distantes sur les applications côté client. La valeur entrée pour ce paramètre correspond à la durée maximum (en minutes) qui s'écoule avant que les modifications apportées à distance ne se reflètent dans les applications clientes.

Si vous indiquez des valeurs peu élevées, l'activité de Configuration Agent et du serveur LDAP est augmentée. Vous devez donc ajuster avec précaution la valeur de ces paramètres. Par exemple, dans une phase de déploiement initial, vous pouvez définir une valeur égale à une minute de manière à pouvoir tester facilement l'impact de la configuration distante sur les applications clientes. Une fois le test terminé, rétablissez la valeur initiale du paramètre.

Paramètres de fonctionnement

Figure 5–4 Configuration Agent, répertoire de données

Vous pouvez configurer les paramètres suivants :

• Répertoire de données (DataDir) : répertoire utilisé pour stocker les données d'exécution. Le répertoire par défaut est /var/opt/apoc.

• Durée de stockage des données cachées (TimeToLive) : intervalle en minutes pendant lequel les données de configuration qui ne sont pas hors ligne demeurent dans la base de données locale.

Figure 5–5 Configuration Agent, gestion des demandes et enregistrement

• Cycle de libération de la mémoire (GarbageCollectionInterval) : intervalle en minutes entre les cycles de libération de la mémoire dans la base de données de configuration locale.

• Nombre maximal de threads des clients (MaxClientThreads) : nombre maximal de demandes des clients pouvant être traitées simultanément.

• Nombre maximal de connexions des clients (MaxClientConnections) : nombre maximal de connexions des clients.

• Taille maximale des demandes (MaxRequestSize) : taille maximale des demandes des clients.

• Délai d'expiration de connexion (ConnectTimeout) : indique l'intervalle accordé au serveur LDAP pour répondre à une demande de connexion. La valeur par défaut est une seconde.

• Niveau du journal (LogLevel) : niveau de détail dans les fichiers journaux des agents. Le niveau de détail d'enregistrement doit être une valeur cohérente avec les niveaux d'enregistrement des événements Java. Par ordre décroissant de gravité, ces niveaux sont :

  • GRAVE

  • AVERTISSEMENT

  • INFO

  • CONFIG

  • FIN

  • PLUS FIN

  • LE PLUS FIN

La plupart des paramètres de fonctionnement, à l'exception des paramètres Répertoire de données et Délai d'expiration de connexion, peuvent être gérés centralement à l'aide des stratégies correspondantes stockées sur le serveur LDAP. Si vous souhaitez utiliser cette fonction, n'adaptez pas les paramètres correspondants à l'aide de l'assistant. Utilisez plutôt les stratégies de Configuration Agent disponibles dans Configuration Manager pour spécifier centralement les paramètres de fonctionnement.

Application des paramètres de l'agent

À l'exception des paramètres “Répertoire de données” et “Délai d'expiration de connexion”, les paramètres de fonctionnement stockés sur le serveur LDAP par le biais de Configuration Manager prennent automatiquement effet lors du prochain cycle de détection des changements de la configuration de l'agent (voir DaemonChangeDetectionInterval).

Figure 5–6 Configuration Agent, résumé

Tous les paramètres modifiés en local nécessitent le rechargement ou le redémarrage de Configuration Agent. Cette opération s'effectue automatiquement si vous utilisez l'assistant de configuration.

Pour redémarrer manuellement Configuration Agent, assurez-vous qu'aucune application client n'est en cours d'exécution, connectez-vous en tant que racine, puis tapez la commande /usr/lib/apoc/apocd restart.