En effet Lotus Domino possède un cache nommé NameLookup Cache

Pour visualiser ce cache taper la commande suivante en mode console:

show nlcache

Et pour le vider taper la commande suivante en mode console:

show nlcache reset

Concrètement comment un utilisateur du domaine DOM1 peut il adresser un message à un utilisateur du domaine DOM2 ? En effet lorsqu’il adresse un message il ne peut lister que les utilisateur de son domaine DOM1. Comment peut il voir apparaitre dans la liste l’annuaire le domaine DOM2?

De la même manière comment l’administrateur Domino du domaine DOM1 peut il donner les droits à un utilisateur du domaine DOM2 sur l’une de ses bases ? Vous pouvez essayer, lorsque vous consultez la LCA (Liste de Contrôle d’Accès) de la base vous ne pouvez pas consulter cet annuaire.

Pour y remédier nous allons voir comment implémenter un assistant d’annuaire, en anglais Directory Assistance.

Créez la base d’assistance d’annuaire

• Allez dans Fichier - Base de documents - Nouveau

• Indiquez le nom du serveur ou créer la base

• Nommez la base, par exemple Assistant d’annuaire, mais tout autre nom est possible.

• Spécifiez un nom de fichier, par exemple DA.NSF. encore une fois vous pouvez indiquez un autre nom.

• Cliquez sur Montrer les modèles avancés

• Sélectionnez le serveur où récupérer les modèles

• Sélectionnez le modèle (template) Directory Assistance (DA.NTF)

• Cliquez sur OK.

Paramétrer le serveur pour utiliser l’assistant d’annuaire

• A partir de Domino Administrator, allez sur l’onglet Configuration

• Dans le panneau latéral gauche, étendez Server - Tous les documents serveurs

• Editez le document serveur où vous souhaitez implémenter l’assistant d’annuaire

• Dans l’onglet Basics - Nom de la base d’assistance d’annuaire spécifiez le nom de la base créer précédemment, DA.NSF

• Enregistrez et Quittez

• Ensuite vous pouvez forcer l’avancement du processus de création en éxécutant la commande suivante en mode console:

tell adminp process interval

• Redémarrez le serveur afin qu’il détecte la base précédemment créé.

Récupérer une réplique des annuaires à intégrer à l’assistant d’annuaire.

Il faut effectivement récupérer dans votre domaine une réplique de l’annuaire du domaine à intégrer. Ensuite il est conseillé de mettre en place la réplication pour cet annuaire en créant un document de connection afin de la maintenir à jour.

Créer un document d’assistance d’annuaire pour un annuaire Domino

• A partir de Domino Administrator allez dans Fichier - Ouvrir un serveur et sélectionnez le serveur sur lequel vous avez implémenté l’assistance d’annuaire.

• Allez sur l’onglet Configuration

• Dans le panneau latéral gauche, étendez Annuaire - Assistance d’annuaire.

• Cliquez sur Ajouter un assistant d’annuaire et remplissez les champs comme suit:

Onglet Général

Type du domaine: Notes

Nom du domaine : DOM2

Nom de la société : DOM2

Ordre de recherche : 2 (le 1 est réservé à votre annuaire names.nsf principal, vous mettrez 3 si vous aviez déjà un annuaire secondaire de monté)

Activé : Oui

Onglet règles : Rien à changer

Onglet répliques / Réplique 1 : SERVEUR1/DOMLAB annuaire_secondaire.nsf

• L’assistant d’annuaire est maintenant en place, vous pouvez le vérifier en essayant d’adresser un nouveau message à un membre de DOM2 ou en encore en ajoutant un membre de DOM2 sur la LCA d’une base. Vous pouvez également visualiser cet annuaire dans Domino Administrator / onglet Utilisateur.

Ce cache est appelé Database Cache

Visualiser le contenu du cache

Entrez la commande suivante en mode console:

dbcache show

Vider le cache

Entrez la commande suivante en mode console:

dbcacheflush

Désactiver le cache

Pour désactiver le cache, modifiez le fichier notes.ini de votre serveur et ajoutez la commande suivante:

