Démarrage de l'analyse de diagnostic Domino®

L'analyse de diagnostic Domino® (DDP) est démarrée à partir d'une invite de commande et s'exécute en tant que processus autonome et non comme processus de serveur Domino®.

Avant de commencer

Vous devez utiliser la machine virtuelle Java™ Eclipse OpenJ9 fournie avec Domino®. L'analyse n'est pas prise en charge avec SUN Java™.

ATTENTION : Vous ne devez pas redémarrer le serveur Domino® tant que l'analyse est en cours d'exécution. L'analyse doit être arrêtée avant de redémarrer le serveur Domino®, sinon certains processus Domino® risquent de se bloquer pendant l'arrêt. (Ces processus pourront finalement être nettoyés et un NSD créé.)

Pourquoi et quand exécuter cette tâche

L'analyse utilise l'identité du serveur Domino® et tente d'ouvrir une session et une base de données comme indiqué par le paramètre -database [-d] toutes les n secondes, comme indiqué par le paramètre -polling [-p]. Si le temps nécessaire pour ouvrir la base de données dépasse le délai indiqué par le paramètre -threshold [-t], le programme NSD est lancé pour collecter les données de diagnostic. Un fichier journal NSD est généré dans le répertoire domino_data_directory\IBM_TECHNICAL_SUPPORT. Vous pouvez également indiquer des paramètres facultatifs pour l'analyse, répertoriés dans un tableau dans la procédure suivante.

Procédure

  1. Pour chaque base de données que vous voulez contrôler à l'aide de l'analyse, ouvrez la base et sélectionnez Fichier > Application > Contrôle d'accès.
  2. Dans la liste de contrôle d'accès, ajoutez, puis mettez en surbrillance le serveur Domino® et, sous Attributs, définissez le Type d'utilisateur sur Non spécifié. Enregistrez la liste de contrôle d'accès.
  3. Pour exécuter l'analyse sous Windows™ ou UNIX™, assurez-vous que le fichier dbopen.jar est présent dans le répertoire programme Domino® dans lequel il est installé par défaut.
  4. A partir d'une invite de commande, accédez au répertoire dans lequel se trouve le fichier NOTES.INI du serveur (généralement les répertoires de travail sous UNIX™ et le répertoire programme sous Windows™). Démarrer l'analyse à partir d'une invite de commande à l'aide de l'exemple de syntaxe fournie dans le tableau.
    Tableau 1. Commande pour l'analyse de diagnostic Domino® sous Windows et UNIX™
    Plateforme Syntaxe de commande
    Windows™ jvm\bin\java -jar dbopen.jar -d mail\domprobe.nsf -t 3 -p 30 -nsdoptions "-nomemcheck" -outfile C:\Domino\data\IBM_TECHNICAL_SUPPORT\DomPerfMon.txt
    Remarque : Si vous utilisez Windows™ 2008, définissez Exécuter ce programme en tant qu'administrateur sur l'onglet Compatibilité dans les propriétés de fichier pour jvm/bin/java.exe.
    UNIX™ (dans le répertoire de travail) /opt/ibm/lotus/bin/java -jar /opt/ibm/lotus/bin/dbopen.jar -d mail/domprobe.nsf -t 3 -polling 45 -nsdoptions "-stacks" -outfile domperfmon.log
    Remarque : Les exemples de commande pour les plateformes UNIX™ et IBM® i sont sensibles à la casse. L'analyse se connectera au serveur en fonction du nom.
  5. Pour exécuter l'analyse sur IBM i, suivez la procédure ci-dessous pour utiliser QShell (STRQSH).
    Remarque : Les exemples de commande pour les plateformes UNIX™ et IBM® i sont sensibles à la casse. L'analyse se connectera au serveur en fonction du nom. Sur IBM® i, utilisez la commande Configure TCP/IP (CFGTCP) et sélectionnez Work with TCP/IP host table entries (Option 10) pour afficher la table hôte. Utilisez Add TCP/IP Host Table Entry (ADDTCPHTE) pour ajouter le nom de serveur et IP@ à la table d'hôte si nécessaire.
    1. Démarrez QShell à l'aide de la commande RUNDOMCMD suivante, en remplaçant servername par le nom du serveur Domino® : RUNDOMCMD SERVER(servername) CMD(STRQSH) BATCH(*NO)
    2. Accédez au répertoire de travail du serveur (par exemple, cd /domino/data)
    3. Démarrez l'analyse à partir de la commande suivante, entrée en une seule ligne, et en remplaçant filename.nsf par le nom de fichier de la base de données évaluée : /QOpenSys/usr/bin/java -Djava.library.path=/QIBM/ProdData/LOTUS/domino100001 -jar /QIBM/ProdData/LOTUS/domino100001/dbopen.jar -database mail/filename.nsf
  6. Facultatif : Incluez tout paramètre en option voulu pour l'analyse. Tous les paramètres répertoriés dans le tableau suivant sont facultatifs, à l'exception de -database [-d].
    Tableau 2. Options relatives à l'utilitaire d'analyse de diagnostic Domino®
    Paramètre Par défaut Objectif
    -database [-d] (obligatoire) aucun(e) Base de données à ouvrir ; par exemple, mail/test.nsf
    -threshold [-t] 30 Exécute NSD si le délai d'ouverture de la base de données dépasse la valeur de seuil définie. Valeur en secondes.
    -polling [-p] 60 Fréquence d'interrogation de la base de données pour ouverture, en secondes.
    -nsdoptions TOUS Options à transmettre à nsd. Doit être entre guillemets ; par exemple, "-nomecheck -stacks" Le paramètre par défaut "ALL" va exécuter toutes les commandes suivantes : DUMP, MEMCHECK, PERF, HANDLES, WALKMEM et PS.

    Tapez nsd -help pour afficher tous les paramètres NSD disponibles.

    -outfile aucun(e) Imprime la sortie dans le fichier journal indiqué, par exemple, c:\temp\DDPlog.txt, et à l'écran. Le nom de fichier doit être entre guillemets si le chemin du fichier contient un caractère 'espace' (s). Si le chemin n'est pas indiqué, le fichier sera créé dans le répertoire du programme Domino®. Si un fichier journal est indiqué lors des exécutions suivantes, la sortie est ajoutée au fichier journal.
    -help - Affiche le texte d'aide.

