I.18 Gestion de la consignation des erreurs dans eDirectory

La consignation des erreurs démarre automatiquement pendant l'installation d'eDirectory.

Niveaux de gravité des messages

Tous les messages sont associés à un niveau de gravité qui permet de déterminer leur caractère critique.

Message d'erreur	Description
Fatal: Un message fatal indique un problème important, comme la perte de données ou de fonctionnalité.	Exemples : Si le serveur eDirectory ne parvient pas à charger des modules système comme NCPEngine et DSLoader pendant le chargement de modules, une erreur fatale est signalée et consignée. Si le serveur eDirectory ne parvient pas à établir une connexion sur le port sécurisé 636, une erreur fatale est signalée et consignée.
Avertissement : Message qui n'est pas nécessairement grave, mais qui peut engendrer un problème ultérieurement.	Exemples : Échecs de connexion entre deux serveurs quelconques de l'arborescence, engendrant l'ajout d'un serveur dans un cache d'adresses erronées. Le serveur peut quitter cet état spécifique après réinitialisation du cache d'adresses erronées. Si l'application client LDAP établit une liaison et met fin à la connexion sans annuler la liaison, le serveur LDAP consigne un avertissement avec le message correspondant. Si le serveur eDirectory a utilisé tous les descripteurs de fichier et a atteint la limite Seuil, il ne peut pas traiter les requêtes entrantes ni y répondre, ce qui entraîne un échec de l'application.
Erreur : Message qui peut être dû à une opération non valide, mais qui ne cause aucun problème.	Exemples : Lorsqu'une application client tente d'ajouter un objet pour lequel les attributs ne sont pas définis dans le schéma, le serveur eDirectory signale l'erreur ERR_NO_SUCH_ATTRIBUTE. Lorsqu'un utilisateur tente de se connecter avec un mot de passe non valide, le serveur eDirectory renvoie l'erreur ERR_FAILED_AUTHENTICATION.
Informations : Message qui décrit l'aboutissement d'une opération ou d'un événement dans le serveur eDirectory.	Exemples : Lorsque le chargement/déchargement d'un module aboutit, il peut s'avérer approprié de consigner un message d'information concernant l'opération. Si la configuration du cache de base de données est modifiée, un message d'information devrait être consigné lors de la réussite de l'enregistrement de cette configuration.
Débogage : Message contenant des informations qui aideront les développeurs à déboguer un programme.	Exemples : Lors d'une recherche de groupe dynamique, le message affiche tous les membres de ce groupe avec des informations sur l'ID d'entrée, l'ID de partition et le DN des membres. Ces informations contribuent à déterminer si tous les membres sont renvoyés au niveau eDirectory.

Configuration de la consignation des erreurs

Définition du niveau de gravité sous Linux : Afin de configurer les paramètres de consignation des erreurs pour les messages côté serveur, vous pouvez utiliser les paramètres n4u.server.log-levels et n4u.server.log-file du fichier de configuration /etc/opt/novell/eDirectory/conf/nds.conf.

Les niveaux de gravité disponibles sont LogFatal, LogWarn, LogErr, LogInfo et LogDbg (par ordre décroissant de gravité). Pour plus d'informations sur les niveaux de gravité, reportez-vous à la section Niveaux de gravité des messages.

Le niveau de gravité par défaut est LogFatal. Dès lors, seuls les messages dont le niveau de gravité est fatal seront consignés.

Pour définir le niveau de gravité, utilisez le paramètre n4u.server.log-levels dans le fichier nds.conf comme suit :

n4u.server.log-levels=niveau_gravité

Par exemple :

Pour définir la gravité sur le niveau LogInfo et les niveaux supérieurs, entrez la commande suivante :
```
n4u.server.log-levels=LogInfo
```
Avec cette configuration, les messages de niveaux de gravité LogInfo et supérieurs (c'est-à-dire LogFatal, LogWarn et LogErr) sont consignés dans le fichier journal.
Pour définir la gravité sur le niveau LogWarn et les niveaux supérieurs, entrez la commande suivante :
```
n4u.server.log-levels=LogWarn
```
Avec cette configuration, les messages de niveaux de gravité LogWarn et supérieurs (LogFatal) sont consignés dans le fichier journal.

Indication du nom du fichier journal sous Linux : pour spécifier l'emplacement du fichier journal où les messages sont consignés, utilisez le paramètre n4u.server.log-file dans le fichier nds.conf. Par défaut, les messages sont consignés dans le fichier ndsd.log.

Par exemple, pour consigner les messages dans le fichier /tmp/edir.log, entrez la commande suivante :

n4u.server.log-file=/tmp/edir.log

Pour consigner les messages dans le journal système, utilisez le paramètre n4u.server.log-file comme suit :

n4u.server.log-file=syslog

Définition du niveau de gravité sous Windows

Les niveaux de gravité disponibles sont LogFatal, LogWarn, LogErr, LogInfo et LogDbg (par ordre décroissant de gravité). Pour plus d'informations sur les niveaux de gravité, reportez‑vous à la section Niveaux de gravité des messages.

Pour définir le niveau de gravité, procédez comme suit :

Cliquez sur Démarrer > Paramètres > Panneau de configuration > NetIQ eDirectory Services
Dans l'onglet Services, sélectionnez dhlog.dlm.
Entrez le niveau de consignation dans la zone Paramètres de démarrage.

Par exemple, pour définir la consignation sur le niveau LogErr et les niveaux supérieurs, entrez la commande suivante :
```
LogLevels=LogErr
```
Cliquez sur Configurer
Dans l'onglet Configuration ACS, cliquez sur le signe plus de DHostLogger.

Le paramètre LogLevel est actualisé avec la valeur configurée.

Indication du nom du fichier journal et du chemin sous Windows

Cliquez sur Démarrer > Paramètres > Panneau de configuration > NetIQ eDirectory Services
Dans l'onglet Services, sélectionnez dhlog.dlm.
Entrez le chemin du fichier journal dans la zone Paramètres de démarrage comme suit :
```
LogFile=file_path
```
Par exemple, pour définir le chemin du fichier journal sur /tmp/Err.log, entrez la commande suivante dans la zone Paramètres de démarrage :
```
LogFile=/tmp/Err.log
```
Cliquez sur Configurer
Dans l'onglet Configuration ACS, cliquez sur le signe plus de DHostLogger.

Le paramètre LogFile est actualisé avec la valeur configurée.

Indication de la taille du fichier journal sous Windows

Cliquez sur Démarrer > Paramètres > Panneau de configuration > NetIQ eDirectory Services
Dans l'onglet Services, sélectionnez dhlog.dlm.
Entrez le chemin du fichier journal dans la zone Paramètres de démarrage comme suit :
```
LogSize=size
```
La taille du fichier par défaut est de 1 Mo.
Cliquez sur Configurer
Dans l'onglet Configuration ACS, cliquez sur le signe plus de DHostLogger.

Le paramètre LogSize est actualisé avec la valeur configurée.