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 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.

Avant de commencer

La modification d'associations peut provoquer des problèmes. Si des associations sont endommagées, DirXML^TM cesse de fonctionner. En conséquence, vous ne devez utiliser des opérations d'écriture qu'en cas de nécessité. 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 outil :

• 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 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, Novell^® recommande 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é localement, il utilise une connexion non sécurisée. À ce titre, le serveur LDAP de eDirectory doit être temporairement configuré pour accepter des 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 :  Novell recommande 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.

Utilisation de l'outil

Cet utilitaire doit être exécuté une fois pour chaque instance du pilote installée sur le serveur cible. Procédez comme suit pour exécuter l'utilitaire.

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, reportez-vous au fichier run.bat dans le répertoire tools\util de l'image de téléchargement.

Exécution de l'utilitaire

1. Arrêtez le(s) pilote(s).

2. 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,

   • Remplacement du schéma « other » par le schéma « DIRXML »

     oldRDN : schema=other

     newRDN : schema=DIRXML

2. Remplacement du nom de table

   Les caractères joker ne sont pas pris en charge. Par exemple,

   • Remplacement de la table « EMP » par la table « emp » :

     oldRDN : table=EMP

     newRDN : table=emp

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,

   • Remplacement de la colonne « other » par la colonne « EMPNO »

     oldRDN : other=*

     newRDN : EMPNO=*