BizTalk 애플리케이션을 가져오는 방법

아티클
05/04/2023

이 항목에서는 BizTalk Server 관리 콘솔 또는 명령줄을 사용하여 BizTalk 응용 프로그램을 BizTalk 그룹으로 가져오는 방법에 대해 설명합니다. BizTalk 응용 프로그램을 가져오면 아티팩트가 BizTalk 관리 데이터베이스에 등록되고 아티팩트의 데이터가 해당 BizTalk 데이터베이스에 기록됩니다. 자세한 내용은 아티팩트가 가져올 때 발생하는 동작을 참조하세요. 응용 프로그램을 가져올 때 응용 프로그램이 설치되지는 않습니다. 응용 프로그램을 실행하려면 파일 기반 아티팩트를 포함하는 응용 프로그램을 설치해야 합니다.

BizTalk Server 관리 콘솔을 사용하여 응용 프로그램을 가져올 경우에는 MSI 가져오기 마법사를 시작하는 위치에서 아티팩트를 가져오는 동시에 새 응용 프로그램을 만들 수 있는지 여부를 결정합니다. BizTalk 그룹을 마우스 오른쪽 단추로 클릭하여 마법사를 시작할 경우 응용 프로그램 이름을 제공해야 합니다. BizTalk 그룹의 기존 응용 프로그램에 지정된 이름이 있으면 이 응용 프로그램으로 파일의 아티팩트를 가져오고, 그렇지 않으면 지정한 이름을 가진 새 응용 프로그램이 만들어지고 새 응용 프로그램으로 아티팩트를 가져옵니다. 응용 프로그램을 마우스 오른쪽 단추로 클릭하여 마법사를 시작하면 응용 프로그램 이름을 지정할 수 없으며 아티팩트를 현재 응용 프로그램으로 가져옵니다.

BTSTask 명령줄 도구를 사용하여 .msi 파일을 가져올 경우 응용 프로그램 이름을 제공할 수도 있습니다. 이름을 제공하지 않으면 해당 아티팩트를 기본 응용 프로그램으로 가져옵니다.

아티팩트를 가져온 후에는 BizTalk Server 관리 콘솔에서 응용 프로그램의 폴더 아래에 있는 해당 폴더에서 이를 확인할 수 있습니다. ListApp 명령에 설명된 대로 BTSTask를 사용하여 애플리케이션에서 아티팩트 목록을 볼 수도 있습니다.

필수 구성 요소

BizTalk 응용 프로그램을 가져오려면 BizTalk Server 관리자 그룹의 구성원인 계정으로 로그온해야 합니다. BizTalk 응용 프로그램을 설치하려면 로컬 파일 시스템에 대한 쓰기 권한도 있어야 합니다. 권한에 대한 자세한 내용은 BizTalk 애플리케이션 배포 및 관리에 필요한 권한을 참조하세요.

응용 프로그램을 가져올 때 고려할 사항

응용 프로그램을 가져올 때에는 다음 사항을 고려해야 합니다.

이전 버전의 BizTalk Server 애플리케이션 가져오기 BizTalk Server 2006 R2 또는 BizTalk Server 2009에서 애플리케이션을 가져오고 애플리케이션에 EDI/AS2 파티 데이터가 포함된 경우 BizTalk Server 거래 파트너 관리 모델이 상당히 변경되어 애플리케이션 가져오기가 실패할 수 있습니다. 대신 파티 마이그레이션 도구를 사용하여 이전 버전 BizTalk Server의 파티 데이터를 마이그레이션해야 합니다. 도구에 대한 자세한 내용은 EDI 마이그레이션 유틸리티를 참조하세요.
가져온 바인딩이 항상 기존 바인딩을 덮어씁니다. 바인딩이 포함된 .msi 파일을 기존 응용 프로그램으로 가져오면 동일한 이름의 가져온 바인딩이 기존 바인딩을 덮어씁니다. 이는 .msi 파일을 가져올 때 기존 아티팩트를 덮어쓰는 옵션을 선택하지 않은 경우에도 마찬가지입니다. 내보내는 응용 프로그램의 바인딩이 .msi 파일을 가져오는 응용 프로그램의 바인딩을 덮어쓰지 않도록 하려면 바인딩 파일을 내보내기 작업 중 내보낼 리소스로 선택하지 마십시오. 자세한 내용은 BizTalk 애플리케이션 내보내기를 참조하세요.

