2.12 Affichage des processus Identity Manager

Pour afficher les événements de traitement Identity Manager, servez-vous de la fonction DSTRACE. Cette fonction ne sert que pour les tests et le dépannage de Identity Manager. Si vous exécutez DSTRACE alors que les pilotes sont en phase de production, le taux d'utilisation du serveur Identity Manager augmente et le traitement des événements risque d'en être très ralenti.

Pour que les processus Identity Manager soient affichés dans DSTRACE, des valeurs sont ajoutées aux objets Ensemble de pilotes et Pilote. Cela peut être fait dans Designer et dans iManager.

2.12.1 Ajout de niveaux de trace dans Designer

Vous pouvez ajouter des niveaux de trace à l'objet Ensemble de pilotes ou à chaque objet Pilote.

Ensemble de pilotes

  1. Dans un projet ouvert dans Designer, sélectionnez l'objet Ensemble de pilotes dans la vue Aperçu.

    Description : sélection de l'objet Ensemble de pilotes

  2. Cliquez avec le bouton droit de la souris et cliquez sur Propriétés, puis cliquez sur 5. Trace.

  3. Définissez les paramètres de trace, puis cliquez sur OK. Pour plus d'informations sur les paramètres de trace de l'ensemble de pilotes, reportez-vous au Tableau 2-1.

    Si vous définissez le niveau de trace sur l'objet Ensemble de pilotes, tous les pilotes apparaissent dans les journaux DSTRACE.

Tableau 2-1 Paramètres de trace de l'ensemble de pilotes

Paramètre

Description

Niveau de trace du pilote

Alors que le niveau de trace de l'objet Pilote augmente, la quantité d'informations qui s'affichent dans DSTRACE augmente.

Le niveau de trace Un affiche les erreurs, mais pas leur cause. Pour afficher les informations de synchronisation du mot de passe, définissez le niveau de trace sur cinq.

Niveau de trace XSL

DSTRACE affiche les événements XSL. Ne définissez ce niveau de trace que lorsque vous corrigez les feuilles de style XSL. Si vous ne souhaitez pas afficher les informations XSL, définissez le niveau sur zéro.

Port de débogage Java

Permet aux développeurs de joindre un débogueur Java.

Fichier de trace Java

Lorsque ce champ contient une valeur, toutes les informations Java relatives à l'objet Ensemble de pilotes sont copiées dans un fichier. La valeur du champ correspond au correctif du fichier.

Si le fichier est spécifié, les informations Java y sont copiées. Si vous n'avez pas besoin de déboguer Java, laissez ce champ vide.

Taille maximum du fichier de trace

Permet de définir une limite pour le fichier de trace Java. Si vous définissez la limite de fichier sur Illimitée, la taille du fichier augmente jusqu'à ce qu'il n'y ait plus de place sur le disque.

Pilote

  1. Dans un projet ouvert dans Designer, sélectionnez l'objet Pilote dans la vue Aperçu.

    Description : sélection de l'objet Pilote

  2. Cliquez avec le bouton droit de la souris et cliquez sur Propriétés, puis cliquez sur 8. Trace.

  3. Définissez les paramètres de trace, puis cliquez sur OK. Pour plus d'informations sur ces paramètres, reportez-vous au Tableau 2-2.

    Si vous définissez les paramètres uniquement sur l'objet Pilote, seules les informations relatives à ce pilote apparaissent dans le journal DSTRACE.

Tableau 2-2 Paramètres de trace du pilote

Paramètre

Description

Niveau de trace

Alors que le niveau de trace de l'objet Pilote augmente, la quantité d'informations qui s'affichent dans DSTRACE augmente.

Le niveau de trace Un affiche les erreurs, mais pas leur cause. Pour afficher les informations de synchronisation du mot de passe, définissez le niveau de trace sur cinq.

