In this post, we will solve “Register-SPworkflowservice unable to connect to the remote service at Workflow Manager” in SharePoint 2016 and 2013.
You might also like to learn how to SharePoint 2016: Configure Workflow Manager.
Register-SPworkflowservice unable to connect to the remote service at
-
1
Register-SPworkflowservice unable to connect to the remote service at
- 1.1 Why you got unable to connect to the remote service workflow manager?
- 1.2 How to solve Unable to connect to the remote service workflow manager issue?
- 1.3 Check SharePoint Workflow Manager Ports Status
I have installed the SharePoint Workflow Manager by following the mentioned steps at Install and Configure Workflow Manager In SharePoint 2013 that had been installed properly,
But when I tried to configure the SharePoint host to use a workflow service by running Register-SPWorkflowService cmdlet, I got the below error!
Register-SPworkflowservice unable to connect to the remote service at Workflow Manager
You might also like to read Failed to query the OAuth S2S metadata endpoint at URI.
Why you got unable to connect to the remote service workflow manager?
The “Register-SPworkflowservice : unable to connect to the remote service” Issue usually occurs because of using an incorrect URL and Port (12990) at”WorkflowHostUri” parameter in Register-SPWorkflowService cmdlet.
- This Port must be opened on all Workflow Manager Servers.
- This port should be the same port that has been provided during configuring the Workflow Manager port as shown below.
Note: By default, The port (12290) is for HTTPs and (12291) for HTTP.
By the way, the mentioned port in Microsoft TechNet example was not correct, as you can see, the documentation used the “12990”, not the default port “12290” as shown below.
You might also like to read Workflow Manager: Port is blocked.
How to solve Unable to connect to the remote service workflow manager issue?
To solve the “unable to connect to the remote service workflow manager” issue, you should make sure that you have provided the correct URL and Port at “WorkflowHostUri” parameter in Register-SPWorkflowService. As well as, you should make sure that you are using the same port that you have set during configuring the Workflow Manager and this port should be not blocked by any other program like antivirus or firewall.
First, you should make sure that the provided port is the correct one that has been used during Configuring the Workflow Manager!
If you didn’t remember which ports you have used during configuring SharePoint Workflow Manager, try to run the below cmdlet
Get-WFFarm | select httpport,httpspor
Based on the above results, you should run “Register-SPworkflowservice” .
You should also make sure that the SharePoint Workflow Manager Ports are opened and not blocked by any other program like Antivirus, Firewall ..etc.
- Open Command prompt as administrator.
- Perform Telnet the port (telnet ServerIP Port),
telnet Server IP Port
- In case, the telnet cmdlet shows “couldn’t open a connection to the host“, that means
- The provided port is not the same as the port that you have provided during configuring SharePoint workflow manager.
- Or it’s the correct port but it is not opened, so you should ask your network Admin to open it on all Workflow Manager Servers within the farm.
If Telnet command is not recognized, you should check ‘telnet’ is not recognized as an internal or external command, operable program or batch file to enable it.
Now, try to register the SharePoint workflow service by providing the correct Workflow Host Uri.
- Open SharePoint Management Shell as Administrator.
Register-SPWorkflowService -SPSite https://SiteCollection -WorkflowHostUri https://WorkflowURL:12290 -AllowOAuthHttp
- The workflow should be registered properly now.
SPSite: Specifies a site collection to configure.
It seems that each site collection needs to be registered with workflow service. But actually it’s not 100% correct, once you have registered a workflow service to any SharePoint site collection within the farm, it will be enabled for all SharePoint web applications/site collections. I am pretty sure about this behavior and that what I got on my farm.
WorkflowHostUri: Specifies a string of the full URI for the Workflow Service.
The provided ports must be the same provided ports in the Configure Ports step as above mentioned.
by default, it’s 12291 for HTTP and 12290 for HTTPS.
If you still can’t register the SharePoint Workflow Manager Service, so it’s strongly recommended to check
In this section, we will make sure that the SharePoint Workflow Manager Service has been registered and worked properly.
You might also like to read Workflow Manager Health Checklist.
- Open IIS > From left side expand Sites > Workflow Management Site.
- From right side > Click Browse.
- The below page should be shown and that means the workflow manager is connected and registered properly.
If the workflow manager API didn’t work , you will need to check 403 forbidden error.
- Open SharePoint Designer > Workflows > Create Site Workflow > In Platform Type the SharePoint 2013 Workflow should be listed.
- Open Central Administration > Application Management > Application Services > Click on Workflow Service Application Proxy.
- The Workflow would be Connected as shown below:
Conclusion
In conclusion, we have solved “Register-SPworkflowservice unable to connect to the remote service at Workflow Manager” in SharePoint 2016 and 2013.
Applies To
- SharePoint Workflow Manager 2016.
- SharePoint Workflow Manager 2013.
- SharePoint 2016.
- SharePoint 2013.
You might also like to read
- SharePoint 2016: Configure Workflow Manager.
- Install and Configure Workflow Manager In SharePoint 2013.
- Re-register SharePoint Workflow Manager Service.
- The Caller doesn’t have the necessary permissions required for this operation.
- Workflow Manager: HTTP 403 Forbidden.
- Service Bus Message Broker Stuck on Starting
- Workflow Manager: Get Service Bus Ports
Have a Question?
If you have any related questions, please don’t hesitate to ask it at deBUG.to Community.
Pingback: Workflow Manager: HTTP 403 Forbidden | SP Geeks
Pingback: The Caller doesn't have the necessary permissions required for this operation | SP Geeks
Hi Mohamed,
Thanks for your article, and I have a question. Is it an error in Microsoft article ?!
Hi dear,
No, it’s not an error in Microsoft article, but as I have mentioned, you should use the same port that you have provided during configuring The Workflow Manager.
However, It would prefer if the documentation mentions the default port value in their article!
Note: In some cases, you may need to use FQDN at -WorkflowHostUri