No ratings

K2 Blackpearl Setup Manager freezes at database configuration step


After restoring K2 database backup, K2 Blackpearl Setup Manager freezes at database configuration step

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.
This article has been archived, and/or refers to legacy products, components or features. The content in this article is offered "as is" and will no longer be updated. Archived content is provided for reference purposes only. This content does not infer that the product, component or feature is supported, or that the product, component or feature will continue to function as described herein.


After restoring a copy of the K2 database backup, when attempting to reconfigure K2 Blackpearl, the Setup Manager freezes at configuring the K2 database, and no progress is made after a long period of time.



  1. If the restored K2 database is from another K2 environment, the Setup Manager will display a status indicating it is waiting for the K2 server on another environment.


  2. The last few entries in the InstallerTrace log show that the Setup Manger detects that the K2 database is "busy", and is waiting for server to free up the database.

    The InstallerTrace log can be found in C:\Users\[account used to run Setup Manager]\AppData\Local\Temp\K2 Setup Log


Troubleshooting Steps

  1. If the K2 Blackpearl Setup Manager is still stuck at the K2 database configuration step, please close it. If you are unable to do so, you can use the Windows Task Manager to end the 'K2 Setup Manager' process.
  2. Run the following query on your K2 database:


    SELECT *

    FROM   [HostServer].[Configuration]

    WHERE  [VariableToken] = '[SERVER_BUSY]'

  3. If the value in VariableValue is showing the K2 server's hostname from another environment, run the following query to remove it:

    Before making any changes to the K2 database, please make sure to create a backup of your K2 database if you have not done so.

    UPDATE [HostServer].[Configuration]

    SET    [VariableValue] = ''

    WHERE  [VariableToken] = '[SERVER_BUSY]'


  4. After that, run the Setup Manager again. This should resolve the issue.
Labels: (2)
Version history
Last update:
‎03-15-2022 04:53 AM
Updated by: