SharePoint Server용 워크플로 설치 및 구성

적용 대상:2013 2016 2019 Subscription Edition SharePoint in Microsoft 365

이 문서에는 SharePoint Server에 대한 SPWFM(SharePoint 워크플로 관리자)을 구성하는 데 필요한 정보 및 절차가 포함되어 있습니다.

참고

SharePoint 2013 워크플로 플랫폼에 전원을 공급하는 별도의 워크플로 엔진 제품은 Microsoft 워크플로 관리자("클래식 WFM") 및 SPWFM(SharePoint 워크플로 관리자)입니다. Microsoft 워크플로 관리자 더 이상 설치할 수 없는 반면 SharePoint 워크플로 관리자 이를 대체하기 위해 릴리스되었습니다. 따라서 이 문서에 설명된 지침에서는 SharePoint 워크플로 관리자 설치하는 방법을 설명합니다.

개요

SharePoint Server에 대한 워크플로를 빌드할 때 새 옵션이 있습니다. 이 옵션을 플랫폼 유형이라고 합니다. 이 그림은 SharePoint Designer 2013을 사용하여 새 워크플로를 만들 때 플랫폼 유형 옵션을 보여 줍니다.

그림: SharePoint Server에는 세 가지 워크플로 플랫폼 옵션이 포함되어 있습니다.

SharePoint Server를 처음 설치할 때 사용할 수 있는 유일한 플랫폼은 SharePoint 2010 워크플로 플랫폼입니다. SharePoint 2013 워크플로 플랫폼 및 Project Server 플랫폼에는 더 많은 단계가 필요합니다. 다음 표에는 세 가지 워크플로 플랫폼에 대한 간략한 설명이 나와 있습니다.

SharePoint Server에서 사용할 수 있는 워크플로 플랫폼 형식

플랫폼 유형	플랫폼 프레임워크	요구 사항
SharePoint 2010 워크플로	Windows Workflow Foundation 3	SharePoint Server를 사용하여 자동으로 설치됩니다.
SharePoint 2013 워크플로	Windows Workflow Foundation 4	SharePoint 워크플로 관리자 또는 Microsoft 워크플로 관리자 및 SharePoint Server가 필요합니다.
SharePoint 2013 워크플로 - Project Server	Windows Workflow Foundation 4	SharePoint 워크플로 관리자 또는 Microsoft 워크플로 관리자 및 Project 서버가 필요합니다.

참고

SharePoint 워크플로 관리자 SharePoint Server와 별도로 다운로드하여 설치해야 합니다. SharePoint Server를 설치할 때 자동으로 설치되지 않습니다.

SharePoint 워크플로 관리자 새로 설치

SharePoint 워크플로 관리자 SharePoint와 동일한 서버 또는 별도의 전용 서버에 설치할 수 있습니다. 성능 및 안정성상의 이유로 SharePoint 워크플로 관리자 전용 서버에 설치하는 것이 좋습니다.

참고

SharePoint 워크플로 관리자 호스트 수가 홀수인 팜(예: 1, 3 또는 5)에서 지원됩니다. SharePoint 워크플로 관리자 호스트가 2개 또는 4개인 팜은 지원되지 않습니다.

필수 구성 요소

SharePoint 워크플로 관리자 IIS(웹 서버)의 서버 역할이 필요합니다. IIS 서버 역할이 설치되지 않은 서버에 SharePoint 워크플로 관리자 설치하는 경우 파일 또는 어셈블리 'Microsoft.Web.Administration'을 로드할 수 없음과 같은 메시지와 함께 워크플로 관리자 구성 마법사가 실패합니다. 기본적으로 웹 서버 역할과 함께 설치되는 기능 외에도 SharePoint 워크플로 관리자 다음 웹 서버 기능이 필요합니다.

• Windows 인증(보안 아래)
• .NET 확장성 4.7(애플리케이션 개발 아래)
• ASP.NET 4.7(애플리케이션 개발 아래)

참고

SharePoint 워크플로 관리자 네트워크 환경에서 사용할 수 있는 RODC(읽기 전용 도메인 컨트롤러)만 사용하여 올바르게 설치 및 구성되지 않을 수 있습니다. RWDC(읽기/쓰기 도메인 컨트롤러)가 필요합니다. SharePoint 워크플로 관리자 SharePoint 워크플로 관리자 설치를 실행하기 전에 설치해야 하는 Azure Service Fabric이 필요합니다. Azure Service Fabric 런타임이 아직 설치되지 않은 경우 아래 단계에 따라 설치합니다.

