K2 workflows running into error when moving K2 to a new server

  • 16 February 2021
  • 0 replies

Userlevel 4
Badge +17

K2 Workflows and Process Instances running into error when moving K2 to a new server


K2 Five
K2 blackpearl
K2 Five (all)
Management Console
This article was created in response to a support issue logged with K2. The content may include typographical errors and may be revised at any time without notice. This article is not considered official documentation for K2 software and is provided "as is" with no warranties.


When moving K2 to a new server with a different hostname, previously running workflows will show a message that they cannot find the hostname of the previous server.

Usually this will occur after upgrading to K2 Five. Since the minimum requirements for infrastructure has changed for K2 Five, you would usually upgrade your infrastructure at the same time as upgrading your K2 version. Usually that entails installing K2 on a server with a different hostname, which will lead to workflows that were in Running or Active state to run into an Error state.


Process Instances in K2 Workspace / K2 Management will end up with an error that looks like this:

"1 Unable to connect to HOSTNAME on port 5252. A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond."


The most important thing is to check and confirm that your Environment Library and String Tables entries are all pointing to the correct locations. For example, the Connection String building up the "Workflow Server" entry should point to the correct K2 server farm name. Restart the K2 server service after making any changes.

After you are certain that all instances of a workflow are using the correct variables, but your workflow is still referring to an old/previous K2 server farm name, then you can proceed to modify the HOSTS file.

Please open Notepad as Administrator, then browse to the following location and open this file:


Add this entry at the bottom of the file: OLDFARMNAME

Please replace "OLDFARMNAME" with the farm name of the previous K2 Server (preferably in FQDN format) and save the file, then restart the K2 Service.

Please use the "Retry" button on workflow instances in error state.

0 replies

Be the first to reply!