바인딩은 가져오기 프로세스 중에 적용되므로 이름이 같은 바인딩을 새로 적용하면 기존에 적용된 바인딩을 덮어씁니다. 즉, 이름이 같은 경우 마지막으로 적용되는 바인딩이 유효합니다. 응용 프로그램을 가져올 때 바인딩은 다음과 같은 순서로 적용됩니다.
1. BizTalk Server에서 생성된 응용 프로그램 바인딩으로, 바인딩 파일을 통해 응용 프로그램에 명시적으로 추가되지 않았지만 응용 프로그램 .msi 파일로 내보내도록 사용자가 명시적으로 선택한 응용 프로그램 바인딩
2. 명시적으로 추가되었으며 지정된 대상 배포 환경이 없는 바인딩 파일. 이 집합의 바인딩은 순서에 관계없이 적용됩니다.
3. 명시적으로 추가되었으며 응용 프로그램 가져오기를 위해 선택한 배포 환경과 일치하는 연결된 대상 배포 환경이 있는 바인딩. 이 집합의 바인딩은 순서에 관계없이 적용됩니다.
호스트가 그룹에 있어야 합니다. .msi 파일에 포함된 응용 프로그램 바인딩에서 지정된 호스트에 해당하는 호스트가 이미 BizTalk 그룹에 있어야 합니다. 그렇지 않으면 가져오기 작업이 실패합니다. 또한 호스트 신뢰 수준이 일치해야 합니다.
다른 응용 프로그램에 대한 참조를 추가해야 할 수도 있습니다. 가져올 응용 프로그램이 다른 응용 프로그램의 아티팩트를 사용하는 경우 이 응용 프로그램에 대한 참조를 추가해야 합니다. 응용 프로그램 및 필수 아티팩트는 이미 그룹에 있어야 합니다. 가져오기 마법사는 이 옵션을 제공합니다. 그러나 BTSTask의 ImportApp 명령을 사용하는 경우 다른 애플리케이션에 참조를 추가하는 방법에 설명된 대로 가져온 후 애플리케이션에 참조를 추가해야 합니다. 배경 정보는 종속성 및 애플리케이션 배포를 참조하세요. 가져오기 마법사는 참조를 그룹의 기존 응용 프로그램과 일치시키고 새 참조를 추가하거나 기존 참조를 변경하는 옵션을 제공합니다. 참조된 응용 프로그램이 필수 아티팩트를 포함하는지 확인하는 추가 단계를 수행하십시오.
가져오기 작업 시간이 초과하면 응용 프로그램을 추가 .msi 파일로 분할합니다. 가져오기 작업이 3600초를 초과하면 작업이 종료됩니다. .msi 파일을 가져올 때 작업 시간이 초과되면 내보낼 아티팩트 하위 집합을 선택하고 응용 프로그램을 다시 내보내서 두 개 이상의 .msi 파일로 응용 프로그램 내용을 나눠야 합니다. 자세한 내용은 BizTalk 애플리케이션 내보내기를 참조하세요.

중요

보안상의 이유로 응용 프로그램을 내보낼 때 응용 프로그램 바인딩에서 암호가 제거됩니다. 그러나 응용 프로그램에 추가된 바인딩 파일에서는 암호가 제거되지 않습니다. 응용 프로그램을 가져온 후 응용 프로그램이 작동하려면 암호를 다시 구성해야 합니다. 바인딩 파일을 편집하거나 관리 콘솔을 사용하여 암호를 다시 구성할 수 있습니다. 바인딩 파일을 편집하는 방법에 대한 자세한 내용은 바인딩 파일 사용자 지정을 참조하세요. 어댑터에 대한 보안을 구성하는 방법에 대한 자세한 내용은 어댑터 사용을 참조하세요.

참고

가져오기가 실패하면 BizTalk Server는 사용자 지정 스크립트에서 수행한 작업을 제외한 모든 가져오기 작업을 롤백합니다.

참고

