Novell Documentation: eDirectory 8.8 - Utilisation de ndstrace

Utilisation de ndstrace

L’utilitaire ndstrace comporte trois parties principales :

Fonctions de base

Les fonctions de base de ndstrace permettent d'effectuer les opérations suivantes :

afficher l'état de l'écran ndstrace sous Linux, Solaris, AIX ou HP-UX ;
lancer des processus de synchronisation limités.

Pour afficher l’écran ndstrace, entrez la commande suivante à l’invite du serveur :

/opt/novell/eDirectory/bin/ndstrace

Pour lancer les fonctions de base de ndstrace, entrez les commandes correspondantes à l'invite du serveur en respectant la syntaxe suivante :

ndstrace option_commande

La table ci-dessous liste les options de commande que vous pouvez entrer.

Option	Description
ON	Affiche l'écran de trace eDirectory et présente les messages de trace élémentaires.
OFF	Désactive l'écran de trace.
ALL	Affiche l'écran de trace eDirectory et présente tous les messages de trace.
AGENT	Affiche l'écran de trace eDirectory et présente les messages de trace qui correspondent aux drapeaux ON, BACKLINK, DSAGENT, JANITOR, RESNAME et VCLIENT.
DEBUG	Active un ensemble prédéfini de messages de trace qui sont en général utilisés pour le débogage. Les drapeaux définis sont ON, BACKLINK, ERRORS, EMU, FRAGGER, INIT, INSPECTOR, JANITOR, LIMBER, MISC, PART, RECMAN, REPAIR, SCHEMA, SKULKER, STREAMS et VCLIENT.
NODEBUG	Ne désactive pas l'écran de trace, mais désactive tous les messages de débogage qui ont été définis précédemment. Cette option laisse également les messages définis sur l'option de commande ON.

Messages de débogage

Lorsque l'écran ndstrace est activé, les informations affichées sont fondées sur un ensemble de filtres par défaut. Pour obtenir un affichage plus ou moins détaillé que celui par défaut, vous pouvez modifier les filtres à l’aide des drapeaux des messages de débogage. Les messages de débogage aident à déterminer l'état de eDirectory ainsi qu'à vérifier si tout fonctionne normalement.

Chaque processus eDirectory comporte un ensemble de messages de débogage. Pour afficher les messages de débogage d'un processus particulier, utilisez le signe (+) ainsi que l'option ou le nom du processus. Pour désactiver l'affichage d'un processus, entrez le signe moins (-) ainsi que l'option ou le nom du processus. Voici quelques exemples :

Message	Description
set ndstrace = +SYNC	Active les messages de synchronisation.
set ndstrace = -SYNC	Désactive les messages de synchronisation.
set ndstrace = +SCHEMA	Active les messages du schéma.

Vous pouvez également combiner les drapeaux des messages de débogage à l’aide des opérateurs booléens & (qui signifie ET) et | (qui signifie OU). La syntaxe requise pour le contrôle des messages de débogage au niveau de la console du serveur est la suivante :

set ndstrace = +drapeau_trace [drapeau_trace]

set ndstrace = +drapeau_trace> [&drapeau_trace]

Le tableau ci-dessous décrit les drapeaux de trace pour les messages de débogage. Vous pouvez entrer une abréviation pour chacun des drapeaux de trace.

