1. Presented by ProActive Technology SharePoint 2013 Workflow Configuration Instructor: Kim Ryan

2. Resources

3. General Overview SP2010 Workflow Engine still available in SP2013 Installs automatically SP2010 Workflow Engine still available in SP2013 Installs automatically

4. General Overview

5. TCP or Named Pipes

6. General Overview SharePoint Server 2013 Workflow Platform

7. General Overview Options in SP Designer 2013

8. Advantages

10. General Overview IIS.NET 4 PU3 or.NET 4.5 Service Bus 1.0 Workflow Client 1.0 Windows PowerShell 3.0 Workflow Managers hardware requirement = 2 cores, 2Gb RAM

11. Prerequisites SQL Server Accounts Certificates High Availability Firewall Important Note: SharePoint 2013 Workflow platform is not supported in SharePoint Foundation 2013.

12. Prerequisites

16. NOTE ABOUT ADMIN GROUP: Group that contains the principals whom will administer the Workflow Manager farm By default this will be the built in Administrators group on each server in the farm. If you wish to have more control across a three server farm, this should be (not must be) a Domain Group and contain the user accounts needed. Under no circumstances whatsoever is it necessary to add SharePoint Service Accounts into this group.

17. Helpful to note if troubleshoot is needed later:.NET Framework 4 Platform Update 3 or.NET Framework 4.5 Service Bus 1.0 Workflow Client 1.0 PowerShell 3.0 Instance of SQL Server 2008 R2 SP1, SQL Server Express 2008 R2 SP1, or SQL Server 2012. TCP/IP connections or named pipes must be configured in SQL Server Windows Firewall must be enabled Ports 12290 and 12291 must be available. Prerequisites

18. Central Certificate Requirements If you select an existing certificate, make sure the certificate: Has a subject name, subject alternative name, and both a private and public key Is installed in the personal store of all computers in the farm or any computer that intends to join the farm Is Valid in with respect to the start date, end date, trust chain Has AT_KeyExchange set Can be used as a server certificate Corresponding CRL list for signing authority is present Prerequisites

19. High Availability Workflow Manager farm supports a farm of a single computer running both Workflow Manager farm and the required Service Bus farm. If you require high availability you must expand the farm to three (3) computers. Two node farms cannot guarantee high availability. Prerequisites

20. Installation 1. Download Web Platform Installer http://www.microsoft.com/web /downloads/platform.aspx http://www.microsoft.com/web /downloads/platform.aspx

21. Installation 1. Download Web Platform Installer http://www.microsoft.com/web /downloads/platform.aspx http://www.microsoft.com/web /downloads/platform.aspx

22. Installation 2. In Web Platform Installer, search for Workflow and install the Workflow Manager

23. Installation Note: May want to install dependencies separately

24. Installation Example: Windows Fabric

25. Installation Run the wizard, and then return to WPI…

26. Installation Install Workflow Manager, but do not configure

27. Installation Workflow Manager installation completes…

28. Installation 3. Install Workflow Manager updates Go to Microsoft Download Center and check for Workflow Manager updates: http://www.microsoft.com/en-us/download/default.aspx NOTE – You can find cumulative updates in the WPI as well

29. Installation Search for workflow. Sort results by most recent.

30. Installation 4. Install Workflow Client

31. Installation 5. Verify the install

32. Installation Verify the install…

33. Installation Verify the install…

34. Installation Command Line Option…. SAMPLES: webpicmdline.exe /? Displays help webpicmdline.exe /List:[Installed|All|Available] /XML:http://sample.com/ samplefeed.xml webpicmdline.exe /Products:ASP webpicmdline.exe /Products:ASP, SQLExpress webpicmdline.exe /Products:All /Feeds:http://feedstore.com/feed1.xml, ht tp://feedstore.com/feed2.xml - install all products from the specified feeds webpicmdline.exe /Products:All /Language:FR - install all products avail able in French webpicmdline.exe /Products:MyCustomProduct /Feeds:http://feedstore/MyCus tomFeed.xml /Language:RU - install a product from a custom feed, Russian install er webpicmdline.exe /Products: /Log: /XML: webpicmdline.exe /Applications:Dasblog webpicmdline.exe /Applications:Dasblog@Dasblog0.app> webpicmdline.exe /Applications:Dasblog@Dasblog0.app /Products:ASP /XML:C :\webpi\webproductlist.xml /Log:DasblogScrewTurnLog.txt

35. Installation Command Line Option….

36. Configuration 6. Run Workflow Manager Configuration After you have Workflow Manager installed, Workflow Manager update, and Service Bus update (Service Bus gets installed with Workflow Manager) and have verified they are all there, you are ready to run the Workflow Configuration Manager. From: http://www.harbar.net/articles/wfm2.aspxhttp://www.harbar.net/articles/wfm2.aspx

37. Configuration Note: Configuration Wizard generates PowerShell to perform and execute the install 6. Select Default Settings option

38. Configuration 8. Complete Farm Configuration Service Account (Run As user from earlier) HTTP - > Not recommended for Production Remember the key you choose for the certificate!

39. Configuration Workflow Manager summarizes what will happen… Note – You can click to open text file with PowerShell commands