다른 응용 프로그램의 속성 스키마를 사용하는 한 응용 프로그램에서 송신 포트에 대한 필터를 만든 다음 첫 번째 응용 프로그램을 새 BizTalk 그룹으로 가져올 경우 스키마가 누락되었다는 경고가 표시되지 않으며 응용 프로그램이 설치 및 시작될 때 필터링이 작동하지 않습니다. 스키마를 포함하지 않는 응용 프로그램을 설치하기 전에 스키마가 포함된 응용 프로그램을 가져와서 문제를 해결할 수 있습니다.

BizTalk Server 관리를 사용하여 BizTalk 앱 가져오기

시작을 클릭하고 모든 프로그램을 클릭하고 Microsoft BizTalk Server 20xx를 클릭한 다음 BizTalk Server 관리를 클릭합니다.
콘솔 트리에서 BizTalk Server 관리를 확장하고 BizTalk 그룹을 확장한 다음 다음 중 하나를 수행합니다.
- .msi 파일에 포함된 애플리케이션 및 아티팩트 를 BizTalk 그룹으로 가져오려면 애플리케이션을 마우스 오른쪽 단추로 클릭하고 가져오기를 가리킨 다음 MSI 파일을 클릭합니다.
- .msi 파일에 포함된 아티팩트를 기존 애플리케이션으로 가져오려면 애플리케이션을 확장하고 애플리케이션을 마우스 오른쪽 단추로 클릭하고 가져오기를 가리킨 다음 MSI 파일을 클릭합니다.
MSI 가져오기 마법사 시작 페이지의 가져올 MSI 파일에서 .msi 파일의 경로를 입력하고 다음을 클릭합니다. 필요한 경우 ... 단추를 클릭하여 .msi 파일을 찾아볼 수 있습니다.
애플리케이션 설정 페이지의 애플리케이션 이름 드롭다운 목록에서 애플리케이션 이름을 선택합니다(사용 가능한 경우). 이 목록은 응용 프로그램을 BizTalk 그룹에 가져올 경우 사용합니다.

참고

목록에는 현재 BizTalk 그룹에 있는 모든 응용 프로그램의 이름과 .msi 파일을 내보낸 응용 프로그램 이름이 포함됩니다. 후자의 응용 프로그램 이름을 선택할 경우 응용 프로그램이 아직 이 BizTalk 그룹에 없으면 가져오기 마법사에서 새 응용 프로그램을 만듭니다. 이미 그룹에 있는 응용 프로그램을 선택하면 가져오기 마법사는 .msi 파일에서 기존 응용 프로그램으로 아티팩트를 가져옵니다.
참조를 추가할 수 있는 애플리케이션에서 참조를 추가할 애플리케이션(있는 경우)을 선택하고 다음을 클릭합니다.
.msi 파일을 기존 애플리케이션으로 가져오고 기존 애플리케이션에서 아티팩트를 덮어쓰려면 리소스 덮어쓰기를 선택합니다.

참고

이 옵션을 선택하지 않고, 이미 응용 프로그램에 있는 아티팩트가 .msi 파일에 포함되어 있을 경우 가져오기 작업은 실패하고 롤백됩니다. BizTalk 응용 프로그램 또는 그룹에 있는 특정 유형의 아티팩트는 고유해야 합니다. BizTalk 그룹에 이미 있지만 현재 응용 프로그램에는 없는 아티팩트를 추가할 경우 가져오기 작업은 덮어쓰기 옵션을 지정하더라도 실패합니다. 고유해야 하는 아티팩트와 고유해야 하는 방법에 대한 자세한 내용은 애플리케이션 또는 그룹에서 고유해야 하는 아티팩트를 참조하세요.
애플리케이션 대상 환경 설정 페이지의 대상 스테이징 환경 드롭다운 목록에서 이 애플리케이션의 대상 환경을 선택하고 다음을 클릭합니다. 이 목록에는 이 응용 프로그램에 추가된 바인딩 파일에 대해 지정된 모든 환경이 포함되어 있습니다. 대상 환경이 지정된 바인딩을 제외한 애플리케이션의 모든 바인딩을 적용하려면 기본값>을 선택합니다<. .msi 파일에 명시적으로 적용하려는 바인딩 파일이 없는 경우 기본값>을 선택한 상태로 둘 <수 있습니다.

참고

