Pour utiliser l'utilitaire DSTrace dans un environnement Linux, exécutez la commande suivante à l'invite du serveur :
/opt/novell/eDirectory/bin/ndstrace
La syntaxe complète de la commande ndstrace est la suivante :
ndstrace [-l|-u|-c "command1;......"|--version] [-h <local_interface:port>] [--config-file <configuration_file_path>] [thrd <thread ID>] [svty <severity_level>] [conn <connection_ID>]
L’utilitaire DSTrace comporte trois parties principales :
Les fonctions de base de DSTrace sont les suivantes :
Affichage de l'activité interne d'eDirectory et des messages de débogage sous Linux.
Lancement des processus de synchronisation limités.
Vous pouvez utiliser l'utilitaire DSTrace en mode interface utilisateur ou en mode ligne de commande. Par défaut, DSTrace s'exécute en mode interface utilisateur. Pour lancer DSTrace en mode interface utilisateur, entrez la commande suivante à l'invite du serveur :
/opt/novell/eDirectory/bin/ndstrace
Pour démarrer DSTrace en mode ligne de commande, entrez la commande suivante à l'invite de commande :
/opt/novell/eDirectory/bin/ndstrace -l
Pour lancer les fonctions de base de DSTrace, entrez les commandes correspondantes à l'invite du serveur en respectant la syntaxe suivante :
ndstrace command_option
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 suivi. |
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 suivi, qui sont en général utilisés pour le débogage. Les indicateurs suivants sont activés : 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 suivi, mais désactive tous les messages de débogage qui ont été activés précédemment. Cette option laisse également les messages définis sur l'option de commande ON. |
Lorsque l'écran DSTrace est activé, les informations affichées se fondent 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 indicateurs des messages de débogage. Les messages de débogage aident à déterminer l'état d'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, précisez le signe plus (+) ainsi que le nom ou l'option du processus. Pour désactiver l'affichage d'un processus, entrez un signe moins (-) ainsi que le nom ou l'option 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 de schéma. |
Vous pouvez également combiner les indicateurs des messages de débogage à l'aide des opérateurs booléens « & » (qui signifie ET) et | » (qui signifie OU). La syntaxe de commande des messages de débogage sur la console du serveur est la suivante :
set ndstrace = <trace_flag> [parameter]
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 indicateurs de suivi.
Indicateur de suivi |
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 d'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. |
SYNC |
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 associé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 DSTrace, vous constaterez que les drapeaux de trace sont plus ou moins utiles. L'un des paramètres DSTrace favoris de prise en charge NetIQ est en fait un raccourci :
set ndstrace = A81164B91
Ce paramètre active un groupe de messages de débogage.
En plus des messages de débogage, qui aident à vérifier l'état d'eDirectory, vous disposez d'un ensemble de commandes qui imposent l'exécution des processus en arrière-plan d'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 sé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 (parameter_value_in_minutes)
La syntaxe de chaque instruction qui régit les processus en arrière-plan d'eDirectory est la suivante :
set ndstrace = <trace_flag> [parameter]
Le tableau ci-dessous répertorie les drapeaux de trace des processus d'arrière-plan, les paramètres éventuellement requis et le processus que les drapeaux de trace affichent.
Indicateur de suivi |
Paramètres |
Description |
---|---|---|
*Un fichier |
Aucun(e) |
Réinitialise le cache des adresses sur le serveur source. |
*AD |
Aucun(e) |
Désactive le cache des adresses sur le serveur source. |
*AE |
Aucun(e) |
Active le cache des adresses sur le serveur source. |
*B |
Aucun(e) |
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(e) |
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(e) |
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 |
Replica rootEntry ID |
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(e) |
Réinitialise le cache d'entrées du serveur source. |
!E |
Aucun(e) |
Planifie l'exécution des processus de synchronisation entrante et sortante. |
!EI |
Aucun(e) |
Planifie l'exécution du processus de synchronisation entrante. |
!EO |
Aucun(e) |
Planifie l'exécution du processus de synchronisation sortante. |
*F |
Aucun(e) |
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) |
*FL |
1-10 |
Définit le nombre de fichiers journaux de déploiement utilisés par DSTrace. Si vous définissez ce paramètre sur une valeur supérieure à 1, lorsque le fichier ndstrace.log du serveur source atteint la taille de fichier maximale configurée, DSTrace renomme le fichier et lui attribue le nom ndstrace1.log, puis crée un nouveau fichier ndstrace.log. Lorsque ce fichier atteint sa taille maximale, le fichier ndstrace1.log précédent est renommé ndstrace2.log et le dernier fichier ndstrace.log est renommé ndstrace1.log. Ce processus se poursuit jusqu'à ce que DSTrace atteigne le nombre maximal de fichiers journaux générés par cette option. Une fois que la limite spécifiée est atteinte, les anciens fichiers journaux sont supprimés et seul le nombre maximal spécifié de fichiers est conservé. Vous pouvez configurer un maximum de 10 fichiers journaux progressifs. Par défaut, DSTrace doit utiliser au moins un fichier journal progressif. Si vous définissez ce paramètre sur 0, DSTrace utilise la valeur de paramètre 1. |
*G |
Replica rootEntry ID |
Recrée le cache de changement de l'ID de partition racine indiqué. |
*H |
Aucun(e) |
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(e) |
Efface le dernier vecteur envoyé de la mémoire. |
*I |
Replica rootEntry ID |
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(e) |
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(e) |
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 dé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(e) |
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 à points |
*P |
Aucun(e) |
Affiche les paramètres modifiables et leurs valeurs par défaut. |
*R |
Aucun(e) |
Rétablit la taille du fichier ndstrace.log sur 0 octet. Cette commande est la même que le paramètre NDS SET de réglage à zéro de la taille du fichier de suivi. |
*S |
Aucun(e) |
Programme le processus Contrôleur de sync, qui vérifie si une des répliques figurant sur le serveur doit être synchronisée. |
!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(e) |
Force la synchronisation immédiate du schéma. |
*SSA |
Aucun(e) |
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(e) |
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(e) |
Imprime la liste de synchronisation du schéma des serveurs cibles. |
*ST |
Aucun(e) |
Affiche les informations sur l'état des processus en arrière-plan exécutés sur le serveur source. |
*STX |
Aucun(e) |
Affiche les informations sur l'état du processus de liaison en amont (références externes) exécuté sur le serveur source. |
*STS |
Aucun(e) |
Affiche les informations sur l'état du processus de synchronisation du schéma exécuté sur le serveur source. |
*STO |
Aucun(e) |
Affiche les informations sur l'état du processus de liaison en amont (notices nécrologiques) exécuté sur le serveur source. |
*STL |
Aucun(e) |
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 |
Liste |
Liste les versions limitées d'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(e) |
Affiche les tâches actuellement planifiées. |