Solución de problemas de instalación con el adaptador de SQl
Importante
El adaptador de SQL está disponible como parte del paquete de adaptadores de BizTalk, así como un adaptador independiente. Si accede a este tema para conocer los problemas de instalación con el adaptador de SQL que es independiente del paquete de adaptadores de BizTalk, todas las referencias al paquete de adaptadores de BizTalk deben interpretarse como configuración del adaptador de SQL.
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.
Registrar mensajes para acciones de configuración
El programa de instalación del paquete de adaptadores de BizTalk realiza la tarea estándar de instalar el paquete de adaptadores de BizTalk. Además, el programa de instalació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 programa de instalación del paquete de adaptador de BizTalk instala los archivos específicos del adaptador mediante un 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.
Problemas conocidos
A continuación se muestran los errores más comunes que puede encontrar al instalar el paquete de adaptadores de BizTalk, junto con su causa y resolución probables.
El programa de instalación no puede registrar enlaces de adaptador
Problema
El Asistente para la instalación del paquete de adaptadores 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
Debe registrar manualmente el enlace del adaptador de SQL.
Para registrar el enlace del adaptador
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.
Abra el archivo mediante un editor de texto.
Para registrar el enlace del adaptador de SQL:
Busque el elemento "system.serviceModel" y agregue lo siguiente en él:
<client> <endpoint binding="sqlBinding" contract="IMetadataExchange" name="mssql" /> </client>Busque el elemento "bindingElementExtensions" en system.serviceModel\extensions.
Busque el enlace del adaptador de SQL que falta. Agregue la siguiente sección en el nodo "bindingElementExtensions".
Para el adaptador de SQL, agregue:
<add name="sqlAdapter" type="Microsoft.Adapters.Sql.SqlAdapterBindingElementExtensionElement,Microsoft.Adapters.Sql, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />Busque el elemento "bindingExtensions" en system.serviceModel\extensions.
Busque el enlace del adaptador de SQL que falta. Agregue la siguiente sección en el nodo "bindingExtensions".
Para el adaptador de SQL, agregue:
<add name="sqlBinding" type="Microsoft.Adapters.Sql.SqlAdapterBindingCollectionElement,Microsoft.Adapters.Sql, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />
Nota
Para obtener información sobre cómo determinar la clave pública y la versión, vea Determinar la clave pública y la versión.
Guarde y cierre el archivo machine.config.
Determinar la clave pública y la versión
Realice los pasos siguientes para determinar la clave pública para el adaptador de SQL.
Para determinar la clave pública
Vaya al directorio de Windows, normalmente C:\WINDOWS\assembly.
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 SQL.
Adapter (Adaptador) Nombre del archivo DLL Adaptador de SQL Microsoft.Adapters.Sql 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.
Copie la clave pública y, a continuación, haga clic en Cancelar.
Error al usar el complemento consumir servicio 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 de proyecto de BizTalk del servicio de adaptador de Consumo 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 da como resultado el siguiente error:
No valid adapters are installed on this machine
Causa
El adaptador de SQL 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 usado 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 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 en la versión de 32 bits del archivo machine.config y produce un error.
Resolución
Instale las versiones de 32 bits 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.
Error de enlace no válido al configurar los puertos del adaptador de SQL 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 "sqlBinding".
Verify the binding extension is registered in machine.config."
Causa
El adaptador de SQL 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 usado 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 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 los enlaces en la versión de 32 bits del archivo machine.config y produce un error.
Resolución
Instale las versiones de 32 bits 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.