Résoudre les problèmes d’installation de l’adaptateur SQl

L’installation du pack d’adaptateurs Microsoft BizTalk copie les fichiers binaires du produit sur l’ordinateur et enregistre les liaisons pour chaque adaptateur. Cette section décrit l’utilisation de techniques de résolution des problèmes pour résoudre les erreurs d’installation.

Journalisation des messages pour les actions d’installation

Le programme d’installation du pack d’adaptateurs BizTalk effectue la tâche standard d’installation du pack d’adaptateurs BizTalk. En outre, le programme d’installation effectue également certaines actions personnalisées, telles que l’inscription des liaisons d’adaptateur. Vous pouvez enregistrer des messages pour les actions standard et personnalisées effectuées par l’installation.

• Le programme d’installation du pack d’adaptateurs BizTalk installe les fichiers spécifiques à l’adaptateur à l’aide d’une msi. Par conséquent, la journalisation de l’installation est la journalisation MSI standard.

• Tous les journaux des actions personnalisées effectuées par le programme d’installation sont disponibles dans %TEMP%\adaptersetup.log. Si le suivi vers le fichier journal échoue, les traces sont également disponibles dans le journal des événements.

Problèmes connus

Voici les erreurs les plus courantes que vous pouvez rencontrer lors de l’installation du pack d’adaptateurs BizTalk, ainsi que leur cause et leur résolution probables.

Le programme d’installation ne parvient pas à inscrire les liaisons d’adaptateur

Problème

L’Assistant Installation du pack d’adaptateurs Microsoft BizTalk ne parvient pas à inscrire les liaisons d’adaptateur, mais procède à l’installation de l’adaptateur.

Cause

Cela peut être dû à des problèmes liés à l’installation de Windows Communication Foundation (WCF), à l’installation du Kit de développement logiciel (SDK) de l’adaptateur métier (LOB) Microsoft Windows Communication Foundation (WCF) ou à l’endommagement du fichier machine.config. Les liaisons d’adaptateur sont écrites dans le fichier machine.config.

Résolution :

Vous devez inscrire manuellement la liaison de l’adaptateur SQL.

Pour inscrire la liaison d’adaptateur

1. Accédez au fichier machine.config sur l’ordinateur. Par exemple, sur une plateforme 32 bits, le machine.config est disponible sous <lecteur> système :\WINDOWS\Microsoft.NET\Framework\<version>\CONFIG.

   Dans ce chemin d’accès, <version> est la version du .NET Framework.

2. Ouvrez le fichier à l’aide d’un éditeur de texte.

3. Pour inscrire la liaison d’adaptateur SQL :

   1. Recherchez l’élément « system.serviceModel » et ajoutez-y ce qui suit :

      <client>  
        <endpoint binding="sqlBinding" contract="IMetadataExchange" name="mssql" />  
      </client>  
      

   2. Recherchez l’élément « bindingElementExtensions » sous system.serviceModel\extensions.

   3. Recherchez la liaison d’adaptateur SQL manquante. Ajoutez la section suivante sous le nœud « bindingElementExtensions ».

      Pour l’adaptateur SQL, ajoutez :

      <add name="sqlAdapter" type="Microsoft.Adapters.Sql.SqlAdapterBindingElementExtensionElement,Microsoft.Adapters.Sql, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />  
      

   4. Recherchez l’élément « bindingExtensions » sous system.serviceModel\extensions.

   5. Recherchez la liaison d’adaptateur SQL manquante. Ajoutez la section suivante sous le nœud « bindingExtensions ».

      Pour l’adaptateur SQL, ajoutez :

      <add name="sqlBinding" type="Microsoft.Adapters.Sql.SqlAdapterBindingCollectionElement,Microsoft.Adapters.Sql, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />  
      

   Notes

   Pour plus d’informations sur la façon de déterminer la clé publique et la version, consultez Détermination de la clé publique et de la version.

4. Enregistrez et fermez le fichier machine.config.

