Installation du pilote en cours

Le pilote DirXML^® pour JDBC exige Novell^® eDirectory^TM et une configuration de la base de données. Il est recommandé de configurer votre base de données et de la tester indépendamment du pilote.

Suivez ces instructions s'il n'existe aucune installation précédente du pilote. Après avoir téléchargé l'image du CD, exécutez les instructions suivantes pour installer le pilote :

Installation du pilote en cours

1. Arrêtez eDirectory.

2. Copiez JDBCShim.jar, JDBCUtil.jar et CommonDriverShim.jar dans le répertoire approprié pour votre plate-forme. Inspirez-vous du tableau ci-dessous pour déterminer le répertoire qui convient :

   Plate-forme	Chemin de répertoire
   NetWare	SYS:\SYSTEM\LIB
   Solaris ou Linux	/usr/lib/dirxml/classes
   Windows NT/2000	NOVELL\NDS\LIB

3. Copiez le fichier de pilote JDBC tiers approprié dans le répertoire que vous avez indiqué à l'étape précédente.

   REMARQUE :  Ces fichiers de fabricants tiers ne sont pas fournis avec le pilote DirXML pour JDBC. Ils doivent faire l'objet d'une licence correcte, si nécessaire, pour être utilisés dans un environnement de production.

   Le tableau suivant contient des informations pour le téléchargement de pilotes de fabricants tiers, par fournisseur.

   Fournisseur	Base de données	Nom(s) de fichier(s)	Instructions de téléchargement
   Oracle	Oracle 8i	classes12.zip, nls_charset12.zip	Oracle Technology Network Vous devez tout d'abord vous enregistrer gratuitement sur le site OTN (Oracle Technology Network) d'Oracle. Téléchargez la version 8.1.7.1 ou une version ultérieure.
   Oracle	Oracle 9i	classes12.zip, nls_charset12.zip	Oracle Technology Network Vous devez tout d'abord vous enregistrer gratuitement sur le site OTN (Oracle Technology Network) d'Oracle. Téléchargez la version 9.2.0.1 ou une version ultérieure.
   BEA Systems	Microsoft SQL Server 7/2000	non précisé(s)	BEA Download Center Ce pilote requiert une inscription gratuite qui expire chaque mois. Dans la section JDBC Drivers, sélectionnez « MSSQLServer4 Kit, Version 7 and 2000 » dans la liste déroulante. Vous devez transformer vous-même le fichier en archive jar. Procédez comme suit : 1. Placez le fichier weblogic\mssqlserver4v70\license\WeblogicLicense.xml dans le répertoire \weblogic\smsqlserver4v70\classes. 2. Zippez le répertoire...\classes\weblogic, y compris son contenu, ainsi que le fichier ...\classes\WeblogicLicense.xml. Ce répertoire et le fichier XML doivent se trouver à la racine du fichier archive zip/jar.
   Microsoft	SQL Server 2000	msbase.jar mssqlserver.jar msutil.jar	Téléchargements Microsoft Cliquez sur l'option de téléchargement appropriée pour votre plate-forme.
   IBM	DB2 Universal Database (UDB) 7.2	db2java.zip	Téléchargements IBM Ce pilote fait partie du téléchargement gratuit de DB2 UDB Personal Developer. Si vous appliquez des kits de mise à jour, veillez à utiliser le fichier db2java.zip situé sur le serveur qui a été modifié par le correctif et non le fichier obtenu par le téléchargement initial.
   Sybase	Adaptive Server Enterprise (ASE) 12.5	jconn2.jar	Téléchargements Sybase Pour télécharger ce pilote, sélectionnez jConnect for JDBC.
   MySQL	MySQL 3.23	mysql-connector-java-2.0.14-bin.jar	Téléchargements MySQL Sélectionnez MySQL Connector/J2 ou version ultérieure.
   Informix	Informix Dynamic Server (IDS) 9.3	ifxjdbc.jar	non disponible pour téléchargement

4. Redémarrez eDirectory.

5. Démarrez ConsoleOne ou iManager.

Importation d'un pilote préconfiguré

Les pilotes préconfigurés correspondent aux exemples de configurations uniquement. Il est recommandé d'installer une configuration préconfigurée et de l'exécuter avant de personnaliser le pilote. Des fichiers de pilotes préconfigurés sont fournis pour les bases de données suivantes :

