Novell Confidential Manual (FRA) 28 October 2003
6
Utilitaire d’association JDBC
Cette section contient des informations sur l’utilisation de l’outil d’association JDBC. Cet utilitaire est conçu pour normaliser les associations d’objets effectuées avec les pilotes des versions 1.0 ou ultérieures. Il offre également plusieurs autres fonctions qui permettent de simplifier l’administration du pilote.
Cette version de l’utilitaire est compatible avec les anciennes versions du pilote JDBC jusqu’à la 1.0 ; elle remplace toutes les versions précédentes de l’utilitaire.
Fonctionnement de l’utilitaire
Cet utilitaire prend en charge sept opérations indépendantes :
1. Liste des objets associés à un pilote (par défaut)
2. Liste des objets qui comportent plusieurs associations à un pilote
3. Liste des objets qui comportent des associations incorrectes à un pilote
Une association est incorrecte dans les cas suivants :
Elle est mal formée. (Par exemple, le RDN du schéma ou de la table est absent, ou le mot clé du schéma est mal orthographié.)
Elle contient des identificateurs de base de données qui ne sont pas assignés à des identificateurs dans la base de données cible. (Par exemple, une association comprend une assignation à une table qui n’existe pas.)
Elle n’est assignée à aucune ligne ou à plusieurs lignes. Or, une association est rompue si elle n’est pas assignée à une ligne. Par ailleurs, les associations ne sont pas uniques si elles sont assignées à plusieurs lignes.
4. Liste des objets qui doivent être normalisés
Une association normalisée est correcte, bien ordonnée et utilise la casse qui convient. La casse normale est en majuscules pour les bases de données qui ne font pas la distinction majuscules/minuscules et en casse mixte pour les bases de données qui font cette distinction.
5. Normalisation des associations d’objets listées par l’opération précédente
6. Liste des associations d’objets à modifier
Permet le remplacement global des noms de schéma, de table et de colonne en fonction de critères de recherche.
7. Modification des associations d’objets listées par l’opération précédente
Le tableau suivant dresse la liste des opérations en indiquant si elles sont en lecture seule ou en
écriture.
Utilitaire d’association JDBC
75
Novell Confidential Manual (FRA) 28 October 2003
Opération Lecture seule ou écriture
1. Liste des objets associés à un pilote Lecture seule
2. Liste des objets qui comportent plusieurs associations à un pilote
Lecture seule
Lecture seule 3. Liste des objets qui comportent des associations incorrectes à un pilote
4. Liste des objets qui doivent être normalisés Lecture seule
Écriture 5. Normalisation des associations d’objets listées par l’opération précédente
6. Liste des associations d’objets à modifier
7. Modification des associations d’objets listées par l’opération précédente
Lecture seule
Écriture
Avant de commencer
La modification d’associations peut provoquer des problèmes. Si des associations sont corrompues, Identity Manager arrête de fonctionner ; n’utilisez donc des opérations d’écriture que lorsque c’est nécessaire. Pour éviter toute altération involontaire d’associations, cet utilitaire crée un fichier ldiff d’annulation pour toutes les opérations d’écriture.
Lisez les recommandations suivantes avant d’utiliser cet utilitaire :
Cet utilitaire, comme le pilote, suppose que les identificateurs de base de données ne sont pas délimités (sans guillemets et sans caractères spéciaux).
Il est extrêmement important que les associations d’objets liées à un pilote soient mises à jour en même temps.
Pour afficher tous les objets associés à un pilote particulier, cet utilitaire doit être exécuté sur le serveur eDirectory
TM
Novell
®
sur lequel le pilote fonctionne ou à partir duquel il s’exécute à distance.
Tous les objets associés à un pilote particulier doivent être endigués par la base de recherche LDAP.
Remarque : pour assurer un endiguement complet, nous vous recommandons d’utiliser le conteneur racine de votre arborescence comme base de recherche.
Assurez-vous que l’URL JDBC de la base de données cible fournie à cet utilitaire est la même que celle du pilote. En effet, si vous appliquez cet utilitaire à une base de données sans distinction majuscules/minuscules, alors que la base opère en fait cette distinction, les associations risquent d’être normalisées dans une casse incorrecte.
Comme cet utilitaire est exécuté en local, il utilise une connexion non sécurisée, si bien que le serveur LDAP eDirectory doit être temporairement configuré pour accepter les mots de passe en texte clair. En fonction du pilote JDBC tiers que vous utilisez, la connexion de base de données établie par cet utilitaire risque de ne pas être sécurisée.
Remarque : nous vous recommandons de changer le mot de passe d’authentification du module d’interface sur la base de données après avoir exécuté cet utilitaire.
76
DirXML Driver for JDBC Implementation Guide (Guide d’implémentation du pilote DirXML pour JDBC)
Novell Confidential Manual (FRA) 28 October 2003
Utilisation de l’utilitaire
Cet utilitaire doit être exécuté une fois pour chaque instance du pilote installée sur le serveur cible.
Un fichier de propriétés est fourni pour chaque base de données prise en charge ; son chemin est tools\sql\basedonnées\properties.txt.
Remarque : pour plus d’informations sur l’exécution de l’utilitaire à partir de la ligne de commande, reportezvous au fichier run.bat dans le répertoire tools\util de l’image de téléchargement.
1
2
Arrêtez le pilote.
Identifiez et supprimez les associations superflues (opérations 2 et 3).
Aucun objet associé par le pilote JDBC ne doit comporter plusieurs associations.
Les associations superflues doivent être supprimées manuellement pour chaque objet.
L’opération 3 peut vous aider à identifier laquelle des diverses associations est effectivement valable. Une fois cette association identifiée, vous pouvez supprimer les autres.
3
Identifiez et corrigez les associations incorrectes (opération 3, éventuellement opérations 6 et 7).
En règle générale, si le problème est isolé, modifiez chaque association incorrecte manuellement. Si le problème est répétitif et porte sur un grand nombre d’associations, envisagez d’utiliser les opérations 6 et 7. Cet utilitaire permet de remplacer globalement les identificateurs incorrects, mais ne peut pas en insérer ou en supprimer lorsqu’il n’en existe pas.
4
Normalisez les associations (opérations 4 et 5).
Édition d’associations
Cet utilitaire exige deux paramètres (oldRDN et newRDN) pour les opérations 6 et 7. Cette section explique comment utiliser ces paramètres.
La première valeur est le critère de recherche, tandis que la seconde est la valeur de remplacement.
Le caractère joker
*
peut être employé dans certains cas pour généraliser le critère de recherche ou la valeur de remplacement.
Trois types d’opérations de recherche et de remplacement sont possibles :
1. Remplacement du nom de schéma
Les caractères joker ne sont acceptés que du côté droit. Par exemple,
Remplacer le schéma old
(ancien) par le schéma new
(nouveau) oldRDN : schema=old newRDN : schema=new
2. Remplacement du nom de table
Les caractères joker ne sont pas pris en charge. Par exemple,
Remplacer la table old
(ancienne) par la table new
(nouvelle) oldRDN : table=old newRDN : table=new
3. Remplacement du nom de colonne
Les caractères joker sont obligatoires du côté droit, mais ne sont pas pris en charge du côté gauche. Par exemple,
Remplacer la colonne old
(ancienne) par la colonne new
(nouvelle) oldRDN : old=* newRDN : new=*
Utilitaire d’association JDBC
77
Novell Confidential Manual (FRA) 28 October 2003
78
DirXML Driver for JDBC Implementation Guide (Guide d’implémentation du pilote DirXML pour JDBC)