NSF_DbCache_Disable=1

Afficher des statistiques sur le cache

Entrez la commande suivante en mode console:

Show Stat Database.DbCache.*

Statistic	Description
Database.DbCache.CurrentEntries	Number of databases currently in the cache. If this number frequently approaches the value of Database.DbCache.MaxEntries, increase the number of databases the cache can hold.
Database.DbCache.HighWaterMark	Maximum number of databases in the cache during this running of the server program. This number may be artificially high because of startup activity, so it may not be a genuine indicator of cache performance.
Database.DbCache.Hits	The number of times an “InitialDbOpen” is satisfied by finding the database in the cache. A high “hits-to-opens” ratio indicates that the database cache is working effectively. If the ratio is low, increase the number of databases the cache can hold.
Database.DbCache.InitialDbOpens	The number of times a user/server opened a database that was not already being used by another user/server. For example, if a user opens a mail file while it is being used by the Replicator, this number does not increase. Compare this number to Database.DbCache.Hits to gauge the effectiveness of the cache.
Database.DbCache.Lookups	The number of lookups to the database cache. A high “Database.DbCache.Hit” to “Database.DbCache.Lookups” ratio means the database cache is effective. If the ratio is low, increase the number of databases the cache can hold.
Database.DbCache.MaxEntries	The number of databases the server can currently hold in its cache at once. To change this value, use the NOTES.INI file setting, NSF_DbCache_Maxentries, or increase physical memory.
Database.DbCache.OvercrowdingRejections	Number of times a database is not placed into the cache when it is closed because Database.DbCache.CurrentEntries equals or exceeds Database.DbCache.MaxEntries times 1.5. This number should stay low. If it begins to rise, increase the number of databases the cache can hold

Lorsqu’un document est ajouté dans une base de documents, celle ci va logiquement prendre un peu plus d’espace disque. Mais à l’inverse lorsque l’on supprime ce document, la base de documents ne reprend pas sa taille initial. Cela pourrait sembler être un dysfonctionnement, mais pas du tout. Si vous ajoutiez à nouveau le même document, l’opération serait plus rapide que la première fois puisque le serveur n’aurait plus à augmenter au préalable la taille de la base. Cela peut paraitre dérisoire, mais si toutes les bases de votre serveur étaient constamment en cours de réduction/augmentation de taille, les performances serait significativement moindres.

Les bases de documents ont également tendances à se fragmenter, c’est à dire que les données d’une base ne se disposent pas logiquement les unes à la suite des autres. Des “vides” se forme dans la bases au fil des ajouts/suppressions de documents et cela affecte fortement les performances.

Ces donc principalement pour ces 2 raisons qu’il est important de planifier un compactage régulier des bases de documents (1 fois par semaine par exemple).

Planification d’un programme afin de lancer une tâche compact SANS réduction de fichier.

Cette maintenance est recommandée par Lotus, puisqu’elle permet de défragmenter la base de document sans toucher à la taille du fichier.

1. Allez dans Domino Administrator / Onglet Configuration / Server/ Programs

2. Cliquez sur Add program

3. Dans le champ Program Name indiquez le nom du programme à exécuter: compact

4. Dans le champ Command Line indiquez le paramêtre -b

5. Dans le champ Server to run on indiquez le nom du serveur concerné, ici SRVDOMINO/LABO

6. Dans le champ Comment , mettez un commentaire pour vous y retrouver dans vos nombreux programme …

7. Dans le champ Enabled/Disabled sélectionnez Enabled

8. Dans le champ Run At Time spécifier 23:00

9. Dans le champ Repeat Interval of spécifier 0

10. Dans le champ Days of week sélectionnez les jours ou vous souhaitez lancer la tâche : Sat

Planification d’un programme afin de lancer une tâche compact AVEC réduction de fichier.

Cette fois il s’agit de défragmenter la base de documents puis de réduire la taille du fichier .NSF. La périodicité de cette tâche dépend un peu de la manière dont sont sollicitées vos bases. Si il y a beaucoup d’écritures et de suppressions de documents, il est évident que votre base sera en perpétuelle évolution, dans ce cas est-ce vraiment utile de réduire la taille du fichier ? Non évidement, seule la défragmentation est fortement conseillée. Sinon voici comment la mettre en place

