ROES Server - Won't Launch; How to Repair - How to Restore Using a Backup



When the server fails a relaunch, it is usually because we can't digest something in a corrupted file.  The file can be ANY file in the .ROESServer folder or in the Working Files folder.  You can use the files in the Backup to help you troubleshoot and restore the files.


1. Rename the Working Folder:  An easy first step is to rename the Working Files directory by adding a single character to the folder name.  The Server won't be able to find the folder then and won't try to digest any of the Order files contained in it.

  • Try to relaunch.  If the ROES  Server launches after doing that, there is a file in the Working Files directory that it doesn't like.  
  • Usually it is the last order that was processed or it attempted to process that is causing the problems.  
  • Go into the Working Files directory and sort by date modified.
  • Look for .ro files in the directory and a folder named the same as the .ro file.
  • The presence of a .ro file and it's corresponding folder in the Working Files directory means an order didn't complete it's processing.
  • If there aren't any .ro files, take the two newest folders and move them out of the Working Files folder and try to relaunch the server.
  • If the Server still won't launch, go to the next step.

2. Remove or replace the SARPreferences.xml:  The next step is to see if one of the files in the .ROESServer folder is bad.

  • Remove the SARPreferences.xml file from the .ROESServer on your computer.
  • Try a relaunch.  If the relaunch is successful to the point of the Server asking you for your login (put in “admin” and “labkey”), you've found the bad file
  • Replace that file with the one you have in your backup and relaunch.  **If you don't have a backup of the .ROESServer folder, you will have to re-enter all of the settings.  Refer to ROES-U for a reference: **
  • Anything that might have been changed in your configuration since the backup was made will need to be manually updated.  This includes all information in most of the tabs.  The exception is the Printing tab.
  • If that didn't work, go to the next step.

3. Remove or replace the Printers, Queues or Workflows folders:  The next step is to see if one of the xml files are bad in either the Printers, Queues or Workflows folder. 

  • Remove the Printers folder from the .ROESServer Folder on your computer.
  • Try a relaunch.
  • If that works, you have isolated the issue to being one of the xml files in the Printers folder and can remove all of the xml files from that folder and put them back one by one, attempting a relaunch after replacing each file, to see which one was bad.
  • OR.....if nothing has changed in the settings of your printers since the last backup, you can just replace the Printers folder with the one from your backup and you will be done.  **If you don't have a backup of the .ROESServer folder, you will have to create the printer or agent again and enter all of it's settings.  Refer to ROES-U for examples of the printer or agent : **
  • Repeat with the Queues and Workflows folder.