1. SharePoint 워크플로 관리자 지원되는 Azure Service Fabric 런타임의 최소 버전은 9.1.1583.9590이며 Azure Service Fabric 런타임에서 다운로드할 수 있습니다. 또는 여기에서 더 높은 버전의 Windows Installer를 찾아 다운로드할 수 있습니다.

2. 관리자 권한 관리자 권한으로 PowerShell 콘솔을 열고 다음 명령을 실행합니다.

   .\MicrosoftServiceFabric.9.1.1583.9590.exe /accepteula

3. Azure Service Fabric이 설치되어 있는지 확인하려면 제어판 프로그램 및 기능에서 찾을 수 있어야 합니다.

참고

SharePoint 워크플로 관리자 Azure Service Fabric 및 상위 버전의 버전 9.1 CU2(9.1.1583.9590)를 지원합니다.

컴퓨터에 Windows Fabric 이미 설치된 경우 Azure Service Fabric을 설치하기 전에 제거해야 합니다.

Azure Service Fabric은 많은 수의 로그를 생성하여 디스크 공간을 줄일 수 있다고 보고되었습니다. 이 문제는 SharePoint 워크플로 관리자 워크로드에 관계없이 발생할 수 있습니다. 디렉터리에서 생성된 파일을 확인하여 이 문제를 식별할 %ProgramData%\Microsoft Service Fabric\Log\Traces 수 있습니다. Azure Service Fabric 런타임만 설치되어 클러스터 구성을 통해 로그 크기를 제어할 수 없습니다. 만료된 로그를 수동으로 삭제하거나, 예를 들어 Windows 작업 스케줄러를 통해 주기적인 작업을 만들어야 할 수 있습니다.

SharePoint 워크플로 관리자 설치

SharePoint 워크플로 관리자 및 SharePoint 워크플로 관리자 클라이언트는 여기에서 다운로드할 수 있습니다. 시스템 요구 사항도 해당 페이지에서 찾을 수 있습니다.

워크플로 관리자 팜의 모든 서버에 SharePoint 워크플로 관리자 및 SharePoint 워크플로 관리자 클라이언트를 모두 설치합니다.

SharePoint Server 팜의 모든 서버에 SharePoint 워크플로 관리자 클라이언트만 설치합니다.

참고

SharePoint Server를 실행하는 서버에 SharePoint 워크플로 관리자 설치하는 것이 지원되지만 성능 및 안정성상의 이유로 SharePoint 워크플로 관리자 자체 전용 서버에 설치하는 것이 좋습니다.

SharePoint 워크플로 관리자 팜 구성

SharePoint 워크플로 관리자 팜을 만들고 서버를 팜에 조인하려면 워크플로 관리자 구성 마법사를 통해 SharePoint 워크플로 관리자 구성할 수 있습니다.

SharePoint 워크플로 관리자 서버에 로그온하고 요구 사항에 따라 "워크플로 관리자 구성"을 클릭하고 "기본 설정으로 워크플로 관리자 구성" 또는 "사용자 지정 설정으로 워크플로 관리자 구성"을 클릭합니다. 다른 포트, 사용자 지정 인증서 또는 사용자 지정 데이터베이스 이름을 사용하려는 경우 "사용자 지정 설정으로 워크플로 관리자 구성" 옵션을 사용하려고 합니다.

이 예제에서는 기본 설정 옵션을 사용합니다.

참고

기본적으로 워크플로 관리 사이트에 대해 HTTPS(TLS/SSL) 포트 12290만 구성됩니다. 암호화되지 않은 HTTP 포트 12291을 통한 통신도 허용하려면 "이 컴퓨터에서 HTTP를 통한 워크플로 관리 허용" 검사 상자를 선택해야 합니다. 이는 나중에 Register-SPWorkflowService cmdlet을 실행할 때 중요한 요소입니다. 워크플로 마법사에서 필요한 SQL Server 및 서비스 계정 세부 정보를 제공합니다.

구성 마법사는 커밋되기 전에 선택 사항에 대한 요약을 제공합니다.

참고

"기본 설정으로 워크플로 관리자 구성" 옵션을 사용할 때 일부 값이 선택됩니다. 환경에 맞지 않는 경우 마법사를 다시 시작하고 "사용자 지정 설정으로 워크플로 관리자 구성"을 선택해야 할 수 있습니다.

구성 마법사가 성공적으로 완료되어야 합니다. 실패하는 경우 마법사를 다시 실행하기 전에 "로그 보기" 링크를 선택하고 문제를 찾아 수정하세요.