Si vous sélectionnez Use setting from Driver Set (Utiliser le paramètre de l'ensemble de pilotes), la valeur associée à l'objet Ensemble de pilotes est utilisée.

Fichier de trace

Spécifiez le nom et l'emplacement du fichier dans lequel sont copiées les informations Identity Manager pour le pilote sélectionné.

Si vous sélectionnez Use setting from Driver Set (Utiliser le paramètre de l'ensemble de pilotes), la valeur associée à l'objet Ensemble de pilotes est utilisée.

Taille maximum du fichier de trace

Permet de définir une limite pour le fichier de trace Java. Si vous définissez la limite de fichier sur Illimitée, la taille du fichier augmente jusqu'à ce qu'il n'y ait plus de place sur le disque.

Si vous sélectionnez Use setting from Driver Set (Utiliser le paramètre de l'ensemble de pilotes), la valeur associée à l'objet Ensemble de pilotes est utilisée.

Nom de la trace

En préfixe des messages de trace du pilote, figure la valeur saisie et non le nom du pilote. Utilisez ce paramètre si le nom du pilote est particulièrement long.

2.12.2 Ajout de niveaux de trace dans iManager

Vous pouvez ajouter des niveaux de trace à l'objet Ensemble de pilotes ou à chaque objet Pilote.

Ensemble de pilotes

  1. Dans iManager, sélectionnez Identity Manager > Présentation de Identity Manager.

  2. Recherchez l'objet Ensemble de pilotes, puis cliquez sur Rechercher.

  3. Cliquez sur le nom de l'ensemble de pilotes.

    Description : sélection de l'objet Ensemble de pilotes

  4. Sélectionnez l'onglet Divers correspondant à l'objet Ensemble de pilotes.

  5. Définissez les paramètres de trace, puis cliquez sur OK. Pour plus d'informations sur ces paramètres, reportez-vous au Tableau 2-1.

Pilote

  1. Dans iManager, sélectionnez Identity Manager > Présentation de Identity Manager.

  2. Recherchez l'objet Ensemble de pilotes dans lequel se trouve le pilote, puis cliquez sur Rechercher.

  3. Cliquez dans l'angle supérieur droit de l'objet Pilote, puis cliquez sur Éditer les propriétés.

  4. Sélectionnez l'onglet Divers correspondant à l'objet Pilote.

  5. Définissez les paramètres de trace, puis cliquez sur OK. Pour plus d'informations, reportez-vous au Tableau 2-2.

    REMARQUE:l'option Use setting from Driver Set (Utiliser le paramètre de l'ensemble de pilotes) n'existe pas dans iManager.

2.12.3 Enregistrement des processus Identity Manager dans un fichier

L'enregistrement des processus Identity Manager dans un fichier se fait par le biais du paramètre de l'objet Pilote ou de DSTRACE. Le paramètre de l'objet Pilote est le paramètre Fichier de trace.

Les méthodes suivantes permettront de capturer et d'enregistrer les processus Identity Manager sous différents systèmes d'exploitation avec DSTRACE.

NetWare

Utilisez DSTRACE.NLM pour afficher les messages de trace sur la console du système ou dans un fichier (SYS:\SYSTEM\DSTRACE.LOG). DSTRACE.NLM affiche les messages de trace dans l'écran DSTRACE Console (Console DSTRACE).

  1. Saisissez DSTRACE.NLM sur la console du serveur.

    Le fichier DSTRACE.NLM est alors chargé dans la mémoire.

  2. Saisissez DSTRACE SCREEN ON sur la console du serveur.

    Affiche les messages de trace dans l'écran de la console DSTRACE.

  3. Saisissez DSTRACE FILE ON sur la console du serveur.

    Enregistre les messages de trace envoyés à la console DSTRACE dans le fichier DSTRACE.LOG.

  4. Saisissez DSTRACE -ALL sur la console du serveur.

    Désactive tous les drapeaux de trace.

  5. Saisissez DSTRACE +DXML DSTRACE +DVRS sur la console du serveur.

    Affiche les événements Identity Manager.

  6. Saisissez DSTRACE+TAGS DSTRACE +TIME sur la console du serveur.

    Affiche les balises et les tampons horaires des messages.

  7. Basculez vers l'écran de la console DSTRACE et attendez que l'événement soit passé.

  8. Revenez à la console du serveur.

  9. Saisissez DSTRACE FILE OFF sur la console du serveur.

    Arrête la capture des messages de trace dans le fichier-journal. Arrête également la consignation des informations dans le fichier.

  10. Ouvrez le fichier DSTRACE.LOG dans un éditeur de texte et recherchez l'événement ou l'objet que vous avez modifié.

Fenêtres

  1. Sélectionnez Panneau de configuration > NDS Services > dstrace.dlm, puis cliquez sur Démarrer.

    La fenêtre NDS Server Trace Utility (Utilitaire de trace du serveur NDS) s'ouvre.

  2. Sélectionnez Éditer > Options, puis cliquez sur Effacer tout.

    Tous les drapeaux par défaut sont effacés.

  3. Sélectionnez DirXML et DirXML Drivers (Pilotes DirXML).

  4. Cliquez sur OK.

  5. Sélectionnez Fichier > Nouveau.

  6. Indiquez le nom de fichier et l'emplacement dans lequel vous souhaitez enregistrer les informations DSTRACE, puis cliquez sur Ouvrir.

  7. Attendez que l'événement se produise.

  8. Sélectionnez Fichier > Fermer.

    Cela arrête la copie des informations dans le fichier-journal.

  9. Ouvrez le fichier dans un éditeur de texte et recherchez l'événement ou l'objet que vous avez modifié.

UNIX

  1. Saisissez ndstrace pour lancer l'utilitaire ndstrace.

  2. Saisissez set ndstrace=nodebug

    Désactive tous les drapeaux de trace définis.

  3. Saisissez set ndstrace on

    Affiche les messages de trace sur la console.

  4. Saisissez set ndstrace file on

    Capture les messages de trace dans le fichier ndstrace.log situé dans le répertoire d'installation de eDirectory. Par défaut, il s'agit du répertoire /var/nds.

  5. Saisissez set ndstrace=+dxml

    Affiche les événements Identity Manager.

  6. Saisissez set ndstrace=+dvrs

    Affiche les événements du pilote Identity Manager.

  7. Attendez que l'événement se produise.

  8. Saisissez set ndstrace file off

    Arrête la consignation des informations dans le fichier.

  9. Saisissez exit pour quitter l'utilitaire ndstrace.

  10. Ouvrez le fichier dans un éditeur de texte. Recherchez l'événement ou l'objet qui a été modifié.

iMonitor

iMonitor permet d'obtenir les informations DSTRACE depuis un navigateur Web. Peu importe l'emplacement dans lequel s'exécute Identity Manager. Ces fichiers permettent l'exécution d'iMonitor :

  • NDSIMON.NLM, pour une exécution sur NetWare.
  • NDSIMON.DLM, pour une exécution sous Windows.
  • ndsimonitor, pour une exécution sous UNIX.

  1. Accédez à iMonitor depuis l'adresse http://server_ip:8008/nds.

    Le port 8008 est le port par défaut.

  2. Saisissez le nom et le mot de passe d'un utilisateur doté de droits administratifs, puis cliquez sur Login.

  3. À gauche, sélectionnez Configuration de Trace.

  4. Cliquez sur Effacer tout.

  5. Sélectionnez DirXML et les pilotes DirXML.

  6. Cliquez sur Trace activée.

  7. À gauche, sélectionnez Historique de trace.

  8. Cliquez sur le document dont la date de la dernière modification est Actuel pour afficher la trace instantanément.

  9. Modifiez l'Intervalle de rafraîchissement si vous souhaitez afficher les informations plus souvent.

  10. À gauche, sélectionnez Configuration de Trace puis cliquez sur Trace désactivée pour désactiver le suivi.

  11. Pour afficher l'historique du suivi, sélectionnez Historique de trace. Les fichiers sont différenciés par leur tampon horaire.

S'il vous faut une copie du fichier HTML, son emplacement par défaut est le suivant :

  • NetWare : SYS:\SYSTEM\ndsimon\DSTRACE*.htm
  • Windows : Drive_letter:\Novell\NDS\ndsimon\dstrace\*.htm
  • UNIX : /var/nds/dstrace/*.htm