Résoudre les problèmes d’installation avec l’adaptateur Oracle Database
L’installation du pack d’adaptateurs Microsoft BizTalk copie les fichiers binaires de produit sur l’ordinateur et enregistre les liaisons pour chaque carte. Cette section décrit l’utilisation de techniques de résolution des problèmes pour résoudre les erreurs d’installation et répertorie également certains problèmes connus.
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’un 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 à l’adresse %TEMP%\adaptersetup.log. Si le suivi du fichier journal échoue, les traces sont également disponibles dans le journal des événements.
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 poursuit l’installation de l’adaptateur.
Cause
Cela peut résulter de 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 :
Inscrivez manuellement la liaison d’adaptateur Oracle Database :
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, <la version> est la version du .NET Framework.
Ouvrez le fichier à l’aide d’un éditeur de texte.
Pour inscrire la liaison d’adaptateur Oracle Database :
Recherchez l’élément « system.serviceModel » et ajoutez les éléments suivants sous celui-ci :
<client> <endpoint binding="oracleDBBinding" contract="IMetadataExchange" name="oracleDb" /> </client>Recherchez l’élément « bindingElementExtensions » sous system.serviceModel\extensions.
Recherchez la liaison d’adaptateur Oracle Database manquante. Ajoutez la section suivante sous le nœud « bindingElementExtensions ».
Pour l’adaptateur Oracle Database, ajoutez :
<add name="oracleDBAdapter" type="Microsoft.Adapters.OracleDB.OracleDBAdapterExtensionElement,Microsoft.Adapters.OracleDB, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />Recherchez l’élément « bindingExtensions » sous system.serviceModel\extensions.
Recherchez la liaison d’adaptateur Oracle Database manquante. Ajoutez la section suivante sous le nœud « bindingExtensions ».
Pour l’adaptateur Oracle Database, ajoutez :
<add name="oracleDBBinding" type="Microsoft.Adapters.OracleDB.OracleDBAdapterBindingSection,Microsoft.Adapters.OracleDB, 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.
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 Oracle Database.
Accédez au répertoire Windows, généralement C :\WINDOWS\assembly.
Cliquez avec le bouton droit sur la DLL pour laquelle vous souhaitez obtenir 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 Oracle Database.
Adaptateur Nom de la DLL Adaptateur de base de données Oracle Microsoft.Adapters.OracleDB 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.
Copiez la clé publique, puis cliquez sur Annuler.
Erreur lors de l’utilisation du complément Consume Adapter Service ou du plug-in Add Adapter Service Reference sur une installation 64 bits
Problème
L’utilisation du plug-in Visual Studio Add Adapter Service ou du complément Consumer Adapter Service BizTalk Project à partir de Visual Studio sur un ordinateur 64 bits exécutant la version 64 bits du pack d’adaptateurs BizTalk entraîne l’erreur suivante :
No valid adapters are installed on this machine
Cause
L’adaptateur Oracle Database est une liaison personnalisée WCF, inscrite sous System.ServiceModel dans le fichier machine.config. Une plateforme 64 bits a 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 comme un 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, ce qui génère 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.
Important
Vous devez uniquement disposer d’une installation du KIT de développement logiciel (SDK) de l’adaptateur LOB WCF 64 bits. L’installation côte à côte du Kit de développement logiciel (SDK) de l’adaptateur WCF LOB 32 bits et 64 bits sur un seul ordinateur n’est pas prise en charge.
Installez les versions 32 bits et 64 bits d’Oracle Data Access Components pour Oracle Client 11.1.0.6 avec l’ensemble de correctifs 11.1.0.7.
Notes
Pour vous assurer que votre application fonctionne avec la version la plus récente de ODP.NET, vous devez disposer des « DLL de stratégie » installées sur l’ordinateur et inscrites dans le GAC. Pour plus d’informations, consultez Fournisseur de données Oracle pour .NET sur le site web d’Oracle.
Erreur de liaison non valide lors de la configuration des ports de l’adaptateur de base de données Oracle 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 "oracleDBBinding".
Verify the binding extension is registered in machine.config."
Cause
L’adaptateur Oracle Database est une liaison personnalisée WCF, inscrite sous System.ServiceModel dans le fichier machine.config. Une plateforme 64 bits a 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 vérifie les liaisons dans la version 32 bits du fichier machine.config et échoue, ce qui génère 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.
Important
Vous devez uniquement disposer d’une installation du KIT de développement logiciel (SDK) de l’adaptateur LOB WCF 64 bits. L’installation côte à côte du Kit de développement logiciel (SDK) de l’adaptateur WCF LOB 32 bits et 64 bits sur un seul ordinateur n’est pas prise en charge.
Installez les versions 32 bits et 64 bits d’Oracle Data Access Components pour Oracle Client 11.1.0.6 avec l’ensemble de correctifs 11.1.0.7.
Notes
Pour vous assurer que votre application fonctionne avec la version la plus récente de ODP.NET, vous devez disposer des « DLL de stratégie » installées sur l’ordinateur et inscrites dans le GAC. Pour plus d’informations, consultez Fournisseur de données Oracle pour .NET sur le site web Oracle.