Compartir a través de

Solución de problemas de instalación con el adaptador de base de datos de Oracle

  • Artículo

La instalación del paquete de adaptadores de Microsoft BizTalk copia los archivos binarios del producto en el equipo y registra los enlaces de cada adaptador. En esta sección se describe el uso de técnicas de solución de problemas para resolver errores de instalación y también se enumeran algunos problemas conocidos.

Registrar mensajes para acciones de instalación

El programa de instalación del paquete de adaptador de BizTalk realiza la tarea estándar de instalar el paquete de adaptadores de BizTalk. Además, la configuración también realiza determinadas acciones personalizadas, como registrar los enlaces del adaptador. Puede registrar mensajes tanto para el estándar como para las acciones personalizadas que realiza la configuración.

  • El paquete de adaptador de BizTalk instala los archivos específicos del adaptador mediante msi. Por lo tanto, el registro de la instalación es el registro msi estándar.

  • Todos los registros de las acciones personalizadas que realiza el programa de instalación están disponibles en %TEMP%\adaptersetup.log. Si se produce un error en el seguimiento en el archivo de registro, los seguimientos también están disponibles en el registro de eventos.

El programa de instalación no puede registrar enlaces de adaptador

Problema

El Asistente para la instalación del paquete de adaptador de Microsoft BizTalk no puede registrar los enlaces del adaptador, pero continúa con la instalación del adaptador.

Causa

Esto puede deberse a problemas con la instalación de Windows Communication Foundation (WCF), la instalación del SDK del adaptador de línea de negocio (LOB) de Microsoft Windows Communication Foundation (WCF) o el archivo machine.config está dañado. Los enlaces del adaptador se escriben en el archivo machine.config.

Resolución

Registre manualmente el enlace del adaptador de Oracle Database:

  1. Vaya al archivo machine.config en el equipo. Por ejemplo, en una plataforma de 32 bits, el machine.config está disponible en <la unidad> del sistema:\WINDOWS\Microsoft.NET\Framework\<version>\CONFIG.

    En esta ruta de acceso, <la versión> es la versión de .NET Framework.

  2. Abra el archivo mediante un editor de texto.

  3. Para registrar el enlace del adaptador de base de datos de Oracle:

    1. Busque el elemento "system.serviceModel" y agregue lo siguiente en él:

      <client>
  <endpoint binding="oracleDBBinding" contract="IMetadataExchange" name="oracleDb" />
</client>

    2. Busque el elemento "bindingElementExtensions" en system.serviceModel\extensions.

    3. Busque el enlace del adaptador de base de datos de Oracle que falta. Agregue la siguiente sección en el nodo "bindingElementExtensions".

      Para el adaptador de Oracle Database, agregue:

      <add name="oracleDBAdapter" type="Microsoft.Adapters.OracleDB.OracleDBAdapterExtensionElement,Microsoft.Adapters.OracleDB, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />

    4. Busque el elemento "bindingExtensions" en system.serviceModel\extensions.

    5. Busque el enlace del adaptador de base de datos de Oracle que falta. Agregue la siguiente sección en el nodo "bindingExtensions".

      Para el adaptador de Oracle Database, agregue:

      <add name="oracleDBBinding" type="Microsoft.Adapters.OracleDB.OracleDBAdapterBindingSection,Microsoft.Adapters.OracleDB, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />

    Nota

    Para obtener información sobre cómo determinar la clave pública y la versión, consulte Determinación de la clave pública y la versión.

  4. Guarde y cierre el archivo machine.config.

Determinación de la clave pública y la versión

Realice los pasos siguientes para determinar la clave pública para el adaptador de Oracle Database.

  1. Vaya al directorio de Windows, normalmente C:\WINDOWS\assembly.

  2. Haga clic con el botón derecho en el archivo DLL para el que desea la clave pública y la versión y, a continuación, seleccione Propiedades. En la tabla siguiente se muestra el nombre del archivo DLL para el adaptador de base de datos de Oracle.

    Adapter (Adaptador) Nombre del archivo DLL
    Adaptador para base de datos de Oracle Microsoft.Adapters.OracleDB

  3. En la pestaña General , el valor de la etiqueta Token de clave pública especifica la clave pública para el archivo DLL. Del mismo modo, el valor de la etiqueta Version especifica el número de versión del archivo DLL.

  4. Copie la clave pública y, a continuación, haga clic en Cancelar.

