다음을 통해 공유

SQl 어댑터 설치 문제 해결

  • 아티클

중요

SQL 어댑터는 별도의 어댑터뿐만 아니라 BizTalk 어댑터 팩의 일부로 사용할 수 있습니다. BizTalk 어댑터 팩과 별개인 SQL 어댑터의 설치 문제에 대해 알아보려면 이 항목에 액세스하는 경우 BizTalk 어댑터 팩 설치 프로그램에 대한 모든 참조를 SQL 어댑터 설치로 해석해야 합니다.

Microsoft BizTalk 어댑터 팩을 설치하면 컴퓨터에 제품 이진 파일이 복사되고 각 어댑터에 대한 바인딩이 등록됩니다. 이 섹션에서는 문제 해결 기술을 사용하여 설치 오류를 resolve 설명합니다.

설치 작업에 대한 메시지 로깅

BizTalk 어댑터 팩 설치 프로그램은 BizTalk 어댑터 팩을 설치하는 표준 작업을 수행합니다. 또한 설정은 어댑터 바인딩 등록과 같은 특정 사용자 지정 작업도 수행합니다. 설정이 수행하는 사용자 지정 작업뿐만 아니라 표준에 대한 메시지를 기록할 수 있습니다.

  • BizTalk 어댑터 팩 설정은 MSI를 사용하여 어댑터 관련 파일을 설치합니다. 따라서 설정에 대한 로깅은 표준 MSI 로깅입니다.

  • 설치 프로그램이 수행하는 사용자 지정 작업에 대한 모든 로그는 %TEMP%\adaptersetup.log에서 사용할 수 있습니다. 로그 파일에 대한 추적이 실패하면 이벤트 로그에서도 추적을 사용할 수 있습니다.

알려진 문제

다음은 BizTalk 어댑터 팩을 설치할 때 발생할 수 있는 가장 일반적인 오류와 가능한 원인 및 해결 방법입니다.

어댑터 바인딩을 등록하지 못함

문제

Microsoft BizTalk 어댑터 팩 설치 마법사가 어댑터 바인딩을 등록하지 못하지만 어댑터 설치를 진행합니다.

원인

이로 인해 WCF(Windows Communication Foundation) 설치, Microsoft WCF(Windows Communication Foundation) LOB(기간 업무) 어댑터 SDK 설치 또는 machine.config 파일이 손상되는 문제가 발생할 수 있습니다. 어댑터 바인딩은 machine.config 파일에 기록됩니다.

해결 방법

SQL 어댑터 바인딩을 수동으로 등록해야 합니다.

어댑터 바인딩을 등록하려면

  1. 컴퓨터에서 machine.config 파일로 이동합니다. 예를 들어 32비트 플랫폼에서는 시스템 드라이브>:\WINDOWS\Microsoft.NET\Framework\<version>\CONFIG에서 <machine.config 사용할 수 있습니다.

    이 경로<에서 버전은> .NET Framework 버전입니다.

  2. 텍스트 편집기를 사용하여 파일을 엽니다.

  3. SQL 어댑터 바인딩을 등록하려면 다음을 수행합니다.

    1. "system.serviceModel" 요소를 검색하고 그 아래에 다음을 추가합니다.

      <client>  
  <endpoint binding="sqlBinding" contract="IMetadataExchange" name="mssql" />  
</client>

    2. system.serviceModel\extensions에서 요소 "bindingElementExtensions"를 검색합니다.

    3. 누락된 SQL 어댑터 바인딩을 찾습니다. "bindingElementExtensions" 노드 아래에 다음 섹션을 추가합니다.

      SQL 어댑터의 경우 다음을 추가합니다.

      <add name="sqlAdapter" type="Microsoft.Adapters.Sql.SqlAdapterBindingElementExtensionElement,Microsoft.Adapters.Sql, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />

    4. system.serviceModel\extensions에서 요소 "bindingExtensions"를 검색합니다.

    5. 누락된 SQL 어댑터 바인딩을 찾습니다. "bindingExtensions" 노드 아래에 다음 섹션을 추가합니다.

      SQL 어댑터의 경우 다음을 추가합니다.

      <add name="sqlBinding" type="Microsoft.Adapters.Sql.SqlAdapterBindingCollectionElement,Microsoft.Adapters.Sql, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />

    참고

    공개 키 및 버전을 확인하는 방법에 대한 자세한 내용은 공개 키 및 버전 확인을 참조하세요.

  4. machine.config 파일을 저장하고 닫습니다.