Toutes les préconfigurations utilisent les mêmes conventions, quelle que soit la base de données :

• Les champs de type chaîne comportent 64 caractères. Des champs de cette longueur peuvent contenir la plupart des attributs eDirectory qui présentent un intérêt. Vous pouvez adapter ces longueurs afin d'améliorer l'efficacité du stockage.
• Les champs de clé primaire comportent 8 chiffres. Cela doit suffire à des fins de test.
• La colonne RECORD_ID de la table EVENTLOG présente la précision numérique maximale autorisée par chaque base de données.
• Tous les noms de table, de déclencheur, de procédure stockée, d'index et de contrainte sont en minuscules. Cette convention de casse est la plus couramment utilisée.
• Les noms de déclencheurs sont précédés de « t_ », les noms de procédures stockées de « sp_ », les noms d'index de « i_ », les contraintes de vérification de « chk_ », les contraintes de clé primaire de « pk_ » et les contraintes de clé étrangère de « fk_ ».
• Les contraintes de vérification, de clé primaire et de clé étrangère respectent la convention de dénomination suivante : <préfixe>_<nom-table>_<nom-colonne> (c'est-à-dire, « pk_emp_empno », « fk_phone_empno », « chk_eventlog_event_type »)
• Les déclencheurs se conforment à la convention de dénomination suivante : t_<nom_table>_<opération> (par ex. « t_emp_insert »)
• Les index se conforment à la convention de dénomination suivante : i_<nom_table>_<numéro> (par ex. « i_eventlog_1 »)
• Les colonnes d'identité et les objets de séquence peuvent placer 100 valeurs en mémoire cache. Cela doit suffire à des fins de test.
• Les noms d'utilisateur se composent du nom de famille d'un utilisateur concaténé avec la valeur de clé primaire (par exemple, le nom d'utilisateur de Jean Dupont serait « Dupont1 »).
• Les mots de passe de départ correspondent au nom de famille d'un utilisateur (par exemple, le mot de passe de Jean Dupont serait « Dupont »). Les mots de passe Sybase doivent comporter au moins 6 caractères. Lorsque les noms de famille sont plus courts, ils sont complétés par le caractère 'p' (par exemple, le mot de passe de Jean Bon serait « Bonppp »). Le caractère de remplissage peut être modifié dans la feuille de style Transformation de la commande du canal Abonné.

Importation de la configuration du pilote

Le fichier (XML) de configuration de pilote permet de créer et de configurer les objets nécessaires au bon fonctionnement du pilote. Il inclut également des exemples de règles et de feuilles de style que vous pouvez modifier pour faciliter l'implémentation de votre système.

1. Dans iManager, sélectionnez Gestion DirXML > Créer un pilote.

2. Sélectionnez un ensemble de pilotes

   Si vous placez ce pilote dans un nouvel ensemble de pilotes, vous devez spécifier un nom d'ensemble de pilotes, ainsi qu'un contexte et un serveur associé.

3. Cochez l'option Importer un pilote préconfiguré à partir du serveur et sélectionnez le fichier .xml.

   Le fichier de configuration des pilotes est installé sur le serveur Web au moment de la configuration de iManager.

4. Vous serez alors invité à entrer le nom du pilote. Entrez le nom du pilote puis cliquez sur Suivant pour continuer.

5. (Facultatif) Cliquez sur Définir les équivalences de sécurité.

   1. Cliquez sur Ajouter puis sélectionnez un objet disposant de droits Admin (ou de tout autre droit que vous voulez attribuer au pilote).

   2. Cliquez sur Appliquer puis sur OK.

6. (Facultatif) Cliquez sur Exclure les rôles administratifs pour exclure de la réplication les objets correspondants.

   1. Cliquez sur Ajouter puis sélectionnez les utilisateurs à exclure (l'utilisateur admin, par exemple).

   2. Cliquez sur Appliquer puis sur OK.

7. Cliquez sur Suivant pour afficher le récapitulatif d'importation. Vérifiez que la configuration est correcte puis cliquez sur Terminer la présentation.

Les objets DirXML nécessaires ont été créés. Si vous n'avez pas défini les équivalences de sécurité ou exclu d'utilisateurs administratifs pendant l'importation, vous pouvez exécuter ces tâches en modifiant les propriétés de l'objet Pilote.