Behandeln von Installationsproblemen mit dem Oracle Database-Adapter
Bei der Installation des Microsoft BizTalk-Adapterpakets werden die Produktbinärdateien auf dem Computer kopiert und die Bindungen für jeden Adapter registriert. In diesem Abschnitt wird die Verwendung von Problembehandlungstechniken zum Beheben von Installationsfehlern erläutert. Außerdem werden einige bekannte Probleme aufgeführt.
Protokollieren von Meldungen für Setupaktionen
Das BizTalk Adapter Pack-Setupprogramm führt die Standardaufgabe aus, das BizTalk Adapter Pack zu installieren. Darüber hinaus führt das Setup auch bestimmte benutzerdefinierte Aktionen aus, z. B. das Registrieren der Adapterbindungen. Sie können Meldungen sowohl für die Standardaktionen als auch für benutzerdefinierte Aktionen protokollieren, die vom Setup ausgeführt werden.
Das BizTalk Adapter Pack-Setup installiert die adapterspezifischen Dateien mithilfe einer MSI. Daher ist die Protokollierung für das Setup die standardmäßige MSI-Protokollierung.
Alle Protokolle für die vom Setupprogramm ausgeführten benutzerdefinierten Aktionen sind unter %TEMP%\adaptersetup.log verfügbar. Wenn die Ablaufverfolgung für die Protokolldatei fehlschlägt, sind die Ablaufverfolgungen auch im Ereignisprotokoll verfügbar.
Fehler beim Registrieren von Adapterbindungen beim Setup
Problem
Der Setup-Assistent für das Microsoft BizTalk Adapter Pack kann die Adapterbindungen nicht registrieren, fährt aber mit der Installation des Adapters fort.
Ursache
Dies kann zu Problemen mit der Installation von Windows Communication Foundation (WCF), der Installation des Lob-Adapter-SDK (Microsoft Windows Communication Foundation) (WCF) oder der machine.config Datei führen, die beschädigt ist. Die Adapterbindungen werden in die machine.config-Datei geschrieben.
Lösung
Registrieren Sie die Oracle Database-Adapterbindung manuell:
Navigieren Sie zur machine.config-Datei auf dem Computer. Auf einer 32-Bit-Plattform ist die machine.config beispielsweise unter <Systemlaufwerk>:\WINDOWS\Microsoft.NET\Framework\<version>\CONFIG verfügbar.
In diesem Pfad <ist version> die Version des .NET Framework.
Öffnen Sie die Datei mithilfe eines Text-Editors.
So registrieren Sie die Oracle Database-Adapterbindung:
Suchen Sie nach dem Element "system.serviceModel", und fügen Sie Folgendes darunter hinzu:
<client> <endpoint binding="oracleDBBinding" contract="IMetadataExchange" name="oracleDb" /> </client>Suchen Sie unter system.serviceModel\extensions nach dem Element "bindingElementExtensions".
Suchen Sie nach der fehlenden Oracle Database-Adapterbindung. Fügen Sie den folgenden Abschnitt unter dem Knoten "bindingElementExtensions" hinzu.
Fügen Sie für den Oracle Database-Adapter Folgendes hinzu:
<add name="oracleDBAdapter" type="Microsoft.Adapters.OracleDB.OracleDBAdapterExtensionElement,Microsoft.Adapters.OracleDB, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />Suchen Sie unter system.serviceModel\extensions nach dem Element "bindingExtensions".
Suchen Sie nach der fehlenden Oracle Database-Adapterbindung. Fügen Sie den folgenden Abschnitt unter dem Knoten "bindingExtensions" hinzu.
Fügen Sie für den Oracle Database-Adapter Folgendes hinzu:
<add name="oracleDBBinding" type="Microsoft.Adapters.OracleDB.OracleDBAdapterBindingSection,Microsoft.Adapters.OracleDB, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />
Hinweis
Informationen zum Ermitteln des öffentlichen Schlüssels und der Version finden Sie unter Bestimmen des öffentlichen Schlüssels und der Version.
Speichern und schließen Sie die Datei machine.config.
Bestimmen des öffentlichen Schlüssels und der Version
Führen Sie die folgenden Schritte aus, um den öffentlichen Schlüssel für den Oracle Database-Adapter zu ermitteln.
Navigieren Sie zum Windows-Verzeichnis, in der Regel C:\WINDOWS\assembly.
Klicken Sie mit der rechten Maustaste auf die DLL, für die Sie den öffentlichen Schlüssel und die Version verwenden möchten, und wählen Sie dann Eigenschaften aus. In der folgenden Tabelle ist der Name des DLL for Oracle Database-Adapters aufgeführt.
Adapter Name der DLL Oracle-Datenbankadapter Microsoft.Adapters.OracleDB Auf der Registerkarte Allgemein gibt der Wert für die Bezeichnung Öffentliche Schlüsseltoken den öffentlichen Schlüssel für die DLL an. Entsprechend gibt der Wert für die Versionsbezeichnung die Versionsnummer für die DLL an.
Kopieren Sie den öffentlichen Schlüssel, und klicken Sie dann auf Abbrechen.
Fehler beim Verwenden des Adapterdienst-Add-Ins oder Add Adapter Service Reference-Plug-Ins bei einer 64-Bit-Installation
Problem
Die Verwendung des Visual Studio-Plug-Ins Adapterdienstverweis hinzufügen oder des BizTalk-Projekt-Add-Ins "Adapterdienst nutzen" aus Visual Studio auf einem 64-Bit-Computer mit der 64-Bit-Version des BizTalk-Adapterpakets führt zu folgendem Fehler:
No valid adapters are installed on this machine
Ursache
Der Oracle Database-Adapter ist eine benutzerdefinierte WCF-Bindung, die unter System.ServiceModel in der machine.config-Datei registriert ist. Eine 64-Bit-Plattform verfügt über zwei machine.config Dateien, die von den 32-Bit-Anwendungen und die andere von den 64-Bit-Anwendungen verwendet werden. Wenn Sie also die 64-Bit-Version des BizTalk-Adapterpakets installieren, registriert der Setup-Assistent die Bindungen in der 64-Bit-Version der machine.config-Datei. Visual Studio wird jedoch als 32-Bit-Prozess ausgeführt. Wenn Sie also das Add-In "Adapterdienst nutzen" in Visual Studio starten, überprüft das Plug-In die Bindungen in der 32-Bit-Version der machine.config-Datei und gibt einen Fehler aus.
Auflösung
Installieren Sie sowohl die 32-Bit- als auch die 64-Bit-Version des BizTalk-Adapterpakets auf einer 64-Bit-WCF LOB Adapter SDK-Installation.
Wichtig
Sie müssen nur über eine 64-Bit-WCF LOB Adapter SDK-Installation verfügen. Die parallele Installation des 32-Bit- und 64-Bit-WCF LOB Adapter SDK auf einem einzelnen Computer wird nicht unterstützt.
Installieren Sie sowohl die 32-Bit- als auch die 64-Bit-Version der Oracle Data Access Components für Oracle Client 11.1.0.6 mit Patch Set 11.1.0.7.
Hinweis
Um sicherzustellen, dass Ihre Anwendung mit der neuesten Version von ODP.NET funktioniert, müssen die "Richtlinien-DLLs" auf dem Computer installiert und im GAC registriert sein. Weitere Informationen finden Sie unter Oracle-Datenanbieter für .NET auf der Oracle-Website.
Ungültiger Bindungsfehler beim Konfigurieren von Oracle-Datenbankadapterports in BizTalk Server-Verwaltungskonsole bei einer 64-Bit-Installation
Problem
Wenn Sie versuchen, einen Port für den Adapter in BizTalk Server Verwaltungskonsole zu konfigurieren, erhalten Sie den folgenden Fehler:
"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."
Ursache
Der Oracle Database-Adapter ist eine benutzerdefinierte WCF-Bindung, die unter System.ServiceModel in der machine.config-Datei registriert ist. Eine 64-Bit-Plattform verfügt über zwei machine.config Dateien, die von den 32-Bit-Anwendungen und die andere von den 64-Bit-Anwendungen verwendet werden. Wenn Sie also die 64-Bit-Version des BizTalk-Adapterpakets installieren, registriert der Setup-Assistent die Bindungen in der 64-Bit-Version der machine.config-Datei. BizTalk Server Verwaltungskonsole wird jedoch als 32-Bit-Prozess ausgeführt. Wenn Sie also einen Port für den Adapter konfigurieren, wird die Bindungen in der 32-Bit-Version der machine.config-Datei überprüft, und es tritt ein Fehler auf.
Auflösung
Installieren Sie sowohl die 32-Bit- als auch die 64-Bit-Version des BizTalk-Adapterpakets auf einer 64-Bit-WCF LOB Adapter SDK-Installation.
Wichtig
Sie müssen nur über eine 64-Bit-WCF LOB Adapter SDK-Installation verfügen. Die parallele Installation des 32-Bit- und 64-Bit-WCF LOB Adapter SDK auf einem einzelnen Computer wird nicht unterstützt.
Installieren Sie sowohl die 32-Bit- als auch die 64-Bit-Version der Oracle Data Access Components für Oracle Client 11.1.0.6 mit Patch Set 11.1.0.7.
Hinweis
Um sicherzustellen, dass Ihre Anwendung mit der neuesten Version von ODP.NET funktioniert, müssen die "Richtlinien-DLLs" auf dem Computer installiert und im GAC registriert sein. Weitere Informationen finden Sie auf der Oracle-Website unter Oracle-Datenanbieter für .NET .