40. Configuration POWERSHELL: # To be run in Workflow Manager PowerShell console that has both Workflow Manager and Service Bus installed. # Create new SB Farm $SBCertificateAutoGenerationKey = ConvertTo-SecureString -AsPlainText -Force -String '***** Replace with Service Bus Certificate Auto-generation key ******' -Verbose; New-SBFarm -SBFarmDBConnectionString 'Data Source=PASRVSQL2;Initial Catalog=SbManagementDB;Integrated Security=True;Encrypt=False' -InternalPortRangeStart 9000 -TcpPort 9354 -MessageBrokerPort 9356 - RunAsAccount 'PROACTIVE\sysSharePoint' -AdminGroup 'BUILTIN\Administrators' - GatewayDBConnectionString 'Data Source=PASRVSQL2;Initial Catalog=SbGatewayDatabase;Integrated Security=True;Encrypt=False' -CertificateAutoGenerationKey $SBCertificateAutoGenerationKey - MessageContainerDBConnectionString 'Data Source=PASRVSQL2;Initial Catalog=SBMessageContainer01;Integrated Security=True;Encrypt=False' -Verbose;

41. Configuration # To be run in Workflow Manager PowerShell console that has both Workflow Manager and Service Bus installed. # Create new WF Farm $WFCertAutoGenerationKey = ConvertTo-SecureString -AsPlainText -Force -String '***** Replace with Workflow Manager Certificate Auto-generation key ******' -Verbose; New-WFFarm -WFFarmDBConnectionString 'Data Source=PASRVSQL2;Initial Catalog=WFManagementDB;Integrated Security=True;Encrypt=False' -RunAsAccount 'PROACTIVE\sysSharePoint' -AdminGroup 'BUILTIN\Administrators' -HttpsPort 12290 -HttpPort 12291 -InstanceDBConnectionString 'Data Source=PASRVSQL2;Initial Catalog=WFInstanceManagementDB;Integrated Security=True;Encrypt=False' - ResourceDBConnectionString 'Data Source=PASRVSQL2;Initial Catalog=WFResourceManagementDB;Integrated Security=True;Encrypt=False' -CertificateAutoGenerationKey $WFCertAutoGenerationKey -Verbose; # Add SB Host $SBRunAsPassword = ConvertTo-SecureString -AsPlainText -Force -String '***** Replace with RunAs Password for Service Bus ******' -Verbose; Add-SBHost -SBFarmDBConnectionString 'Data Source=PASRVSQL2;Initial Catalog=SbManagementDB;Integrated Security=True;Encrypt=False' -RunAsPassword $SBRunAsPassword -EnableFirewallRules $true - CertificateAutoGenerationKey $SBCertificateAutoGenerationKey -Verbose;

42. Configuration Try { # Create new SB Namespace New-SBNamespace -Name 'WorkflowDefaultNamespace' -AddressingScheme 'Path' -ManageUsers 'PROACTIVE\sysSharePoint','Administrator1532@PROACTIVE' -Verbose; Start-Sleep -s 90 } Catch [system.InvalidOperationException] { } # Get SB Client Configuration $SBClientConfiguration = Get-SBClientConfiguration -Namespaces 'WorkflowDefaultNamespace' -Verbose; # Add WF Host $WFRunAsPassword = ConvertTo-SecureString -AsPlainText -Force -String '***** Replace with RunAs Password for Workflow Manager ******' -Verbose; Add-WFHost -WFFarmDBConnectionString 'Data Source=PASRVSQL2;Initial Catalog=WFManagementDB;Integrated Security=True;Encrypt=False' -RunAsPassword $WFRunAsPassword -EnableFirewallRules $true - SBClientConfiguration $SBClientConfiguration -EnableHttpPort -CertificateAutoGenerationKey $WFCertAutoGenerationKey -Verbose;

43. Configuration Workflow Manager Configuration Wizard progress….

44. Configuration Workflow Manager Configuration Wizard finishes…. Notice option to view Log

45. Configuration Example Log

46. Configuration 9. Check Workflow Manager Status with PowerShell Import-Module WorkflowManager Get-WFFarm Get-WFFarmStatus Import-Module WorkflowManager Get-WFFarm Get-WFFarmStatus Run PowerShell as Admin (always!)

47. Configuration 10. Note HTTPS Endpoint https://PASRVSP2.Pa-Tech.com:12290

48. Configuration 11. Test HTTPS Endpoint You will receive a certificate error. This is OK.

49. Configuration 12. Export the Certificate 1.Click the Certificate Error icon to the right of the Address Bar 2.Click View Certificates 3.Click the Details tab 4.Click the Copy to File… button 5.On the Welcome to the Certificate Export Wizard page, click Next 6.On the Export File Format page, click Next 7.In the File name text box enter c:\wfm.cer and click Next 8.Click Finish, followed by OK twice http://www.harbar.net/articles/wfm2.aspx

50. Configuration 13. Create a Trust

51. Configuration IMPORTANT: Watch out with this cmdlet. If the certificate file doesnt exist it will still create a trust! Watch the output for any errors. If there are some, you will need to delete the trust before running New- SPTrustedRootAuthority again after resolving the problem.

52. Configuration 14. Register Workflow Service Connection Register-SPWorkflowService -SPSite "https://intranet.pa-tech.com" -WorkflowHostUri "https://pasrvsp2.pa-tech.com:12290"https://intranet.pa-tech.comhttps://pasrvsp2.pa-tech.com:12290 Note: You CAN register the HTTP (non-Production environments) Register-SPWorkflowService -SPSite "http://pasrvsp2" - WorkflowHostUri "http://pasrvsp2.pa-tech.com:12291"http://pasrvsp2http://pasrvsp2.pa-tech.com:12291 CAUTION: Watch out with this cmdlet. If this command fails the Service Application Proxy will still be created, but it will be effectively broken. Monitor the output for any errors. If necessary, clean up the connection and re-run Register-SPWorkflowService after resolving the problem.

53. Configuration 15. Check Central Administration

54. Configuration 15. Check Central Administration

55. Configuration 16. FINAL STEP: Check SharePoint Designer 2013 If you see this, youre good to go!

56. © 2013 ProActive Technology, LLC The ProActive SharePoint Team sincerely thanks you for attending this presentation. Thank You!