1. Allez dans Domino Administrator / Onglet Configuration / Server/ Programs

2. Cliquez sur Add program

3. Dans le champ Program Name indiquez le nom du programme à exécuter: compact

4. Dans le champ Command Line indiquez le paramètre -B

5. Dans le champ Server to run on indiquez le nom du serveur concerné, ici SRVDOMINO/LABO

6. Dans le champ Comment , mettez un commentaire pour vous y retrouver dans vos nombreux programme …

7. Dans le champ Enabled/Disabled sélectionnez Enabled

8. Dans le champ Run At Time spécifier 23:00

9. Dans le champ Repeat Interval of spécifier 0

10. Dans le champ Days of week sélectionnez: Sat

• Supprimez l’historique de mise à jour du catalogue d’annuaire

1. Allez dans Domino Administrator / Onglet Configuration / Directory / Directory Cataloger

2. Dans Advanced, supprimez l’historique

• Arrêtez la tâche Directory Cataloger

1. Allez dans Domino Administrator / Onglet Server / Onglet Status / Server Console et cliquez sur Live

2. Dans le champ Domino Command tapez la commande suivante:

tell dircat quit

• Relancez la génération du catalogue d’annuaire

1. Toujours en mode console tapez la commande suivante:

load dircat catalogue.nsf -R

où catalogue.nsf = nom de la base de catalogue d’annuaire.

Par défault la base de log est configuer dans le fichier notes.ini comme suit:

Log=log.nsf, 1, 0, 7, 40000

ou

Log=variable1, variable2, variable3, variable4, variable5

avec

variable1 =nom du fichier de log

variable2 = options de log (cumulatives)

1= log vers la console

2= forcer le fixup de la base à l’ouverture des logs

4= scanner tous les documents à l’ouverture de la base

variable3 = variable non utilisée

variable4 = nombre de jours de conservation des documents

variable5 = taille maximale du texte du journal concernant les documents de type “évênements”

Objectif : Dans notre exemple nous allons autoriser l’ensemble de l’organisation /ORGB à accéder à l’ensemble de l’organisation /ORGA.

Rappels: Dans Jean Dupont/Achats/ORGB

/ORGB correspond à l’organisation et est définit par un certificat /ORGB (cert.id)

/Achats correspond à une unité organisationnelle, OU, et est définit par un certificat /Achats/ORGB (oucert.id)

Jean Dupont correspond à l’utilisateur et est définit par un certificat Jean Dupont/Achats/ORGB (user.id)

Créer du fichier SAFE COPY d’un certificat de l’organisation /ORGB

• Connectez vous à l’un des serveurs de votre organisation /ORGB via Domino Administrator.

• Allez dans File / Security / User Security et ré-authentifiez vous.

• Déroulez l’onglet Your Identity et sélectionnez Your Certificates.

• Sur la droite cliquez sur le bouton Other Actions, sélectionner Export Notes ID (Safe Copy), puis enregistrer le fichier SAFE.ID dans un emplacement temporaire (Ex: C:\temp).

Intégrer le certificat de l’organisation /ORGB dans l’organisation /ORGA

• Connectez vous à l’un des serveurs de votre organisation /ORGA via Domino Administrator.

• Sélectionnez l’onglet Configuration, développez la barre Tools, cliquez sur la rubrique Certification et cliquez sur Cross Certify.

• Dans serveur, sélectionnez le serveur d’enregistrement de l’organisation /ORGA.

• Laissez coché Supply certifier ID and password

• Dans Certifier ID, sélectionnez un ID appartenant à l’organisation /ORGA (Cert.id / Server.id / OUcert.id) et entrez le mot de passe. Cette étape est très importante puisque ce sont les ID notes qui définissent les différents niveaux d’autorité d’une organisation. Si vous sélectionnez le fichier Cert.id de /ORGA cela signifiera que /ORGB pourra accéder à l’ensemble de l’organisation /ORGA (serveur et unité organisationnelle), ce que d’ailleurs nous souhaitons faire dans le cas présent. Si vous sélectionnez un fichier Server.id, vous allez alors limiter l’accès de B au serveur auquel correspond le certificat server.id.