Résultats

La console de serveur Domino® affichera les sessions ouvertes et fermées par le serveur (une session par cycle d'interrogation, la session précédente sera fermée sur le serveur Domino® chaque fois qu'une nouvelle session est ouverte.) La sortie de l'analyse sera entrée dans la fenêtre de commande locale ainsi qu'un fichier journal (si indiqué). Si le délai d'ouverture de la base de données dépasse le seuil indiqué, un NSD est créé. Une fois le NSD terminé, un message l'indique et la consignation reprends.

Exemple

Exemple de sortie de la console du serveur Domino pour la session d'analyse de diagnostic :

07/12/2010 04:45:48 PM  Opened session for vlap2/vTest (Release 8.5.2 [Build 379])
07/12/2010 04:45:48 PM  Closed session for vlap2/vTest Databases accessed:     1   Documents read:     0   Documents written:     0 
07/12/2010 04:45:49 PM  Opened session for vlap2/vTest (Release 8.5.2 [Build 379])
07/12/2010 04:45:49 PM  Closed session for vlap2/vTest Databases accessed:     1   Documents read:     0   Documents written:     0
07/12/2010 04:45:54 PM  Opened session for vlap2/vTest (Release 8.5.2 [Build 379])    
07/12/2010 04:45:54 PM  Closed session for vlap2/vTest Databases accessed:     1   Documents read:     0   Documents written:    0
07/12/2010 04:45:59 PM  Opened session for vlap2/vTest (Release 8.5.2 [Build 379])
07/12/2010 04:45:59 PM  Closed session for vlap2/vTest Databases accessed:     1   Documents read:     0   Documents written:     0
Remarque : Any session for the probe will be closed when the probe is shut down. La session s'arrête lorsque l'analyse émet le message suivant : Shut down complete.

Exemple d'activité d'invite de commande pour une session DDP :

[C:\Domino] jvm\bin\java -jar dbopen.jar -d mail\domprobe.nsf -threshold 3 -polling 45 -nsdoptions "-nomemcheck" -outfile C:\Domino\data\IBM_TECHNICAL_SUPPORT\perfmon.txt
11/09/2009 5:46:10 AM Opening database mail\domprobe.nsf has taken 3.001 seconds. This exceeds the set threshold of 3.0 seconds.

L'ouverture de la base de données a dépassé le seuil de 3 secondes et NSD a été démarré immédiatement.

11/09/2009 5:46:10 AM Running NSD...

NSD en cours de création.

11/09/2009 5:47:44 AM NSD completed with exit status 0

NSD terminé.

11/09/2009 5:47:45 AM Opening database mail\domprobe.nsf took a total of 4.001 seconds

Une fois NSD terminé, DDP enregistre la durée d'ouverture totale de la base de données, soit 4 001 secondes ici. The NSD captured the state of the server at the time of the delayed DB open (at 3.001 seconds).

11/09/2009 5:48:33 AM Opening database mail\domprobe.nsf has taken 3.001 seconds. This exceeds the set threshold of 3.0 seconds.
11/09/2009 5:48:33 AM Running NSD...
11/09/2009 5:48:59 AM NSD completed with exit status 0
11/09/2009 5:49:00 AM Opening database mail\domprobe.nsf took a total of 5.354 seconds

L'ouverture de la base de données a pris 5 354 secondes.

...
Quit

L'administrateur a exécuté une commande quit pour arrêter l'analyse. La commande quit permet d'arrêter l'analyse.

11/09/2009 5:51:42 AM Shut down in progress...

Arrêt en cours de l'analyse.

11/09/2009 05:52:18 AM Shut down complete.
 Shut down of probe is complete. It can take several minutes to complete shut down if an NSD is in progress.