Drapeau de trace	Description
ABUF	Messages et informations liés aux tampons de paquets entrants et sortants qui contiennent des données reçues avec une requête eDirectory, ou en réponse à celle-ci.
ALOC	Messages qui affichent les détails de l'allocation de mémoire.
AREQ	Messages liés aux requêtes entrantes d'autres serveurs ou clients.
AUTH	Messages et rapports d'erreur liés à l'authentification.
BASE	Messages d'erreur de débogage au niveau de débogage minimal.
BLNK	Rapports d'erreur et messages de lien en amont et de notice nécrologique entrante.
CBUF	Messages liés aux requêtes sortantes du client DS.
CHNG	Messages du cache de changement.
COLL	Rapports d'état et d'erreur concernant les informations de mise à jour d'un objet lorsque la mise à jour a été reçue précédemment.
CONN	Messages qui affichent des informations sur les serveurs auxquels votre serveur essaie de se connecter, et sur les erreurs et les timeouts qui empêchent éventuellement ces connexions.
DNS	Messages sur les processus de serveur DNS intégrés dans eDirectory.
DRLK	Messages sur les liens de référence distribués.
DVRS	Messages qui affichent les zones propres au pilote DirXML^® sur lesquelles eDirectory est susceptible de fonctionner.
DXML	Messages qui affichent les détails des événements DirXML.
FRAG	Messages du fragmenteur NCP qui fractionne les messages eDirectory en messages au format NCP.
IN	Messages liés aux requêtes et processus entrants.
INIT	Messages liés à l'initialisation de eDirectory.
INSP	Messages liés à l'intégrité des objets dans la base de données locale du serveur source. L'emploi de ce drapeau entraîne une sollicitation accrue du système de stockage sur disque, de la mémoire et du processeur du serveur source. Ne laissez ce drapeau activé que si des objets sont altérés.
JNTR	Messages liés aux processus d'arrière-plan suivants : nettoyeur (janitor), synchronisation des répliques et gestionnaire d'attributs (flat cleaner).
LDAP	Messages liés au serveur LDAP.
LMBR	Messages liés au contrôle de la connectivité (processus limber).
LOCK	Messages liés à l'utilisation et à la manipulation des verrous de la base de données locale du serveur source.
LOST	Messages liés aux entrées perdues.
MISC	Messages provenant de différentes sources dans eDirectory.
MOVE	Messages provenant des opérations de déplacement de partition ou de sous-arborescence.
NCPE	Messages montrant le serveur qui reçoit les requêtes de niveau NCP.
NMON	Messages liés à iMonitor.
OBIT	Messages du processus de notice nécrologique.
PART	Messages liés aux opérations de partition lancées par les processus d'arrière-plan et par le traitement des requêtes.
PURG	Messages liés au processus de purge.
RECM	Messages liés à la manipulation de la base de données du serveur source.
RSLV	Rapports liés au traitement des requêtes de résolution de noms.
SADV	Messages liés à l'enregistrement des noms d'arborescence et des partitions auprès du protocole SLP (Service Location Protocol).
SCMA	Messages liés au processus de synchronisation du schéma.
SCMD	Messages qui affichent les détails des opérations liées au schéma. Ils fournissent des détails sur la synchronisation entrante et sortante.
SKLK	Messages liés au processus de synchronisation des répliques.
SPKT	Messages liés aux informations eDirectory au niveau du serveur NCP.
STRM	Messages liés au traitement des attributs à l'aide d'une syntaxe de flux.
SYDL	Messages qui affichent des informations complémentaires pendant le processus de réplication.
Option	Messages sur le trafic de synchronisation entrant (informations reçues par le serveur).
TAGS	Affiche la chaîne d'étiquettes qui identifie l'option de trace ayant généré l'événement spécifié sur chaque ligne affichée par le processus de trace.
THRD	Messages qui affichent le début et la fin des processus d'arrière-plan (threads).
TIME	Messages liés aux vecteurs de transition utilisés pendant le processus de synchronisation.
TVEC	Messages liés aux attributs suivants : Synchronisé jusqu'à, Réplique jusqu'à et Vecteur de transition.
VCLN	Messages liés à l'établissement ou à la suppression de connexions avec d'autres serveurs.

Lorsque vous utiliserez ces messages de débogage sous ndstrace, vous constaterez que certains drapeaux de trace sont utiles et d'autres moins. Un des paramètres ndstrace les plus utilisés par le support technique de Novell est en fait un raccourci :

set ndstrace = A81164B91

Ce paramètre active un groupe de messages de débogage.

Processus d'arrière-plan

En plus des messages de débogage, qui aident à vérifier l'état de eDirectory, vous disposez d'un ensemble de commandes qui imposent l'exécution des processus d'arrière-plan de eDirectory. Pour forcer le lancement d'un processus d'arrière-plan, entrez un astérisque (*) avant la commande. Par exemple :

set ndstrace = *H

Vous pouvez également changer l'état, la fréquence et le contrôle de certains processus d'arrière-plan. Pour modifier ces valeurs, entrez un point d’exclamation (!) avant la commande et entrez un nouveau paramètre ou une nouvelle valeur. Par exemple :

set ndstrace = !H 15 (valeur_paramètre_en_minutes)

La syntaxe de chaque instruction qui régit les processus d'arrière-plan de eDirectory est la suivante :

set ndstrace = *drapeau_trace [paramètre]

set ndstrace = !drapeau_trace [paramètre]

