통합 팩 마법사
IP 마법사(통합 팩 마법사)를 사용하면 기존 통합 어셈블리에서 새 통합 팩을 만들 수 있습니다. 통합 어셈블리 는 명령줄 작업 마법사(CLIActivityWizard)를 사용하거나 Orchestrator SDK를 사용하여 작성할 수 있습니다. IP 마법사(IPWizard)는 어셈블리, 종속 파일 및 필수 메타데이터를 Orchestrator 배포 관리자를 .OIP 통해 배포할 수 있는 파일로 패키지합니다.
전체 브랜딩 및 사용자 지정 아이콘으로 전문적인 통합 팩을 만들거나 IP 마법사를 사용하여 보다 쉽게 배포할 수 있도록 명령줄 작업을 패키지로 만들 수 있습니다.
통합 팩을 만들 시기 결정
도구 키트 의 .NET 통합 팩 활동과 함께 활동을 개별적으로 사용하는 것이 적절한지 또는 통합 팩 의 모든 활동을 만들고 배포하는 것이 더 좋은지 결정하는 것이 중요합니다.
활동이 거의 없거나 개발 단계에 있고 활동의 많은 변경 내용을 만드는 경우 도구 키트 .NET 통합 팩 작업과 함께 어셈블리를 사용하여 Runbook에서 해당 작업을 실행하면 됩니다. 통합 팩의 패키징, 등록, 배포, 제거 및 업그레이드는 개발 과정에서 큰 오버헤드를 발생합니다.
테스트할 활동 그룹이 있거나 개발 주기에서 더 나아가 설치 또는 업그레이드의 전체 엔드 투 엔드 프로세스를 테스트하려는 경우 통합 팩을 만드는 것이 더 나은 방법입니다. 통합 팩은 사용자 친화적인 환경과 완전한 설치 환경을 제공합니다. 통합 팩을 사용하면 조직 전체 또는 외부 고객에게 여러 Runbook Server 또는 Runbook Designer에 활동을 배포할 수 있습니다.
새 통합 팩 만들기
통합 팩 마법사를 사용하면 기존 Orchestrator 호환 어셈블리 및 종속 파일에서 통합 팩을 만들 수 있습니다. Orchestrator 호환 어셈블리를 아직 만들지 않은 경우 명령줄 작업 마법사를 참조하세요.
참고 항목
통합 도구 키트에는 더 이상 사용자 지정 통합 팩을 만들기 위해 IP 마법사에서 사용하는 WiX(Windows Installer XML) 도구 집합에 대한 이진 파일이 포함되어 있지 않습니다. IP 마법사를 사용하기 전에 WiX 도구 집합의 최신 버전(v3.11)을 설치하세요.
새 통합 팩을 만들려면 다음 단계를 수행합니다.
통합 팩 마법사를 시작합니다. 오케스트레이터 통합 팩 시작 > 마법사를 선택합니다. 시작 페이지가 표시됩니다.
업데이트하려는 기존 통합 팩이 있는 경우 통합 팩 가져오기를 선택합니다. 자세한 내용은 기존 통합 팩 업데이트를 참조 하세요. 새 통합 팩을 만들려면 다음을 선택합니다.
Important
기존 IP를 업그레이드하려면 통합 팩 가져오기를 선택해야 합니다. 다음을 선택하면 이전 어셈블리를 다시 사용하고 동일한 제품 및 파일 이름을 사용하는 경우에도 만든 IP에 모든 활동에 대한 새로운 고유한 제품 ID와 새 고유 ID가 있습니다.
제품 세부 정보 페이지에서 필요에 따라 정보를 입력하거나 수정하여 통합 팩에 대한 정보를 사용자 지정합니다. 아래 표에서는 필드 및 해당 설명에 대해 설명합니다.
필드 이름 설명 제품 이름 Deployment Manager에 표시되는 IP의 이름 범주 이름 Runbook Designer의 활동 창에서 IP의 범주 제목으로 표시되는 텍스트 회사 회사의 이름입니다. 이 정보는 "게시자" 아래의 프로그램 추가/제거에 표시됩니다. EULA 파일 확장이 있는 RTF 형식의 텍스트 파일입니다 .EULA. EULA는 배포 관리자를 사용하여 등록하는 동안 사용자에게 표시되며 등록 전에 동의가 필요합니다.리소스 파일 범주 및 활동 아이콘을 제공하는 데 사용되는 아이콘 및 기타 리소스를 포함하는 어셈블리입니다. 기본적으로 표준 도구 키트 리소스 파일이 사용됩니다(Microsoft.SystemCenter.Orchestrator.Integration.Toolkit.Wizard.Images.dll). 버전 배포 관리자에 표시되고 IP가 업그레이드인지 확인하는 데 사용되는 통합 팩의 버전 번호입니다. 업그레이드 사용 기존 통합 팩을 가져온 경우 이 확인란이 기본적으로 선택되어 이 통합 팩이 설치된 기존 버전을 업그레이드할 수 있도록 합니다. 이 확인란의 선택을 취소하면 IP에 대한 새 제품 및 활동 ID가 만들어집니다(기존 버전을 업그레이드하지 않음). 여러 버전의 IP를 나란히 설치하도록 설정하려면 이 확인란의 선택을 취소합니다. 설명 통합 팩에 대한 자세한 설명 범주 아이콘 기본 범주 아이콘이 표시됩니다. 다른 아이콘을 선택하려면 수정 단추를 선택하고 새 아이콘을 선택한 다음 확인을 선택합니다. 제품 정보 입력이 완료되면 다음을 선택합니다. 활동 페이지가 표시됩니다. 작업 페이지에서는 명령줄 작업 마법사를 사용하여 정의했거나 Orchestrator SDK를 사용하여 만든 활동을 포함하는 어셈블리 또는 어셈블리를 참조합니다.
IP에 새 활동을 추가하려면 추가를 선택합니다.
어셈블리 파일을 열고 추가하려면 라이브러리 오른쪽에 있는 줄임표(...) 단추를 선택합니다. 원하는 어셈블리 파일로 이동하여 선택하고 열기를 선택합니다. 파일 이름과 경로가 라이브러리 필드에 표시됩니다.
어셈블리 에서 활동을 선택하려면 클래스 드롭다운 화살표를 선택하고 목록에서 적절한 활동 이름을 선택합니다. 활동에 정의된 이름과 설명은 표시 이름 및 설명 필드에 표시됩니다.
원하는 경우 활동의 표시 이름 및 설명을 수정합니다.
작업에 대한 기본 활동 아이콘이 표시됩니다. 다른 아이콘이 필요한 경우 수정을 선택하고 브라우저에서 다른 아이콘을 선택한 다음 확인을 선택합니다.
확인을 선택하여 작업 정의를 저장합니다. 이제 활동 이름 및 설명이 활동 목록에 표시됩니다.
필요에 따라 목록에 활동을 계속 추가합니다. 활동 추가가 완료되면 다음을 선택합니다. 종속성 및 포함된 파일 페이지가 표시됩니다.
이 페이지에서 통합 팩을 사용하여 패키지하려는 추가 파일 목록을 정의할 수 있습니다. 이러한 파일은 활동, 스크립트, 설명서 또는 Runbook 서버 및 Runbook Designer에 배포하려는 기타 파일에 필요한 추가 어셈블리일 수 있습니다. 추가를 선택하고 필요한 파일을 선택한 다음 확인을 선택하여 목록에 파일을 추가합니다.
목록에 파일 추가를 마쳤으면 다음을 선택합니다. 오케스트레이터 통합 팩 파일 페이지가 표시됩니다.
제공된 텍스트 상자에 만들 통합 팩의 경로와 파일 이름을 입력합니다. 이미 존재하는 파일 이름을 입력하면 덮어씁니다. 지정된 경로에 쓸 수 있는 액세스 권한이 충분한지 또는 프로세스가 실패하는지 확인합니다. 경로를 지정하지 않으면 문서 폴더(
C:\users\<your username>\Documents)에 OIP 파일이 만들어집니다. 다음을 선택하여 IP 빌드를 시작합니다.Important
파일 이름의 문자는 운영 체제에 설치된 언어에 유효해야 합니다.
Important
일반적이지 않은 통합 팩의 이름을 지정하여 다른 통합 팩의 이름과 일치하지 않도록 합니다. 오케스트레이터는 이름이 같은 두 개의 통합 팩을 설치할 수 없습니다.
IP가 성공적으로 빌드되면 마법사의 마지막 페이지에 새 OIP 파일의 경로와 파일 이름이 표시됩니다. 마침을 선택하여 마법사를 종료합니다. 오류가 발생하면 [뒤로]를 선택하고 빌드 프로세스를 다시 시도할 수 있습니다.
통합 팩 배포에 대한 자세한 내용은 통합 팩을 추가하는 방법 문서를 참조하세요.
기존 통합 팩 업데이트
오케스트레이터 통합 팩 마법사를 사용하면 기존 통합 팩을 가져와서 변경하고 새 버전으로 다시 패키징할 수 있습니다. 업그레이드 사용 확인란을 선택했는지 확인합니다. 그렇지 않으면 이전에 설치된 버전을 교체하거나 업그레이드하는 대신 새 IP가 만들어집니다.
유용한 IP 업그레이드 팁
기본 어셈블리 업데이트
통합 팩을 만들 때 후속 업그레이드 중에 마법사에서 읽을 수 있도록 IP에 대한 메타데이터가 패키지에 저장됩니다. 해당 활동에 대한 활동 또는 기본 어셈블리와 같은 특정 항목을 업데이트하는 경우 IP를 다시 빌드해야 합니다. 그러나 활동 설정을 수정하고 새 어셈블리 파일을 선택하면 활동 정보 페이지의 필드가 다시 설정되므로 정보를 다시 입력해야 합니다.
어셈블리만 수정하는 동안 IP 구성 설정을 유지할 수 있습니다. 새 어셈블리를 이전 어셈블리와 동일한 경로 및 파일 이름에 저장합니다(활동 정보 대화 상자의 라이브러리 필드에 표시됨).
QIK 통합 팩 마이그레이션
Opalis QIK 마법사를 사용하여 통합 팩을 만든 경우 Orchestrator에서 가져오고 사용하려면 오케스트레이터와 호환되도록 변환해야 합니다.
IP를 변환하기 전에 다음 단계를 완료해야 합니다.
QIK CLI 마법사를 사용하여 IP의 활동을 만든 경우 QIK CLI 활동 마이그레이션에 설명된 단계에 따라 Orchestrator와 호환되도록 해야 합니다. 작업을 포함하는 어셈블리의 별도 복사본이 없는 경우 먼저 Opalis 6.3 서버에 IP를 설치한 다음, 다음 디렉터리
C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Quick Integration Kit 3에서 어셈블리를 찾아야 합니다.IP의 활동이 Opalis API를 사용하여 C#에서 사용자 지정으로 개발된 경우 QIK API 사용자 지정 작업 마이그레이션에 설명된 단계에 따라 Orchestrator와 호환되도록 해야 합니다.
참고 항목
Java용 Opalis API를 사용하는 Java 기반 활동은 통합 도구 키트 또는 Orchestrator에서 더 이상 지원되지 않습니다.
IP에 종속 또는 기타 포함된 파일이 포함된 경우 해당 파일을 사용하여 새 IP로 다시 패키지해야 합니다. 이러한 파일의 별도 복사본이 없는 경우 먼저 Opalis 6.3 서버에 IP를 설치한 다음 다음 디렉터리
C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Bin에서 파일을 찾아야 합니다.IP에 활동 및 범주 아이콘에 사용되는 사용자 지정 리소스 파일이 포함된 경우 해당 파일을 새 IP에 사용할 수 있어야 합니다. 이 파일의 별도 복사본이 없는 경우 먼저 Opalis 6.3 서버에 IP를 설치한 다음 다음 디렉터리
C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions에서 파일을 찾아야 합니다.IP가 범주 또는 활동 아이콘에 대해 QIK에서 제공하는 표준 아이콘을 사용하고 Orchestrator에 제공된 새 아이콘을 사용하는 대신 해당 아이콘을 계속 사용하려는 경우 파일을 가져와
Opalis.QIK.Wizard.Images.dll서 사용자 지정 리소스 파일처럼 사용해야 합니다. 이 파일의 별도 복사본이 없는 경우 먼저 Opalis 6.3 서버에 IP를 설치한 다음 다음 디렉터리C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions에서 파일을 찾아야 합니다.
참고 항목
가장 쉬운 변환 프로세스를 위해 IP 마법사를 시작하기 전에 IP가 원래 패키지되었을 때의 위치에 이러한 파일을 모두 배치해야 합니다. IP 마법사는 원래 경로로 이러한 파일을 참조합니다. 모든 파일에 대해 새 경로를 선택할 수 있지만 활동을 포함하는 어셈블리에 대한 새 경로를 선택하면 작업의 세부 정보 중 일부가 다시 설정되므로 정보를 다시 입력해야 합니다. 파일에 원래 경로를 사용하면 기존 정보가 다시 입력하지 않고도 재사용됩니다.
Opalis 호환 통합 팩 변환
통합 팩 마법사 시작
통합 팩 가져오기를 선택합니다.
기존 OIP 파일을 선택하고 열기를 선택합니다.
IP가 Orchestrator와 호환되지 않음을 나타내는 경고 메시지가 표시됩니다. 확인을 선택합니다.
필요에 따라 제품 세부 정보를 수정하여 변경 내용을 반영합니다. IP의 버전 번호가 자동으로 증가하고 "업그레이드" 확인란이 선택되어 있습니다. 다음을 선택합니다.
활동 페이지에서 각 활동을 살펴보고 정보가 올바르게 완료되었는지 확인합니다. 작업에 대한 어셈블리가 마이그레이션되지 않았거나 IP를 만들 때와 동일한 위치에 있지 않으면 클래스 필드가 비어 있습니다. 정보를 다시 입력할 필요가 없도록 하려면 마법사를 시작하기 전에 어셈블리를 바꿔야 합니다.
작업 편집을 마쳤으면 다음을 선택합니다.
종속 파일이 표시된 것과 동일한 위치에 있는지 확인하거나 해당 파일을 제거하고 새 종속 파일을 추가합니다. 다음을 선택합니다.
새 IP 파일의 경로와 파일 이름을 입력합니다. 이전 IP의 복사본을 유지할 수 있도록 이전 IP와 동일한 이름을 사용하지 마세요. 다음을 선택하여 IP를 빌드합니다.
이제 Orchestrator와 호환되며 Orchestrator 배포 관리자를 사용하여 등록 및 배포할 수 있는 IP가 있습니다.
통합 팩 – 알려진 문제
파일 이름 길이 제한
통합 팩에 어셈블리를 포함하면 설치 관리자가 자동으로 레지스트리에 추가됩니다. 레지스트리 키 이름 길이 제한으로 인해 어셈블리의 결합된 경로와 파일 이름은 234자를 초과할 수 없습니다. IP 내의 어셈블리가 배치되는 기본 경로를 감안할 때 포함된 어셈블리 파일의 최대 파일 이름 길이는 80자를 초과할 수 없습니다. 파일 이름이 80자를 초과하는 어셈블리가 설치에 포함되면 설치에 실패합니다.
오케스트레이터 리소스
System Center Orchestrator에 제공된 이 온라인 참조 외에도 Integration Toolkit 및 모범 사례를 사용하여 Runbook 빌드에 대한 추가 정보를 제공할 수 있는 많은 리소스가 있습니다.