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. We have a guide for Windows 10 and a guide for Windows 7.

For Windows 10 users:

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.
When that’s done, follow these final steps.

For Windows 7 users:

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

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

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

Step 4: click on the Show processes from all users to show the MetaServer process.

Step 5: search for “MetaService.exe” and press the End Process button.
Next, you need to go to C:\ProgramData\CaptureBites\Programs\MetaServer\Data.
NOTE: if you want to browse to it manually and don’t see your ProgramData folder in your C drive, please follow these steps:
Step 1: press the Organize button in your Explorer window and select “Folder and search options”
Step 2: open the View tab and enable the “Show hidden files, folders and drives” option.

Final steps (for both Windows 10 & 7):

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

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

Step 2: 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 3: restart the Client.

Step 4: 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.