Installation du pilote

Effectuez les tâches suivantes pour installer, configurer et exécuter le pilote. (Si vous procédez à une mise à niveau du pilote, reportez-vous à Mise à niveau.)

• Installation du module d'interface pilote
• Importation de la configuration du pilote
• Démarrage du pilote
• Configuration de la réplication de la base de données à l'aide de NDSRep
• Migration et resynchronisation des données
• Activation du pilote

NOTE:  la plupart des installations exigent ensuite d'être personnalisées pour gérer la certification. Pour plus de détails, reportez-vous à Personnalisation du pilote.

Installation du module d'interface pilote

Vous pouvez installer le module d'interface pilote en même temps que le moteur DirXML ou plus tard. Pour ce faire, exécutez le programme d'installation d'Identity Manager et sélectionnez Pilote DirXML pour eDirectory. Vous trouverez des instructions à la section Installation dans le Novell Nsure Identity Manager 2 Administration Guide (Guide d'administration Novell Nsure Identity Manager 2).

Sous Windows uniquement, vous devez également effectuer les étapes suivantes :

• Copiez manuellement ndsrep.exe de son emplacement d'installation (\novell\NDS) vers le dossier d'exécutables du serveur Domino (\Lotus\Domino).
• Copiez manuellement dsrepcfg.ntf de son emplacement d'installation (\novell\NDS) vers le dossier de données du serveur Domino (\Lotus\Domino\Data).

  Sous Linux et Solaris, le processus d'installation du progiciel place dsrepcfg.ntf dans le dossier /usr/lib/dirxml/rules/notes et crée un lien symbolique dans le dossier /local/notesdata.

• Copiez manuellement le fichier Notes.jar du répertoire \Lotus\Domino vers le répertoire \Novell\nds\lib (ou le répertoire \novell\remote\loader\lib si vous exécutez le chargeur distant).
• Vérifiez que le répertoire des bibliothèques partagées Domino (par exemple, C:\Lotus\Domino) se trouve dans le chemin du système Windows.

  Si ce n'est pas le cas, JVM* peut rencontrer des difficultés à situer les bibliothèques partagées Domino requises par Notes.jar, telles que nxlsbe.dll.

Après l'installation, vous devez configurer le pilote selon les explications de la section suivante, Importation de la configuration du pilote.

Importation de la configuration du pilote

Importez le fichier de configuration du pilote afin de créer tous les objets eDirectory nécessaires, comme les règles, les feuilles de style et les filtres, pour la configuration de base du pilote. Vous pouvez ensuite modifier la configuration pour l'adapter aux exigences spécifiques à votre société.

Importez la configuration du pilote Notes en suivant les instructions de la section Creating a Driver Object (Création d'un objet Pilote) du Novell Nsure Identity Manager 2 Administration Guide (Guide d'administration de Novell Nsure Identity Manager 2).

Fournissez les informations suivantes, puis passez à Démarrage du pilote.

L'exemple de configuration du pilote utilise une nouvelle fonctionnalité - l'invite flexible - pour diminuer la complexité lors de l'importation de la configuration. Si vous choisissez d'installer le pilote pour un usage avec le chargeur distant, ou si vous souhaitez utiliser des droits basés sur le rôle, une page supplémentaire apparaîtra dans l'assistant, permettant de saisir des informations concernant ces formalités.

Démarrage du pilote

Cette section contient des informations sur les éléments nécessaires lors du démarrage du pilote, pour la première fois et les fois suivantes ; elle indique également les étapes à suivre pour démarrer le pilote.

• Premier démarrage du pilote
• Démarrage du pilote après la première fois
• Lancement du pilote avec Linux, Solaris ou AIX
• Étapes de démarrage du pilote

Premier démarrage du pilote

