Skip To Content

Common problems and solutions

Solutions to common questions and problems for ArcGIS Workflow Manager are described below. For additional help, articles are also available on the Esri Support Center site.

Install

Upgrade

Administer

ArcGIS Pro

Workflow items

Extended properties tables

Step scheduling

Install

Why do I receive an error about ArcGIS Server being a required installation when I try to install ArcGIS Workflow Manager Server?

Workflow Manager Server is installed as a server role in addition to a base deployment of ArcGIS Server. Ensure that the equivalent version of ArcGIS Server is installed before installing Workflow Manager Server.

Why are the action buttons missing in the workflow item I created after installing Workflow Manager?

The reverse proxy configured for ArcGIS Server where Workflow Manager is installed but not configured to support websocket messages. You can find more information using developer tools in the browser and refreshing the page.

Upgrade

Do I need to uninstall earlier versions of Workflow Manager Server?

No. If you already have Workflow Manager Server installed, the Workflow Manager setup automatically upgrades it. The Workflow Manager setup package detects and upgrades an existing installation of Workflow Manager Server.

Do I need to back up anything before upgrading Workflow Manager Server?

Yes. You should create an ArcGIS Enterprise backup before upgrading Workflow Manager Server.

If I upgrade ArcGIS Server, do I need to upgrade Workflow Manager Server?

Yes. The version of Workflow Manager Server must match the version of ArcGIS Server.

How do I move from a single-machine deployment to a highly available deployment during an upgrade?

Upgrade your single-machine Workflow Manager Server deployment version to 11.5. Then, set up additional Workflow Manager Server machines and configure them for high availability.

Why am I getting an error message about my Workflow Manager user type extension after upgrading to Workflow Manager Server 11.5?

The license requirement for the Workflow Manager user type extension was removed at 11.2. This behavior occurs if members were assigned a Workflow Manager user type extension before upgrading. Unassign the user type extension to stop receiving the error message.

Do I need to upgrade my workflow items after upgrading Workflow Manager Server?

Workflow item upgrades became optional at 11.1. While you are not required to upgrade your workflow items, upgrading is recommended to avoid problems in the web app.

Administer

Why do I receive a 405 HTTP verb used to access this page is not allowed error message when trying to delete items or perform specific tasks in Workflow Manager?

This is most likely caused by the web server in front of Workflow Manager blocking HTTP verbs, such as PUT and DELETE. If you are using IIS as your web server, ensure PUT and DELETE requests are allowed. They may be blocked by WebDAV, a common IIS module.

Why do I receive an Unable to connect to Workflow Manager Server notification even though I'm able to reconnect?

The load balancer or web server configured with Workflow Manager may have a default timeout setting. If these are set too low, long-running processes may experience interruptions. Adjust or increase timeout values as necessary.

Why do I receive a Failed to save step assignments. Job was not updated. error message when I try to update job details while the specified step is running?

Job details cannot be updated while a step is running. Pause or finish the step before updating the job's properties. Alternatively, you can use the updateJob endpoint to update job properties while the step is running at 11.3 and later.

Where can I find Workflow Manager logs?

Workflow Manager Server events and errors are recorded in the Server Manager logs. Logs associated with the web app can be accessed on the Log Messages tab.

Why do I receive a Fatal: remaining connection slots are reserved for non-replication superuser connections error message in the logs when automated processes in Workflow Manager fail?

ArcGIS Data Store accepts up to 150 connections for all Enterprise connections by default. The number of remaining connections may not be enough for automated tasks in Workflow Manager to function properly. Review the Data Store max connections setting and update as needed.

ArcGIS Pro

Why do I receive a licensing error when attempting to connect to Workflow Manager from ArcGIS Pro if I've installed, configured, and licensed Workflow Manager for Enterprise?

A separate, optional license is required to access Workflow Manager from ArcGIS Pro.

Learn more about licensing Workflow Manager

Workflow items

Why do I receive a No subject alternative DNS name matching <hostname> found error message when trying to create a workflow item?

Workflow Manager Server inherits the URLs for communication from Portal for ArcGIS and ArcGIS Server. If one of the administrative URLs accessed presents a certificate that does not have a matching SAN value, an error is logged. To resolve this, verify that the ArcGIS Server and Enterprise portal are using certificates with SAN values that match the administrative URLs stored in Enterprise.

Why am I not able to create a workflow item or a hosted feature layer by uploading a shapefile, a file geodatabase, or CSV outside of Workflow Manager?

If IPv6 is disabled, it can affect all publishing processes across Enterprise, including workflow item creation. Check if IPv6 is disabled for Enterprise and complete the steps in Problem: Unable to publish hosted feature layers to the ArcGIS Enterprise portal to enable IPv6.

Extended properties tables

Why am I not able to create an extended properties table or why is one that I created now missing?

The extended properties table or field names may contain reserved keywords. The list of reserved keywords may vary depending on your Enterprise version. Contact Esri Support Services to help identify reserved keywords in your tables.

Step scheduling

Why are steps that are scheduled to start automatically not starting at the designated time?

When using the Wait a period of time option for step scheduling, the step wait and offset settings determine the range of time allowed for the step to start. For example, setting the Minutes option to 1 minute and the Offset +/- Minutes option to 1 minute will stagger steps to start within a total range of 2 minutes to prevent multiple jobs from running a scheduled step at the same time if multiple jobs were made.

Why am I not able to schedule tasks in Workflow Manager or receive an Unexpected exception when retrieving token. Rejecting connection java.net.Connect.Exception: No trust manager was able to validate this certificate chain: # of exceptions = 4. error message in the logs?

Enterprise portal tasks handle scheduling and must be able to call back to Workflow Manager as a client. Portal tasks require a valid trust chain for Workflow Manager. You must import all root and intermediate certificates presented by Workflow Manager to the trusted store for Portal for ArcGIS.

Learn more about best practices for server certificates

Related topics