Error al usar el complemento Consumir servicio de adaptador o agregar complemento de referencia de servicio de adaptador en una instalación de 64 bits

Problema

El uso del complemento Agregar referencia de servicio de adaptador de Visual Studio o el complemento consumir el proyecto de BizTalk del servicio adaptador de BizTalk desde Visual Studio en un equipo de 64 bits que ejecuta la versión de 64 bits del paquete de adaptadores de BizTalk produce el siguiente error:

No valid adapters are installed on this machine

Causa

El adaptador de base de datos de Oracle es un enlace personalizado de WCF, que se registra en System.ServiceModel en el archivo machine.config. Una plataforma de 64 bits tiene dos archivos machine.config, uno utilizado por las aplicaciones de 32 bits y el otro utilizado por las aplicaciones de 64 bits. Por lo tanto, al instalar la versión de 64 bits del paquete de adaptadores de BizTalk, el asistente para la instalación registra los enlaces en la versión de 64 bits del archivo machine.config. Sin embargo, Visual Studio se ejecuta como un proceso de 32 bits y, por lo tanto, al iniciar el complemento Consumir servicio de adaptador desde Visual Studio, el complemento comprueba los enlaces de la versión de 32 bits del archivo de machine.config y produce un error.

Resolución

  • Instale las versiones de 32 y 64 bits del paquete de adaptadores de BizTalk en una instalación del SDK del adaptador de LOB de WCF de 64 bits.

    Importante

    Solo debe tener una instalación del SDK del adaptador de LOB de WCF de 64 bits. No se admite la instalación en paralelo del SDK del adaptador de LOB de WCF de 32 y 64 bits en un solo equipo.

  • Instale las versiones de 32 y 64 bits de Oracle Data Access Components para Oracle Client 11.1.0.6 con patch Set 11.1.0.7.

    Nota

    Para asegurarse de que la aplicación funciona con la versión más reciente de ODP.NET, debe tener instalados los archivos DLL de directiva en el equipo y registrados en la GAC. Para obtener más información, vea Proveedor de datos de Oracle para .NET en el sitio web de Oracle.

Error de enlace no válido al configurar los puertos del adaptador de base de datos de Oracle en BizTalk Server Consola de administración en una instalación de 64 bits

Problema

Al intentar configurar un puerto para el adaptador en BizTalk Server consola de administración, obtendrá el siguiente error:

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

Causa

El adaptador de base de datos de Oracle es un enlace personalizado de WCF, que se registra en System.ServiceModel en el archivo machine.config. Una plataforma de 64 bits tiene dos archivos machine.config, uno utilizado por las aplicaciones de 32 bits y el otro utilizado por las aplicaciones de 64 bits. Por lo tanto, al instalar la versión de 64 bits del paquete de adaptadores de BizTalk, el asistente para la instalación registra los enlaces en la versión de 64 bits del archivo machine.config. Sin embargo, BizTalk Server consola de administración se ejecuta como un proceso de 32 bits y, por lo tanto, al configurar un puerto para el adaptador, comprueba si hay enlaces en la versión de 32 bits del archivo de machine.config y se produce un error.

Resolución

  • Instale las versiones de 32 y 64 bits del paquete de adaptadores de BizTalk en una instalación del SDK del adaptador de LOB de WCF de 64 bits.

    Importante

    Solo debe tener una instalación del SDK del adaptador de LOB de WCF de 64 bits. No se admite la instalación en paralelo del SDK del adaptador de LOB de WCF de 32 y 64 bits en un solo equipo.

  • Instale las versiones de 32 y 64 bits de Oracle Data Access Components para Oracle Client 11.1.0.6 con patch Set 11.1.0.7.

    Nota

    Para asegurarse de que la aplicación funciona con la versión más reciente de ODP.NET, debe tener instalados los archivos DLL de directiva en el equipo y registrados en la GAC. Para obtener más información, vea Proveedor de datos de Oracle para .NET en el sitio web de Oracle.

Consulte también

Solución de problemas del adaptador de Oracle Database