• Ensuite dans la fenêtre Choose ID to be Cross-Certified, sélectionnez le fichier SAFE.ID provenant de /ORGB puis validez.

• Une fenêtre s’ouvre. Cette étape est également très importante. Précedement nous avons définit ce à quoi /ORGB pourrait accéder, nous allons maintenant définir QUI? de /ORGB pourra accéder à /ORGA. Ce choix se fait grâce à la liste découlante Subject name. Vous pouvez sélectionnez l’un des différents niveaux contenu dans le fichier SAFE COPY. Une fois votre choix effectué, cliquez sur Cross Certify.

La certification croisée est maintenant créée. Pour la tester à partir d’un client Lotus Notes, connectez-vous en tant d’utilisateur de l’organisation /ORGB et tentez d’ouvrir une base située sur un serveur de l’organisation /ORGA.

• Le catalogue de base catalog.nsf se créé la première fois lorsque l’on lance la tâche Cataloger, si jamais vous supprimiez la base, il est donc possible de la recréer en lançant la tâche Cataloger.

• Par défaut la tâche Cataloger est relancée toutes les nuits à 1h00 du matin. Cette information est spécifiée dans le fichier de configuration notes.ini du serveur Lotus Domino à la ligne suivante:

ServerTasksAt1=Catalog,Design

Si par exemple vous souhaitez planifier cette tâche à 6 heures du matin, modifiez le fichier notes.ini comme suit:

ServerTasksAt1=Design

ServerTasksAt6=Catalog

• Toutes les bases sont automatiquement paramétrées pour être intégrées au catalogue de bases. Pour retirer ou ajouter une base au catalogue, affichez les propriétés de la base (Clic Droits / Properties), et allez dans l’onglet Design

Il suffit alors de cocher ou décocher la case List in Database Catalog pour intégrer ou non la base dans le catalogue de bases catalog.nsf. Il est également possible de spécifier une catégorie de son choix, il existe en effet une vue “par catégorie” dans le catalogue de bases.

• Si vous souhaitez rafraichir le catalogue de bases sans attendre la planification automatique, il vous est possible de le lancer manuellement. Pour cela vous pouvez lancer la commande suivante à partir de la console:

load catalog

• Il ne vous reste plus qu’à ouvrir le catalogue de bases à partir d’un client Notes ou à partir de Domino Administrator. Le catalogue de bases permet de visualiser de nombreuses informations relatives aux bases de données comme:

- des informations générales (nom de la base, date de création, date de modification, nombre d’accès en lecture ou en écriture, … )

- des informations concernant les réplications (dernière réplication effective, ID de réplication, nombre de documents répliqués, …)

- des information sur la sécurité (affichage de la liste de contrôle d’accès , LCA, sous forme de tableau)

• Dans le sein d’une même organisation Domino, tout nouveau catalogue de bases créé sur un serveur prendra le même ID de réplication que le catalogue de bases du premier serveur de l’organisation. Cela signifie notamment qu’il sera intéressant de mettre en place une réplication des catalogues de bases entre les différents serveurs afin d’avoir une vue globale des bases de documents de l’organisation.

Il s’agit d’ Admin Backup Activity et de Admin Purge Log Activity.

Admin Backup Activity permet de planifier périodiquement la création d’une sauvegarde de la base Lotus Entreprise Integrator DECSADM.NSF. Une copie de cette base sera alors créé et nommée LEIBACK.NSF. En cas de crash de la base vous aurez immédiatement à votre disposition une copie de la base et n’auriez qu’à renommer l’ancienne en DECSADMOLD.NSF et renommer LEIBACK.NSF en DECSADM.NSF

Pour créer cette activité:

