Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Installation des Microsoft BizTalk Adapter Pack kopiert die Produktbinärdateien auf dem Computer und registriert die Bindungen für jeden Adapter. In diesem Abschnitt wird die Verwendung von Problembehandlungstechniken zum Beheben von Installationsfehlern sowie einige bekannte Probleme erläutert.
Protokollieren von Nachrichten für Setup-Aktionen
Das BizTalk Adapter Pack-Setupprogramm führt die Standardaufgabe zum Installieren des BizTalk Adapter Pack aus. Darüber hinaus führt das Setup auch bestimmte benutzerdefinierte Aktionen aus, z. B. das Registrieren der Adapterbindungen. Sie können Nachrichten sowohl für den Standard als auch für benutzerdefinierte Aktionen protokollieren, die vom Setup ausgeführt werden.
Die Installation des BizTalk Adapter Packs 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 in der Protokolldatei fehlschlägt, sind die Ablaufverfolgungen auch im Ereignisprotokoll verfügbar.
Setup registriert keine Adapterbindungen.
Problem
Der Setup-Assistent für Microsoft BizTalk Adapter Pack kann die Adapterbindungen nicht registrieren, führt aber mit der Adapterinstallation fort.
Ursache
Dies könnte infolge von Problemen bei der Installation von Windows Communication Foundation (WCF), der Installation des Microsoft Windows Communication Foundation (WCF) Line of Business (LOB) Adapter SDK oder einer beschädigten machine.config-Datei entstehen. Die Adapterbindungen werden in die machine.config Datei geschrieben.
Lösung
Manuelles Registrieren der Oracle Database-Adapterbindung:
Navigieren Sie zur datei machine.config auf dem Computer. Beispielsweise ist die machine.config auf einer 32-Bit-Plattform unter <Systemlaufwerk>:\WINDOWS\Microsoft.NET\Framework\version>\<CONFIG verfügbar.
In diesem Pfad ist <Version> die Version des .NET Frameworks.
Ö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 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-Datenbankadapter 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-Datenbankadapter 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 Ermitteln des öffentlichen Schlüssels und der Version.
Speichern und schließen Sie die machine.config Datei.
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 der öffentliche Schlüssel und die Version verwendet werden sollen, und wählen Sie dann "Eigenschaften" aus. In der folgenden Tabelle ist der Name der DLL für oracle Database adapter aufgeführt.
Adapter Name der DLL Oracle-Datenbankadapter Microsoft.Adapters.OracleDB Auf der Registerkarte " Allgemein " gibt der Wert für die Bezeichnung " Public Key Token " 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 Add-Ins "Adapterdienst verwenden" oder des Plug-Ins "Adapterdienstreferenz hinzufügen" bei einer 64-Bit-Installation
Problem
Die Verwendung des Add Adapter Service Reference Visual Studio Plug-Ins oder das Add-In "Verbrauchadapterdienst BizTalk Project" von Visual Studio auf einem 64-Bit-Computer, auf dem die 64-Bit-Version des BizTalk Adapter Pack ausgeführt wird, führt zu folgendem Fehler:
No valid adapters are installed on this machine
Ursache
Der Oracle-Datenbankadapter 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 den anderen von den 64-Bit-Anwendungen verwendet werden. Wenn Sie also die 64-Bit-Version des BizTalk Adapter Pack 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 das Add-In "Consume Adapterdienst" aus Visual Studio starten, sucht das Plug-In nach den Bindungen in der 32-Bit-Version der machine.config-Datei und gibt einen Fehler aus.
Lösung
Installieren Sie sowohl die 32-Bit- als auch die 64-Bit-Version des BizTalk Adapter Pack auf einer 64-Bit-WCF-LOB-Adapter-SDK-Installation.
Von Bedeutung
Sie müssen nur über eine 64-Bit-WCF-LOB Adapter SDK-Installation verfügen. Die parallele Installation von 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-Komponenten 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 Sie die "Richtlinien-DLLs" auf dem Computer installiert und im GAC registriert haben. Weitere Informationen finden Sie unter Oracle Data Provider for .NET auf der Website von Oracle.
Ungültiger Bindungsfehler beim Konfigurieren von Oracle-Datenbankadapterports in der BizTalk Server-Verwaltungskonsole bei einer 64-Bit-Installation
Problem
Wenn Sie versuchen, einen Port für den Adapter in der BizTalk Server-Verwaltungskonsole zu konfigurieren, wird die folgende Fehlermeldung angezeigt:
"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-Datenbankadapter 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 den anderen von den 64-Bit-Anwendungen verwendet werden. Wenn Sie also die 64-Bit-Version des BizTalk Adapter Pack installieren, registriert der Setup-Assistent die Bindungen in der 64-Bit-Version der machine.config-Datei. Die BizTalk Server-Verwaltungskonsole wird jedoch als 32-Bit-Prozess ausgeführt und überprüft daher beim Konfigurieren eines Ports für den Adapter die Bindungen in der 32-Bit-Version der machine.config-Datei und gibt einen Fehler aus.
Lösung
Installieren Sie sowohl die 32-Bit- als auch die 64-Bit-Version des BizTalk Adapter Pack auf einer 64-Bit-WCF-LOB-Adapter-SDK-Installation.
Von Bedeutung
Sie müssen nur über eine 64-Bit-WCF-LOB Adapter SDK-Installation verfügen. Die parallele Installation von 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-Komponenten 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 Sie die "Richtlinien-DLLs" auf dem Computer installiert und im GAC registriert haben. Weitere Informationen finden Sie unter Oracle Data Provider für .NET auf der Oracle-Website.