공개 키 및 버전 결정

SQL 어댑터의 공개 키를 확인하려면 다음 단계를 수행합니다.

공개 키를 확인하려면

  1. Windows 디렉터리(일반적으로 C:\WINDOWS\assembly)로 이동합니다.

  2. 공개 키와 버전을 원하는 DLL을 마우스 오른쪽 단추로 클릭한 다음 속성을 선택합니다. 다음 표에서는 SQL 어댑터용 DLL의 이름을 나열합니다.

    어댑터 DLL의 이름
    SQL 어댑터 Microsoft.Adapters.Sql

  3. 일반 탭에서 공개 키 토큰 레이블에 대한 값은 DLL에 대한 공개 키를 지정합니다. 마찬가지로 버전 레이블에 대한 값은 DLL의 버전 번호를 지정합니다.

  4. 공개 키를 복사한 다음 취소를 클릭합니다.

64비트 설치 시 어댑터 서비스 사용 추가 기능 또는 어댑터 서비스 참조 플러그 인 추가를 사용하는 동안 오류가 발생했습니다.

문제

64비트 버전의 BizTalk 어댑터 팩을 실행하는 64비트 컴퓨터에서 어댑터 서비스 참조 Visual Studio 플러그 인 추가 또는 Visual Studio에서 어댑터 서비스 BizTalk 프로젝트 추가 기능 사용을 사용하면 다음 오류가 발생합니다.

No valid adapters are installed on this machine

원인

SQL 어댑터는 machine.config 파일의 System.ServiceModel 아래에 등록된 WCF 사용자 지정 바인딩입니다. 64비트 플랫폼에는 두 개의 machine.config 파일이 있으며, 하나는 32비트 애플리케이션에서 사용되고 다른 하나는 64비트 애플리케이션에서 사용됩니다. 따라서 64비트 버전의 BizTalk 어댑터 팩을 설치하면 설치 마법사가 machine.config 파일의 64비트 버전에 바인딩을 등록합니다. 그러나 Visual Studio는 32비트 프로세스로 실행되므로 Visual Studio에서 어댑터 서비스 추가 기능 사용을 시작할 때 플러그 인은 machine.config 파일의 32비트 버전에서 바인딩을 확인하고 오류가 발생합니다.

해결 방법

64비트 WCF LOB 어댑터 SDK 설치에 32비트 및 64비트 버전의 BizTalk 어댑터 팩을 모두 설치합니다.

중요

64비트 WCF LOB 어댑터 SDK만 설치해야 합니다. 단일 컴퓨터에 32비트 및 64비트 WCF LOB 어댑터 SDK의 병렬 설치는 지원되지 않습니다.

64비트 설치 시 BizTalk Server 관리 콘솔에서 SQL 어댑터 포트를 구성하는 동안 잘못된 바인딩 오류

문제

BizTalk Server 관리 콘솔에서 어댑터에 대한 포트를 구성하려고 하면 다음 오류가 발생합니다.

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

원인

SQL 어댑터는 machine.config 파일의 System.ServiceModel 아래에 등록된 WCF 사용자 지정 바인딩입니다. 64비트 플랫폼에는 두 개의 machine.config 파일이 있으며, 하나는 32비트 애플리케이션에서 사용되고 다른 하나는 64비트 애플리케이션에서 사용됩니다. 따라서 64비트 버전의 BizTalk 어댑터 팩을 설치하면 설치 마법사가 machine.config 파일의 64비트 버전에 바인딩을 등록합니다. 그러나 BizTalk Server 관리 콘솔은 32비트 프로세스로 실행되므로 어댑터에 대한 포트를 구성할 때 machine.config 파일의 32비트 버전에서 바인딩을 확인하고 오류가 발생합니다.

해결 방법

64비트 WCF LOB 어댑터 SDK 설치에 32비트 및 64비트 버전의 BizTalk 어댑터 팩을 모두 설치합니다.

중요

64비트 WCF LOB 어댑터 SDK만 설치해야 합니다. 단일 컴퓨터에 32비트 및 64비트 WCF LOB 어댑터 SDK의 병렬 설치는 지원되지 않습니다.

참고 항목

SQL 어댑터 문제 해결