• Ouvrez la base LEI Administrator (DECSADM.NSF)
• Cliquez sur le bouton Add Activity et sélectionnez l’activité Admin-Backup
• Il ne vous reste plus qu’à renseigner le document et de planifier l’activité comme vous le souhaitez.

Conseils:

Il n’est pas utile de planifier tous les jours cette activité, tout dépend de la fréquence à laquelle vous créez de nouveaux traitements. Je vous conseille de lancer cette activité manuellement chaque fois que vous créez un nouveau travail dans Lotus Entreprise Integrator. Lorsque je créé cette activité je planifie son exécution une fois par semaine juste avant la sauvegarde complète du serveur Lotus Domino. Ce qui me permet de conserver une copie saine sur bande.

Admin Purge Log Activity permet de planifier périodiquement la suppression des logs jugés obsolètes de la base de logs Lotus Entreprise Integrator LEILOG.NSF. Couplé à un compactage périodique des bases Domino, cela vous permet de maitriser la taille de la base de logs.

Pour créer cette activité:

• Ouvrez la base LEI Administrator (DECSADM.NSF)
• Cliquez sur le bouton Add Activity et sélectionnez l’activité Admin-Purge Log
  
• il ne vous reste plus qu’à renseigner le document et de planifier l’activité comme vous le souhaitez.

Conseils:

Je planifie généralement cette activité une fois par semaine, juste après l’activité Admin Backup Activity et conserve uniquement les 30 derniers jours de logs. C’est amplement suffisant.

La commande set config Server_Restricted permet d’activer ou de désactiver les accès au serveur Domino.

Pour bloquer les accès au serveur Domino jusqu’au prochain redémarrage:

set config Server_Restricted=1

Pour bloquer les accès au serveur Domino même après son redémarrage:

set config Server_Restricted=2

Pour réactiver les accès au serveur Domino:

set config Server_Restricted=0

Lorsque vous avez bloqué l’accès au serveur Domino, les sessions déjà ouvertes sont toujours actives. Vous pouvez alors décider de les déconnecter en utilisant la commande drop all ou simplement d’attendre que les utilisateurs connectés finissent leur travail.

Une fois votre maintenance terminée vous pouvez de nouveau réactiver les accès aux serveurs

Si vous aviez utilisé la commande set config Server_Restricted=1 vous devez redémarrer le serveur pour réactiver les sessions.

Si vous aviez utilisé la commande set config Server_Restricted=2 tapez la commande suivante

set config Server_Restricted=0

L’implémentation d’AWStats n’est pas très compliquée, il suffit de suivre les étapes suivantes:

1. Activez la journalisation de l’activité HTTP sur votre serveur Domino. Pour cela modifiez le document serveur de votre serveur Domino, allez dans Internet Protocols, onglet HTTP et modifiez les champs suivants:

• Access Log Format = “Extended Common”
• Time Format = “LocalTime”
• Log File Duration = “Daily”
• Max Log Entry Length = “10 kb” (release 6 and higher)
• Max size of access log = “0″ (release 6 and higher)
• Enable logging to log files = “Enabled”
• Enable logging to Domlog.nsf = “Disabled”
• Directory for log files = “d:\domino\weblogs”

Sauvegardez et fermer le document serveur et redémarrez la tâche HTTP.

2. Téléchargez la version ZIP d’AWStats sur http://awstats.sourceforge.net

3. Extraire le fichier téléchargé awstats.zip dans le répertoire de votre choix. (par exemple “c:\temp“)

4. Créer un répertoire “awstats” dans %DOMINO_DATA_DIR%\domino\html (par exemple : “d:\domino\data\domino\html\awstats”)

5. Copier le répertoire “wwwroot\icon” dans %DOMINO_DATA_DIR%\domino\html\awstats (par exemple: “d:\domino\data\domino\html\awstats\icon”)

6. Copier le contenu de “wwwroot\cgi-bin” dans %DOMINO_DATA_DIR%\domino\cgi-bin directory on the Notes server (for example, “d:\domino\data\domino\cgi-bin”)

7. Copier le contenu de “tools” dans %DOMINO_DATA_DIR%\domino\cgi-bin