다중 서버 SharePoint 워크플로 관리자 팜을 만드는 경우 다른 노드에서 워크플로 구성 마법사를 실행하고 "기존 워크플로 관리자 팜 가입" 옵션을 선택해야 합니다.

SharePoint 팜에서 앱 관리 및 구독 설정 서비스 구성

SharePoint 2013 플랫폼 워크플로가 작동하려면 SharePoint 팜에서 앱 관리 및 구독 설정 서비스가 필요합니다. SharePoint 팜에 아직 설정되지 않은 경우 SharePoint 서버에서 앱 관리 및 구독 설정 서비스, 서비스 애플리케이션 및 서비스 애플리케이션 프록시를 설정합니다.

중앙 관리를 사용하여 앱 관리 서비스를 만들 수 있습니다.

PowerShell을 사용하여 구독 설정 서비스 애플리케이션을 만들 수 있습니다.

$sa = New-SPSubscriptionSettingsServiceApplication -ApplicationPool 'SharePoint Web Services Default' -Name 'Subscriptions Settings Service Application' -DatabaseName 'Subscription'

New-SPSubscriptionSettingsServiceApplicationProxy -ServiceApplication $sa

SharePoint Server 팜에서 작동하도록 SharePoint 워크플로 관리자 구성

SharePoint Server에서 작동하도록 SharePoint 워크플로 관리자 구성하기 전에 다음 주요 요소를 고려합니다.

• SharePoint 워크플로 관리자 및 SharePoint Server 간의 통신에서 HTTP 또는 HTTPS를 사용합니까?

참고

보안상의 이유로 프로덕션 환경에서는 HTTPS를 사용하는 것이 좋습니다.

HTTP를 사용하여 통신이 이루어지는 환경에서 SharePoint 워크플로 관리자 구성하려면

참고

기본적으로 워크플로 관리 사이트에 대해 HTTPS(TLS/SSL) 포트 12290만 구성됩니다. HTTP 사용을 구성하려면 이전 단계에서 "워크플로 관리자 구성" 마법사를 실행할 때 "이 컴퓨터에서 HTTP를 통한 워크플로 관리 허용" 검사 상자가 선택되어 있어야 합니다.

1. SharePoint Server 팜의 각 서버에 로그인합니다.

2. SharePoint 팜의 각 서버에 SharePoint 워크플로 관리자 클라이언트를 설치합니다.

   중요

   Register-SPWorkflowService cmdlet을 실행하기 전에 SharePoint 팜의 각 서버에 SharePoint 워크플로 관리자 클라이언트를 설치해야 합니다.

3. 한 SharePoint 서버에서 SharePoint 관리 셸 명령을 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행을 선택하여 SharePoint 관리 셸 을 관리자 권한으로 엽니다.

4. Register-SPWorkflowService cmdlet을 실행하여 SharePoint 팜을 SharePoint 워크플로 관리자 팜과 연결합니다. 이 cmdlet은 한 번만 실행해야 하며 SharePoint 팜의 아무 서버에서나 실행할 수 있습니다.

   참고

   -SPSite 매개 변수의 값은 SharePoint 팜 내에서 유효한 사이트 모음일 수 있습니다. SharePoint 워크플로 관리자 서버에서 PowerShell Get-WFFarm | select endpoints 을 실행하여 -WorkflowHostUri 매개 변수에 대한 올바른 값을 찾을 수 있습니다.

   예제:

   Register-SPWorkflowService -SPSite "http://myserver/mysitecollection" -WorkflowHostUri "http://workflow.example.com:12291" -AllowOAuthHttp
   

HTTPS를 사용하여 통신이 이루어지는 환경에서 SharePoint 워크플로 관리자 구성하려면

1. SharePoint 서버에 SharePoint 워크플로 관리자 인증서를 설치해야 하는지 여부를 결정합니다.

   경우에 따라 SharePoint 워크플로 관리자 인증서를 가져오고 설치해야 합니다. 이러한 인증서를 구해서 설치해야 하는 경우 계속하기 전에 해당 단계를 완료해야 합니다. 인증서 설치가 필요한지 여부를 확인하고 관련 지침을 보려면 SharePoint Server 2013에서 워크플로 관리자 인증서 설치를 참조하세요.

2. SharePoint Server 팜의 각 서버에 로그인합니다.

3. SharePoint 팜의 각 서버에 SharePoint 워크플로 관리자 클라이언트를 설치합니다.

   중요

   Register-SPWorkflowService cmdlet을 실행하기 전에 SharePoint 팜의 각 서버에 SharePoint 워크플로 관리자 클라이언트를 설치해야 합니다.