Détermination de la clé publique et de la version

Effectuez les étapes suivantes pour déterminer la clé publique de l’adaptateur SQL.

Pour déterminer la clé publique

1. Accédez au répertoire Windows, généralement C :\WINDOWS\assembly.

2. Cliquez avec le bouton droit sur la DLL pour laquelle vous souhaitez utiliser la clé publique et la version, puis sélectionnez Propriétés. Le tableau suivant répertorie le nom de la DLL pour l’adaptateur SQL.

   Adaptateur	Nom de la DLL
   Adaptateur SQL	Microsoft.Adapters.Sql

3. Sous l’onglet Général , la valeur par rapport à l’étiquette Jeton de clé publique spécifie la clé publique pour la DLL. De même, la valeur par rapport à l’étiquette Version spécifie le numéro de version de la DLL.

4. Copiez la clé publique, puis cliquez sur Annuler.

Erreur lors de l’utilisation du complément Consommer le service d’adaptateur ou du plug-in Add Adapter Service Reference sur une installation 64 bits

Problème

L’utilisation du plug-in Add Adapter Service Reference Visual Studio ou du complément Consommer le service d’adaptateur BizTalk Project à partir de Visual Studio sur un ordinateur 64 bits exécutant la version 64 bits du pack d’adaptateurs BizTalk génère l’erreur suivante :

No valid adapters are installed on this machine  

Cause

L’adaptateur SQL est une liaison personnalisée WCF, qui est inscrite sous System.ServiceModel dans le fichier machine.config. Une plateforme 64 bits comporte deux fichiers machine.config, l’un utilisé par les applications 32 bits et l’autre par les applications 64 bits. Par conséquent, lorsque vous installez la version 64 bits du pack d’adaptateurs BizTalk, l’Assistant Installation enregistre les liaisons dans la version 64 bits du fichier machine.config. Toutefois, Visual Studio s’exécute en tant que processus 32 bits et, par conséquent, lorsque vous lancez le complément Consume Adapter Service à partir de Visual Studio, le plug-in vérifie les liaisons dans la version 32 bits du fichier machine.config et échoue à donner une erreur.

Résolution :

Installez les versions 32 bits et 64 bits du pack d’adaptateurs BizTalk sur une installation du Kit de développement logiciel (SDK) wcf LOB Adapter 64 bits.

Erreur de liaison non valide lors de la configuration des ports de l’adaptateur SQL dans BizTalk Server console d’administration sur une installation 64 bits

Problème

Lorsque vous essayez de configurer un port pour l’adaptateur dans BizTalk Server console Administration, vous obtenez l’erreur suivante :

"Unable to create binding configuration element for editing. Check the values of the BindingType and BindingConfiguration properties.  
(Microsoft.Biztalk.Adapter.Wcf.Converters.CreateBindingException) Unable to get binding type for binding extension "sqlBinding".  
Verify the binding extension is registered in machine.config."  

Cause

L’adaptateur SQL est une liaison personnalisée WCF, qui est inscrite sous System.ServiceModel dans le fichier machine.config. Une plateforme 64 bits comporte deux fichiers machine.config, l’un utilisé par les applications 32 bits et l’autre par les applications 64 bits. Par conséquent, lorsque vous installez la version 64 bits du pack d’adaptateurs BizTalk, l’Assistant Installation enregistre les liaisons dans la version 64 bits du fichier machine.config. Toutefois, BizTalk Server console Administration s’exécute en tant que processus 32 bits et, par conséquent, lorsque vous configurez un port pour l’adaptateur, elle recherche les liaisons dans la version 32 bits du fichier machine.config et ne génère pas d’erreur.

Résolution :

Installez les versions 32 bits et 64 bits du pack d’adaptateurs BizTalk sur une installation du Kit de développement logiciel (SDK) wcf LOB Adapter 64 bits.

Voir aussi

Résoudre les problèmes liés à l’adaptateur SQL