Le tableau ci-dessous liste les drapeaux de trace des processus d'arrière-plan, les paramètres éventuellement requis et le processus que les drapeaux de trace affichent.

Drapeau de trace	Paramètres	Description
*A	Aucun	Réinitialise le cache des adresses sur le serveur source.
*AD	Aucun	Désactive le cache des adresses sur le serveur source.
*AE	Aucun	Active le cache des adresses sur le serveur source.
*B	Aucun	Planifie le processus de liaison en amont pour que son exécution commence dans une seconde sur le serveur source.
!B	Heure	Définit la fréquence (en minutes) du processus de liaison en amont. Valeur par défaut = 1 500 minutes (25 heures) Plage = 2 à 10 080 minutes (168 heures)
*CT	Aucun	Affiche la table des connexions sortantes du serveur source et les statistiques actuelles pour cette table. Ces statistiques ne fournissent pas d'informations sur les connexions entrantes d'autres serveurs ou clients au serveur source.
*CTD	Aucun	Affiche, en utilisant le format séparé par une virgule, la table des connexions sortantes du serveur source et les statistiques actuelles pour cette table. Ces statistiques ne fournissent pas d'informations sur les connexions entrantes d'autres serveurs ou clients au serveur source.
*D	ID d'entrée de la racine de la réplique	Supprime l'ID d'entrée locale spécifié de la liste Envoyer tous les objets du serveur source. Cet ID doit indiquer un objet Racine de partition propre à la base de données locale du serveur. Cette commande n'est généralement employée que lorsqu'un processus Envoyer toutes les mises à jour tente indéfiniment d'afficher les mises à jour et échoue parce qu'un serveur est inaccessible.
!D	Heure	Attribue à l'intervalle de synchronisation entrante et sortante le nombre de minutes spécifié. Valeur par défaut = 24 minutes. Plage = 2 à 10 080 minutes (168 heures)
!DI	Heure	Attribue à l'intervalle de synchronisation entrante le nombre de minutes spécifié. Valeur par défaut = 24 minutes Plage = 2 à 10 080 minutes (168 heures)
!DO	Heure	Attribue à l'intervalle de synchronisation sortante le nombre de minutes spécifié. Valeur par défaut = 24 minutes Plage = 2 à 10 080 minutes (168 heures)
*E	Aucun	Réinitialise le cache d'entrées du serveur source.
!E	Aucun	Planifie l'exécution des processus de synchronisation entrante et sortante.
!EI	Aucun	Planifie l'exécution du processus de synchronisation entrante.
!EO	Aucun	Planifie l'exécution du processus de synchronisation sortante.
*F	Aucun	Planifie l'exécution du processus Gestionnaire d'attributs (flat cleaner), qui fait partie du processus Nettoyeur (janitor), sur le serveur source afin qu'elle commence dans les cinq secondes.
!F	Heure	Définit la fréquence (en minutes) du processus Gestionnaire d'attributs (flat cleaner). Valeur par défaut = 240 minutes (4 heures) Plage = 2 à 10 080 minutes (168 heures)
*G	ID d'entrée de la racine de la réplique	Recrée le cache de changement de l'ID de partition racine indiqué.
*H	Aucun	Planifie l'exécution immédiate du processus de synchronisation des répliques sur le serveur source.
!H	Heure	Définit la fréquence (en minutes) du processus de synchronisation des pulsations. Valeur par défaut = 30 minutes Plage = 2 à 1 440 minutes (24 heures)
*HR	Aucun	Efface le dernier vecteur envoyé de la mémoire.
*I	ID d'entrée de la racine de la réplique	Ajoute l'ID d'entrée locale spécifié dans la liste Envoyer tous les objets du serveur source. Cet ID doit indiquer un objet Racine de partition propre à la base de données locale du serveur. Le processus de synchronisation des répliques vérifie la liste Envoyer tous les objets. Si l'ID d'entrée d'un objet Racine de partition figure dans la liste, eDirectory synchronise tous les objets et attributs de la partition, quelle que soit la valeur de l'attribut Synchronisé jusqu'à.
!I	Heure	Définit la fréquence (en minutes) du processus de synchronisation des pulsations. Valeur par défaut = 30 minutes Plage = 2 à 1 440 minutes (24 heures)
*J	Aucun	Planifie l'exécution sur le serveur source du processus de purge, qui fait partie du processus de synchronisation des répliques.
!J	Heure	Définit la fréquence (en minutes) du processus Nettoyeur (janitor). Valeur par défaut = 2 minutes Plage = 1 à 10 080 minutes (168 heures)
*L	Aucun	Planifie l'exécution du contrôle de la connectivité (processus limber) sur le serveur source pour qu'elle commence dans cinq secondes.
*M	Octets	Modifie la taille maximale allouée au fichier ndstrace.log du serveur source. Cette commande peut être employée quel que soit l'état du fichier de débogage. Le nombre d'octets indiqué doit être une valeur hexadécimale comprise entre 10 000 octets et 100 Mo. Si la valeur indiquée n'est pas comprise dans cette plage, aucune modification n'a lieu.
!M	Aucun	Indique la quantité maximale de mémoire utilisée par eDirectory.
!N	0\|1	Définit le format du nom. 0 = format hexadécimal uniquement 1 = notation à point
*P	Aucun	Affiche les paramètres modifiables et leurs valeurs par défaut.
*R	Aucun	Réinitialise le fichier TTF, à savoir le fichier sys:system\ndstrace.dbg par défaut. Cette commande est la même que le paramètre SET de réglage à zéro de la taille du fichier trace NDS.
*S	Aucun	Programme le processus Contrôleur de synchronisation (skulker), qui vérifie si des répliques sur le serveur doivent être synchronisées.
!SI	Heure	Définit la fréquence (en minutes) du processus de synchronisation entrante du schéma. Valeur par défaut = 24 minutes Plage = 2 à 10 080 minutes (168 heures)
!SO	Heure	Définit la fréquence (en minutes) du processus de synchronisation sortante du schéma. Valeur par défaut = 24 minutes Plage = 2 à 10 080 minutes (168 heures)
!SIO	Heure	Désactive le processus de synchronisation entrante du schéma pendant le nombre de minutes spécifié. Valeur par défaut = 24 minutes Plage = 2 à 10 080 minutes (168 heures)
!SO0	Heure	Désactive le processus de synchronisation entrante du schéma pendant le nombre de minutes spécifié. Valeur par défaut = 24 minutes Plage = 2 à 10 080 minutes (168 heures)
*SS	Aucun	Force la synchronisation immédiate du schéma.
*SSA	Aucun	Lance l'exécution immédiate du processus de synchronisation du schéma et impose la synchronisation du schéma sur tous les serveurs cibles, même s'ils ont déjà été synchronisés au cours des dernières 24 heures.
*SSD	Aucun	Réinitialise la liste Synchronisation du schéma cible sur le serveur source. Cette liste identifie les serveurs avec lesquels le serveur source doit se synchroniser pendant le processus de synchronisation du schéma. Un serveur qui ne contient aucune réplique envoie une requête pour être inclus dans la liste cible d'un serveur qui contient une réplique avec son objet Serveur.
*SSL	Aucun	Imprime la liste de synchronisation du schéma des serveurs cibles.
*ST	Aucun	Affiche les informations sur l'état des processus en arrière plan exécutés sur le serveur source.
*STX	Aucun	Affiche les informations sur l'état du processus de liaison en amont (références externes) exécuté sur le serveur source.
*STS	Aucun	Affiche les informations sur l'état du processus de synchronisation du schéma exécuté sur le serveur source.
*STO	Aucun	Affiche les informations sur l'état du processus de liaison en amont (notices nécrologiques) exécuté sur le serveur source.
*STL	Aucun	Affiche les informations sur l'état du contrôle de la connectivité (processus limber) exécuté sur le serveur source.
!T	Heure	Définit la fréquence (en minutes) de vérification de l'état actif du serveur. Valeur par défaut = 30 minutes Plage = 1 à 720 minutes (12 heures)
*U	ID facultatif du serveur	Si la commande ne comporte pas d'ID d'entrée, l'état de chaque serveur préalablement défini commeInactif a été changé en Actif. Si la commande comprend un ID d'entrée locale, le serveur spécifié voit son état passer de Inactif à Actif. Les ID d'entrée sont propres à la base de données du serveur source et doivent faire référence à un objet qui représente un serveur.
!V	Une liste	Liste les versions limitées de eDirectory. Si aucune version n'est listée, cela indique qu'il n'existe aucune restriction. Les versions sont séparées par une virgule.
*Z	Aucun	Affiche les tâches actuellement planifiées.