바인딩 파일을 응용 프로그램에 추가할 때 바인딩에 대한 대상 환경을 지정합니다. 배경 정보는 바인딩 파일 및 애플리케이션 배포를 참조하세요. 바인딩 파일을 추가하는 방법에 대한 지침은 애플리케이션에 바인딩 파일을 추가하는 방법을 참조하세요.
요약 가져오기 페이지에서 요약 정보가 올바른지 확인한 다음 가져오기를 클릭합니다.
가져오기 성공 페이지에서 로컬 컴퓨터에 애플리케이션을 설치하려면 애플리케이션 설치 마법사 실행을 선택하여 로컬 컴퓨터 검사 애플리케이션을 설치합니다.

참고

응용 프로그램을 현재 로컬 컴퓨터에 구성된 대로 실행해야 하는 경우가 아니면 응용 프로그램을 설치할 필요가 없습니다. 그러나 응용 프로그램이 파일 기반 아티팩트를 포함할 경우에는 응용 프로그램을 가져올 때 응용 프로그램이 BizTalk 관리 데이터베이스에만 추가되므로 응용 프로그램이 작동을 시작하려면 이를 실행할 모든 컴퓨터에 응용 프로그램을 설치해야 합니다.
Finish를 클릭합니다.

참고

예를 들어 로컬 파일 시스템에 대한 쓰기 권한이 없어 설치가 실패하면 설치는 롤백되지만 가져오기 작업은 롤백되지 않습니다.

명령줄을 사용하여 BizTalk 앱 가져오기

다음과 같이 명령 프롬프트를 엽니다. 시작을 클릭하고 실행을 클릭한 다음 를 입력 cmd한 다음 확인을 클릭합니다.

다음 표에 설명된 것과 같이 적절한 값으로 대체하여 다음 명령을 입력합니다.

BTSTask ImportApp /Package:value [/Environment:value] [/ApplicationName:value] [/Overwrite] [/Server:value] [/Database:value]

예제:

BTSTask ImportApp /Package:"C:\MSI Files\MyApplication.msi" /Environment:Test /ApplicationName:MyApplication /Overwrite

매개 변수	값
/패키지	.msi 파일의 전체 경로입니다. 경로에 공백이 포함된 경우 경로를 따옴표(")로 묶어야 합니다.
/환경	Test 등과 같은 적용할 바인딩 파일의 대상 배포 환경입니다. 이 값은 바인딩 파일을 응용 프로그램에 추가할 때 대상 배포 환경에 지정된 값입니다.
/Applicationname	.msi 파일에서 아티팩트를 가져올 BizTalk 응용 프로그램의 이름입니다. 이 값을 지정하지 않으면 .msi 파일을 내보낼 때 지정된 응용 프로그램 이름이 사용됩니다. 지정된 응용 프로그램이 없으면 응용 프로그램이 만들어집니다. 공백을 포함하는 응용 프로그램 이름은 큰따옴표(")로 묶어야 합니다.
/덮어쓸	응용 프로그램의 아티팩트를 LUID(Locally Unique Identifier)가 동일한 .msi 파일의 아티팩트로 덮어쓰기 위한 옵션입니다. 이 옵션을 지정하지 않은 경우 .msi 파일의 아티팩트와 LUID가 동일한 아티팩트가 응용 프로그램에 하나 이상 있으면 가져오기가 실패합니다. ListApp 명령을 사용하여 애플리케이션에서 아티팩트 LUID를 볼 수 있습니다.
/서버	BizTalk 관리 데이터베이스를 호스트하는 SQL Server 인스턴스의 이름(서버 이름\인스턴스 이름,포트 형식)입니다. 인스턴스 이름은 해당 인스턴스 이름이 서버 이름과 다른 경우에만 필요합니다. 포트는 SQL Server에서 기본 포트 번호(1433) 이외의 포트 번호를 사용하는 경우에만 필요합니다. 예: Server=MyServer Server=MyServer\MySQLServer,1533 이 값을 지정하지 않으면 로컬 컴퓨터에서 실행 중인 SQL Server 인스턴스의 이름이 사용됩니다.
/데이터베이스	BizTalk 관리 데이터베이스의 이름입니다. 이 값을 지정하지 않으면 로컬 SQL Server 인스턴스에서 실행 중인 BizTalk 관리 데이터베이스가 사용됩니다.

참고 항목

BizTalk 애플리케이션, 바인딩 및 정책 가져오기
ImportApp 명령

다음을 통해 공유