4. SharePoint 관리 셸을 관리자 권한으로 엽니다. 이 작업은 SharePoint 관리 셸 명령을 마우스 오른쪽 단추 로 클릭하고 관리자 권한으로 실행을 선택하여 수행됩니다.

5. Register-SPWorkflowService cmdlet을 실행하여 SharePoint 팜을 SharePoint 워크플로 관리자 팜과 연결합니다. 이 cmdlet은 한 번만 실행해야 하며 SharePoint 팜의 아무 서버에서나 실행할 수 있습니다.

   참고

   -SPSite 매개 변수의 값은 SharePoint 팜 내에서 유효한 사이트 모음일 수 있습니다. SharePoint 워크플로 관리자 서버에서 PowerShell Get-WFFarm | select endpoints 을 실행하여 -WorkflowHostUri 매개 변수에 대한 올바른 값을 찾을 수 있습니다.

   예제:

   Register-SPWorkflowService -SPSite "https://myserver/mysitecollection" -WorkflowHostUri "https://workflow.example.com:12290"
   

기존 Microsoft 워크플로 관리자 업그레이드

Microsoft 워크플로 관리자 현재 위치에서 업그레이드할 수 없으며 SharePoint 워크플로 관리자 Microsoft 워크플로 관리자 위에 배치할 수 없습니다. Microsoft 워크플로 관리자(클래식 WFM)을 SPWFM(SharePoint 워크플로 관리자)으로 업데이트하려면 이전 버전의 워크플로 관리자, 워크플로 관리자 클라이언트 및 Service Bus를 제거해야 합니다.

참고

모든 버전의 Microsoft 워크플로 관리자 SharePoint 워크플로 관리자 업그레이드할 수 있습니다. 기존 "클래식 WFM" 팜을 SPWFM으로 업그레이드하기 때문에 WFM 데이터베이스가 다시 사용되며 기존 등록 및 워크플로는 그대로 유지되어야 합니다.

아래 단계에 따라 Microsoft 워크플로 관리자 제거하고 SharePoint 워크플로 관리자 설치합니다.

중요

업그레이드 단계를 수행하려면 기존 WFM 팜에 조인한 다음 다시 참가해야 하므로 다시 연결할 때 "인증서 생성 키"WFM 필요합니다. 해당 키가 무엇인지 잘 모르고 어딘가에 문서화하지 않은 경우 계속하기 전에 인증서 생성 키를 다시 설정 해야 할 수 있습니다. 유효한 인증서 생성 키가 없으면 기존 워크플로 팜에 조인할 수 없습니다.

1. 워크플로 관리자 구성 마법사를 실행합니다.

2. 팜 워크플로 관리자 나가기 를 선택합니다.

3. 마법사가 끝날 때까지 후속 단계를 확인합니다.

4. 워크플로 팜의 모든 Microsoft 워크플로 관리자 서버에서 이 단계를 반복합니다.

   참고

   워크플로 관리자 및 Service Bus에서 사용하는 각 데이터베이스는 SharePoint 워크플로 관리자 팜에 다시 연결할 때 지정해야 합니다. 예를 들어 워크플로 관리자 팜 관리 데이터베이스 및 Service Bus 팜 관리 데이터베이스의 SQL Server instance 및 데이터베이스 이름입니다.

5. Microsoft 워크플로 관리자, 워크플로 관리자 Client, Windows Server용 Service Bus 및 설치되어 있는 경우 Windows Fabric 제거합니다. 제어판 제거할 수 있습니다. Windows Fabric 설치된 경우 Windows Fabric 제거한 후 Azure Service Fabric을 설치해야 합니다.

   중요

   SharePoint 서버에 SharePoint 워크플로 관리자 설치하는 경우 "Windows Fabric" 및 "Windows Server용 AppFabric 1.1"이 모두 설치되어 있을 수 있습니다. Windows Fabric 제거해야 합니다. AppFabric 1.1을 제거하지 마세요. 이는 다른 서비스이며 SharePoint 분산 캐시에 필요합니다.

6. "%ProgramFiles%\워크플로 관리자\1.0" 또는 "%Program Files%\Service Bus\1.0" 폴더가 이미 있는 경우 다음 단계가 성공하려면 수동으로 제거해야 합니다.

7. SharePoint 워크플로 관리자 서버를 다시 부팅합니다.

8. 아직 설치되지 않은 경우 위의 필수 구성 요소 섹션 의 단계를 사용하여 Azure Service Fabric을 설치합니다.