8. A partir du répertoire Domino “cgi-bin”, faire une copie du fichier awstats.model.conf. Renommez le awstats.domino.conf“. Ouvrez le fichier et modifiez le comme suit:

• LogFile=”perl ./logresolvemerge.pl d:/domino/weblogs/access*.log |”
  ou “d:/domino/weblogs” est le chemin d’accès aux fichiers log définit à l’étape 1
• LogType = W
• LogFormat = 1
• DirIcons=”/AWSTATS/icon”
• DNSLookup = 1

9. Installez un interpréteur Perl pour Windows : http://www.activestate.com/ActivePerl. Il n’est pas nécessaire de redémarrer le serveur, il est donc possible de l’installer directement sur votre serveur de production … en prenant les précautions nécessaires selon la politique de disponibilité de votre société … l’écran bleu de Windows est toujours à considérer

10. Lancez la première analyse des logs en ligne de commande. Pour cela allez en ligne de commande dans le répertoire “cgi-bin” créé à l’étape 6 et lancez la commande suivante:

perl awstats.pl -config=domino -update
Ou “domino” dans “-config=domino” correspond au nom indiqué au centre du fichier “awstats.domino.conf” créé à l’étape 8. Le processus va aller parcourir tous les fichiers de logs du répertoire d:/domino/weblogs/access*.log. Un fichier d’index va être créé. il servira à la génération des rapports.

En cas d’erreurs pensez à vérifier les points suivants:

• Vérifiez que le répertoire contenant les logs Domino existe bien ( étape 1 ).
• Vérifiez que vous n’avez pas fait de faute de frappe en entrant le chemin du répertoire contenant les logs ( étape 8 ).
• Si aucun log n’est généré, avez vous redémarrez la tâche Domino HTTP ?

11. Planifiez la mise à jour de l’index. Pour cela nous allons utiliser Domino pour ordonnancer la tâche.

• Créez un fichier update.bat dans le répertoire des binaires de Domino D:\domino et insérez le code suivant:

d:
cd d:\Domino\Data\Domino\cgi-bin
PERL awstats.pl -config=server1 -update

• Allez dans Domino Administrator / Configuration / Server / Programs ,créez un nouveau programme et spécifier update.bat dans le champ Program Name

12. Visualisez les statistiques sur un navigateur : http://monserveur.com/cgi-bin/awstats.pl?config=domino

Ou “domino” dans config=domino” correspond au nom indiqué au centre du fichier “awstats.domino.conf” créé à l’étape 8.

• http://www-128.ibm.com/developerworks/lotus/library/appstrat-usertrack/

Pour cela il faut avoir au préalable ajouté des variables dédiées au déboggage dans le fichier notes.ini (à la fin par exemple) de votre serveur Domino

–> FOR DOMINO 5.0.9 - DOMINO 6.0.2

DEBUG_THREADID=1
DEBUG_SHOW_TIMEOUT=1
DEBUG_CAPTURE_TIMEOUT=10
CONSOLE_LOG_ENABLED=1
HTTPEnableThreadDebug=1

–> FOR DOMINO 6.0.3 OR HIGHER and DOMINO 7

DEBUG_THREADID=1
DEBUG_SHOW_TIMEOUT=1
DEBUG_CAPTURE_TIMEOUT=1
CONSOLE_LOG_ENABLED=1
HTTPEnableThreadDebug=1

Une fois ces variables positionnées et votre serveur redémarré, vous serez en mesure de lancer le déboggeur Lotus Domino dès qu’une instabilité ou qu’un plantage aura lieu.

Pour lancer le débboguer procéder comme suit:

• Ouvrir une ligne de commande
• Se placer dans le répertoire C:\Lotus\Domino\
• Lancer la commande “nsd.exe -detach”
• Lancer la commande “nsd.exe -kill”

Les fichiers ( console.log, SEMDEBUG.txt et httpr_xxxxxxxxx.log ) sont générés dans C:\Lotus\Domino\Data\IBM_TECHNICAL_SUPPORT. Ce sont ces fichiers qui seront demandés par Lotus lors de l’ouverture d’un incident.