MetaServer > Help > Troubleshoot > MetaServer is locked up (red error)

MetaServer is locked up (red error), and restarting doesn’t fix it. What do I do?

With MetaServer, you can combine actions and rules in an unlimited number of ways. We try to prevent that MetaServer locks up if a workflows error occurs, but it is impossible to predict all possible mistakes one can make with a flexible product like MetaServer. If you make a mistake in your workflow definition, causing MetaServer to lock up, and restarting MetaServer does not help, you need to follow the steps below.

Standard Procedure:

First try the standard procedure to correct the mistake in your workflow.

Step 1: make sure you have entered your email address in the “Report error to” setup in your workflow(s). When an error occurs, you will receive an email with detailed instructions what went wrong.

Step 2: based on the error information you receive by email, adjust your workflow to avoid the error and then press Publish.

Step 3: a message like below will pop up and ask what to do with documents that are already imported. Select “Delete”.

If this does not unlock MetaServer, please proceed to below instructions.

Extra troubleshooting:

Step 1: if the Validation/Administration Client is not closing, open the Task Manager -> Processes -> Apps.

Step 2: search for “Validate”, right-click on it and select “End Task”

Step 3: to stop MetaServer, open the Task Manager -> Details.

Step 4: search for “MetaService.exe”, right-click on it and select “End Task”.

Next, you need to go to C:\ProgramData\CaptureBites\Programs\MetaServer\Data to remove all pending documents associated with the erring workflow definition.
NOTE: if you want to browse to it manually and don’t see your ProgramData folder in your C drive, press the View tab in your Explorer window and enable the “Hidden items” option.

In C:\ProgramData\CaptureBites\Programs\MetaServer\Data, do the following:

Step 5: remove the “Documents” folder and, if present, “Sets” folder.

Step 6: restart MetaServer by going to your Desktop -> MetaServer folder and press the Start or restart icon.

Wait until the Message “MetaServer is running” shows.

Step 7: restart the Client.

Step 8: pinpoint and fix the problem in your workflow before importing documents again.

If, even after checking all your rules, the problem keeps occurring, contact us and describe your problem as detailed as possible.