9. SharePoint 워크플로 관리자 및 SharePoint 워크플로 관리자 클라이언트를 설치합니다. SharePoint 워크플로 관리자 및 SharePoint 워크플로 관리자 클라이언트는 여기에서 다운로드할 수 있습니다. 시스템 요구 사항도 해당 페이지에서 찾을 수 있습니다.

10. 워크플로 관리자 구성 마법사를 실행하고 "기존 워크플로 관리자 팜 가입"을 선택하여 이전 팜에 다시 연결합니다. 이전 "클래식 WFM" 팜에서 사용된 데이터베이스, 서비스 계정 및 인증서 생성 키 정보를 사용합니다.

    참고

    업그레이드할 때는 일반적으로 기존 워크플로 서비스 애플리케이션 프록시 삭제하고 Register-SPWorkflowService cmdlet을 사용하여 다시 연결할 필요가 없습니다. SharePoint 워크플로 관리자 및 Service Bus용 인증서 생성 키가 잘못되면 다시 설정해야 할 수 있습니다. 인증서 생성 키 다시 설정을 참조하세요.

11. 워크플로 관리자 구성 마법사를 다시 실행하고 업그레이드 워크플로 관리자 팜을 선택한 후 끝까지 후속 단계를 확인합니다.

    참고

    이 단계는 SharePoint 워크플로 관리자 팜의 모든 서버에서 실행되어야 합니다. 업그레이드가 필요한지 여부에 관계없이 "워크플로 관리자 팜 업그레이드" 옵션은 항상 워크플로 관리자 구성 마법사에 표시됩니다. 여러 번 실행하거나 보류 중인 업그레이드가 없는 경우 아무런 해가 없습니다.

12. 워크플로 관리자 팜에 둘 이상의 서버가 있는 경우 모든 워크플로 팜 서버에서 이전 단계를 반복합니다.

13. 이전 버전을 제거한 후 SharePoint Server 팜의 각 서버에 SharePoint 워크플로 관리자 클라이언트를 설치합니다.

설치가 제대로 되었는지 확인

다음 단계에 따라 필요한 구성 요소를 성공적으로 설치하고 구성했는지 확인합니다.

설치가 제대로 되었는지 확인하려면

1. SharePoint 사이트에 사용자를 추가하고 사용자에게 사이트 Designer 권한을 부여합니다.
2. 클라이언트 컴퓨터에 SharePoint Designer 2013을 설치하고 SharePoint 2013 워크플로 플랫폼을 기반으로 워크플로를 만듭니다. 자세한 내용은 SharePoint Designer 2013 및 SharePoint 2013 워크플로 플랫폼을 사용하여 워크플로 만들기를 참조하세요.
3. SharePoint 사용자 인터페이스에서 이 워크플로를 실행합니다.

문제 해결

보안상의 이유로 설정 계정을 사용하여 SharePoint 2013 워크플로 플랫폼을 기반으로 워크플로를 만들 수 없습니다. SharePoint Designer 2013을 사용하여 SharePoint 2013 워크플로 플랫폼을 기반으로 워크플로를 만들려고 하면 워크플로 작업 목록이 없고 워크플로가 만들어지지 않는다는 경고가 표시됩니다.

워크플로를 배포하고 실행할 사용자를 User Profile Service에 추가해야 합니다. 중앙 관리의 사용자 프로필 서비스 애플리케이션 페이지를 확인하여 워크플로 설치의 유효성을 검사하는 데 사용하는 사용자가 사용자 프로필 서비스에 있는지 확인합니다.

그림과 같이 IIS 관리자를 사용하여 HTTP 및 HTTPS에 사용 중인 SharePoint Server 및 워크플로 관리자 포트를 확인할 수 있습니다.

그림: IIS 관리자를 사용하여 SharePoint 워크플로 관리자 사용하는 포트 보기

SharePoint 워크플로 관리자 TCP/IP 또는 명명된 파이프를 사용하여 통신합니다. SharePoint 워크플로 관리자 데이터베이스를 호스트하는 SQL Server instance 적절한 통신 프로토콜이 사용하도록 설정되어 있는지 확인합니다.

워크플로 관리자 데이터베이스를 호스트하는 SQL Server 인스턴스에서 SQL Browser 서비스가 실행되고 있어야 합니다.

시스템 계정을 사용하여 워크플로를 개발할 수 없습니다.

SharePoint Server 문제를 해결하려면 SharePoint Server 문제 해결을 참조하세요.