ORS - How to move an ORS to the new server
This document describes how to move one ORS to the new server while the ORS GUID remains unchanged. The document also covers the scenario where IP address of the new server is different from the old one.
This article consists of:
Step 1 - configuration change on the CML server
This part describes the changes that must be done on the CML server where the ORS is connected to.
1 | Verify the ORS cache recovery settings. Go to System settings and set orsCacheRecovery property to enabled
|
2 | Open web interface of YSoft SafeQ CML server (use the first node in case of CML cluster) and go to Devices > Printers.
|
3 | Edit ORS that will be moved to the new server.
|
4 | Replace the Spooler IP address by the new one (the IP address that will be used on the new server).
|
In case of ORS cache data corruption, cache can be manually deleted and all job-related metadata will be recovered from CML. If this option is enabled, job consolidation will not be run during ORS startup.
NOTE: 
Step 2 - backup of data on the old ORS server
This part describes the steps to be performed on the ORS that is being moved to the new server.
1 | Open the Services window (e.g. Start => Run => services.msc) and stop all YSoft SafeQ ORS services:
|
2 | Backup ORS configuration files by backing up the directory <SafeQORS>\conf\ Backup ORS spooler files by backing up the content of directory <SafeQORS>\server\spool\ Backup folder containing scripts for scanning (if scan to script is used)
|
Step 3 - new ORS server installation/configuration
This part describes how to install and configure ORS on the new server.
1 | Copy ORS installation package to the new server and prepare the safeq-ors.ini according to the instructions from Installing YSoft SafeQ ORS article with following exceptions:. a. Parameteres for safeq-ors.ini can be taken from the backup of the original configuration files that was created in previous steps (<SafeQORS>\conf\modules\ors.conf). b. Set localGUID according to the value from backup of the original configuration (<SafeQORS>\conf\modules\guid.conf). c. Set spoolDir and rest of the settings according to your needs.
|
2 | Upload all print jobs from the backup of spool directory (created in previous steps) to the new location defined in safeq-ors.ini (parameter spoolDir). Copy folder containing scripts for scanning (if scan to script is used) to the same location as it was on the original server.
|
3 | Run the installation of ORS server using installORSv2-exe.cmd.
|
4 | Once the installation of ORS server is finished, verify the correct ORS functionality according to the article YSoft SafeQ ORS Health Check. Also check that you are able to release the jobs that were delivered to the ORS before the ORS has been moved.
|
5 | Now you can delete the old ORS server. WARNING: Do not start YSoft SafeQ ORS services on "original" server |
Other required reconfiguration
This section describes what additional steps must be performed for a proper functionality of the YSoft SafeQ once the ORS was moved to a new location.
1 | Reconfigure all print drivers (or YSoft SafeQ clients) to connect to the new IP address All print drivers that were connected to the ORS server with old IP address must be re-connected to the new IP address.
|
2 | Reconfigure HW terminals: If you are using hardware terminals, make sure that they are pointing to the new IP address.
|
3 | Reinstall all embedded Terminals: Reinstall all embedded terminals that shall be connecting to the server with the new IP address.
|