Lors de sa première exécution, le pilote recherche le serveur Domino (spécifié dans les paramètres du pilote lors de l'importation) ; il tente d'ouvrir le fichier dsrepcfg.nsf pour écrire les paramètres de l'Éditeur lus par NDSRep. Si le fichier dsrepcfg.nsf n'existe pas, alors le module d'interface pilote Notes essaie de le créer à l'aide du modèle de base de données dsrepcfg.ntf livré avec le pilote.

Si dsrepcfg.ntf n'est pas trouvé, ou que ce processus de création initiale de dsrepcfg.nsf échoue, alors le canal Éditeur se ferme.

Si la création de dsrepcfg.nsf est réussie et si ce fichier contient des données spécifiant un fichier approprié dans base de données de mise à jour (généralement, ndsrep.nsf), NDSRep se charge avec succès à l'aide de la commande saisie depuis la console Domino, où instance représente le nom du pilote :

load ndsrep instance

Un nom de pilote (ou un nom d'instance unique configuré pour ce pilote) est nécessaire pour charger NDSRep depuis la console du serveur.

Si le nom de votre pilote contient des espaces, vous devez inclure le nom entre guillemets.

Nous vous recommandons de mettre à jour le fichier notes.ini pour charger NDSRep automatiquement, une fois la configuration initiale et le démarrage validés.

Si le serveur Domino exige que les bases de données soient signées, vous devrez peut-être signer dsrepcfg.ntf avec l'ID de votre serveur.

NOTE:  si le module d'interface pilote s'initialise avec le fichier notes.ini pour un client Notes à la place du serveur Notes, le module ne pourra pas ouvrir dsrepcfg.ntf.

Sous Windows, vérifiez que le module d'interface pilote s'initialise correctement, en modifiant le chemin d'accès au système Windows, pour retrouver le fichier notes.ini du serveur Domino avant le fichier notes.ini pour un client Notes.

Démarrage du pilote après la première fois

Une fois le premier démarrage réussi, le pilote Notes et NDSRep peuvent être lancés dans n'importe quel ordre pratique pour la configuration particulière.

NDSRep doit être lancé en utilisant le nom de pilote comme paramètre.

load ndsrep mydriver1

Pour charger NDSRep, vous devez utiliser le nom d'instance approprié :

load ndsrep instance 

load ndsrep instance

Une fois NDSRep chargé, toutes les commandes TELL sont émises à l'attention de cette instance de NDSRep à l'aide du nom d'instance.

Si le nom de votre pilote contient des espaces, vous devez inclure le nom entre guillemets.

Lancement du pilote avec Linux, Solaris ou AIX

Pour Linux et Solaris, trois exemples de scripts et un fichier de configuration sont fournis pour expliquer comment lancer le pilote. Ils sont installés, par défaut, dans le répertoire /usr/lib/dirxml/rules/notes.

Nous vous recommandons de copier les quatre fichiers dans l'emplacement depuis lequel vous souhaitez lancer votre pilote sur le serveur Domino, par exemple /local/notesdata ou /home/notes.

Ces scripts permettent de démarrer le chargeur distant pour le pilote à l'aide de rdxml.startnotes et d'arrêter le chargeur distant pour le pilote à l'aide de rdxml.stopnotes.

Vérifiez que les scripts ont accès aux fichiers pour exécution (par exemple, rwxr-xr-x).

Les scripts sont nommés de la manière suivante :

• rdxml.startnotes

  Ce script appelle le script findDomino, qui définit les variables d'environnement correctes pour le pilote Notes sur le système d'exploitation Domino. Le script rdxml.startnotes lance ensuite le chargeur distant avec les paramètres du pilote Notes spécifiés dans le fichier rdxml.confignotes.

• rdxml.stopnotes

  Ce script arrête le chargeur distant qui exécute le pilote Notes.

• findDomino

  Ce script définit les variables du système d'exploitation qui indiquent l'emplacement d'un type d'installation UNIX de Domino. Ce script est appelé depuis le script rdxml.startnotes.

Le même répertoire contient également un exemple de fichier de configuration du chargeur distant pour le pilote Notes. Vous devrez peut-être modifier les ports de configuration référencés dans ce fichier.

• rdxml.confignotes

  Cette configuration est référencée par les scripts rdxml.startnotes et rdxml.stopnotes.

Ces exemples de scripts fonctionnent dans de nombreuses situations. S'ils ne fonctionnent pas dans votre environnement, vous devrez peut-être les modifier de manière appropriée. Par exemple, si l'emplacement des scripts ne se trouve pas sur le chemin de recherche actuel, le script rdxml.startnotes risque de devoir être modifié, de manière à inclure un chemin d'accès spécifique au script findDomino.

Les exemples de scripts produisent un journal de trace pour le chargeur distant pour le pilote, journal que vous pouvez utiliser pour le dépannage.

Étapes de démarrage du pilote

1. (Windows uniquement) Vérifiez que vous avez copié les fichiers nécessaires, tel que décrit dans Installation du module d'interface pilote.

2. Dans iManager, sélectionnez Gestion DirXML > Présentation.

3. Localisez le pilote dans son ensemble de pilotes.

4. Cliquez sur l'indicateur d'état du pilote dans l'angle supérieur droit de l'icône du pilote, puis sur Démarrer le pilote.

5. (Windows uniquement) Saisissez le mot de passe de l'utilisateur Notes que vous utilisez pour le pilote, si vous êtes invité à le faire. Cette invite ne s'affiche qu'au premier démarrage du pilote ; la configuration du pilote détermine si elle apparaît ou non.

La synchronisation s'effectue objet après objet, au fur et à mesure des modifications apportées à chacun des objets. Si vous souhaitez une synchronisation immédiate, vous devez lancer cette procédure comme indiqué dans la section suivante, Migration et resynchronisation des données.

Configuration de la réplication de la base de données à l'aide de NDSRep

Suivez les instructions des sections ci-dessous pour configurer la réplication à l'aide de NDSRep :

• Configuration de NDSRep
• Chargement et contrôle de NDSRep
• Configuration de plusieurs instances de NDSRep

N'oubliez pas que le lancement de NDSRep échoue à moins que le pilote DirXML pour Lotus Notes ait été démarré au moins une fois.

Configuration de NDSRep

1. Reportez-vous aux informations relatives à NDSRep et au démarrage du pilote dans Démarrage du pilote.

2. (Windows uniquement) Vérifiez que vous avez copié les fichiers nécessaires, tel que décrit dans Installation du module d'interface pilote.

3. Pour charger NDSRep automatiquement sur le chargeur Domino, ajoutez NDSRep à la ligne ServerTasks = du fichier notes.ini de Domino.

   Exemple :

   ServerTasks=Update,Replica,Router,AMgr,AdminP,ndsrep notesdrv1, 
   CalConn,Sched,HTTP,IMAP,POP3

   Si le nom de votre pilote contient des espaces, vous devez inclure le nom entre guillemets.

4. (Windows uniquement) Ajoutez c:\lotus\domino à votre chemin système, puis redémarrez l'ordinateur.

Chargement et contrôle de NDSRep

Vous chargez et exécutez toujours NDSRep sur la console du serveur Domino. NDSRep crée une base de données de sortie (par défaut, ndsrep.nsf). Il détecte les modifications apportées au carnet d'adresses du serveur Domino (ou d'une autre base de données Notes) et copie ces modifications dans la base de données de sortie.

• Chargement de NDSRep : chargez ndsrep.exe dans la console du serveur Domino.

  Ajoutez NDSRep à l'instruction ServerTasks = de NOTES.INI puis redémarrez le serveur Domino, ou saisissez la commande suivante dans la fenêtre de la console du serveur Notes :

  load ndsrep instance 

  Exemple :

  ServerTasks=Update,Replica,Router,AMgr,AdminP,ndsrep notesdrv1, 
  CalConn,Sched,HTTP,IMAP,POP3

  Si le nom de votre pilote contient des espaces, vous devez inclure le nom entre guillemets.

• Contrôle de NDSRep : utilisez les commandes TELL décrites dans le tableau.

  Les commandes TELL NDSRep suivantes permettent de procéder à des opérations NDSRep immédiates. Ces commandes ne sont pas stockées ; NDSRep exécute simplement l'opération en question.

  Commande TELL	Description
  RefreshConfig	Lit les informations de configuration NDSRep dans la zone de stockage de la configuration.
  Replicate	Impose une vérification immédiate des notes mises à jour.
  Resume	Configure NDSRep pour reprendre le traitement des événements d'horloge et de la réplication.
  ShowConfig	Affiche les paramètres de configuration NDSRep dans la fenêtre de la console.
  ShowFilter	Affiche les 240 premiers caractères du filtre des enregistrements mis à jour utilisé par NDSRep lors de l'acheminement des données.
  Suspend	Suspend l'activité jusqu'à l'émission de la commande Resume.

Configuration de plusieurs instances de NDSRep

Vous pouvez exécuter plusieurs instances de NDSRep pour prendre en charge plusieurs pilotes qui s'exécutent sur un seul serveur Domino. Vous devez spécifier le nom d'instance de pilote approprié comme paramètre lors du chargement de NDSRep. Par défaut, le nom de cette instance est le nom du pilote.

Si le nom de votre pilote contient des espaces, vous devez inclure le nom entre guillemets.

La configuration de NDSRep et de plusieurs instances pose les problèmes importants suivants :

• Pour charger NDSRep, vous devez utiliser le nom d'instance approprié.

  load ndsrep nom_instance

  NDSRep est chargé et peut être référencé à l'aide de la commande TELL par la valeur nom_instance.

• Par défaut, NDSRep enregistre les données de configuration des instances dans une base de données Notes commune (dsrepcfg.nsf).
• Lorsque vous modifiez notes.ini pour charger automatiquement plusieurs instances de NDSRep, il suffit d'insérer ndsrep nom_instance plusieurs fois sur la ligne ServerTask dans notes.ini.

  Exemple :

  ServerTasks=Update,Replica,Router,AMgr,AdminP, 
  ndsrep notesdrv1,ndsrep notesdrv2,CalConn,Sched,HTTP,IMAP,POP3

• Pour les configurations personnalisées, vous pouvez demander à NDSRep d'utiliser une autre base de données de configuration. Pour cela, utilisez le paramètre de configuration NDSRep et chargez NDSRep à l'aide du paramètre -f nomfichier tel qu'indiqué dans la base de données de configuration NDSRep et dans l'instance de configuration NDSRep du tableau des paramètres au Personnalisation du pilote.

Migration et resynchronisation des données

Identity Manager synchronise les données lorsqu'elles sont modifiées. Si vous souhaitez synchroniser immédiatement toutes les données, vous avez le choix entre les options suivantes :

• Migrer les données depuis eDirectory : permet de sélectionner les conteneurs ou les objets à migrer depuis eDirectory vers une application. Lorsque vous migrez un objet, le moteur DirXML applique à l'objet toutes les règles de concordance, de placement et de création, ainsi que le filtre Abonné.

• Migrer les données vers eDirectory : permet de définir les critères utilisés par Identity Manager pour migrer des objets depuis une application vers Novell eDirectory. Lorsque vous migrez un objet, le moteur DirXML applique à l'objet toutes les règles de concordance, de placement et de création, ainsi que le filtre Éditeur. Les objets sont migrés dans eDirectory dans l'ordre spécifié dans la liste des classes.

• Synchroniser : le moteur DirXML examine le filtre de la classe Abonné et traite tous les objets de ces classes. Les objets associés sont alors fusionnés. Les objets non associés seront traités en tant qu'événements d'ajout.

Pour utiliser l'une des options décrites plus haut :

1. Dans iManager, sélectionnez Gestion DirXML > Présentation.

2. Recherchez l'ensemble de pilotes qui contient le pilote Notes, puis double-cliquez sur son icône.

3. Cliquez sur le bouton de migration approprié.

Activation du pilote

L'activation doit être effectuée dans un délai de 90 jours à compter de l'installation, sinon le pilote ne fonctionnera pas.

Pour plus d'informations sur l'activation, reportez-vous à Activating Novell Identity Manager Products (Activation des produits de Novell Identity Manager) du Novell Nsure Identity Manager 2 Administration Guide (Guide d'administration de Novell Nsure Identity Manager 2).