ORS - How to delete corrupted cache

Please note that this how to is valid only for a standalone ORS.

If you need to restart ORS which is part of Near Roaming Group (NRG), use Restarting ORS services in Near Roaming Group instead.

About cache deletion

Deleting the ORS cache is in a specific cases the only way to restore the proper ORS functionality.

 

When the cache is deleted the particular ORS will loose all information about users, cards, jobs and printers.

  • All necessary information about printers, users rights and billing codes are synchronized to the ORS (from CML) during the first synchronization (after the restart of ORS service).

  • Information about Jobs is synchronized as part of Cache Recovery Mechanism

  • User's data will be synchronized to the ORS (from CML) during the first authentication of user.

WARNING

ORS cache equals to CML database. The request for deletion of ORS cache shall be performed only when requested by Y Soft.

 

How to delete ORS cache

1

Verify the ORS cache recovery settings.

Go to System settings and set orsCacheRecovery property to enabled
images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/information.svg 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.

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/lightbulb_on.svg NOTE: If you omit this step, all jobs stored on the ORS will lost after the end of procedure.

2

Open the Services window (e.g. Start => Run => services.msc) and stop all YSoft SafeQ ORS services:

  • YSoft SafeQ Terminal Server

  • YSoft SafeQ ORS

  • YSoft SafeQ ORS Web Service

    images/download/attachments/21955746/orsServices.png

3a

Delete ORS cache by deleting whole folder <SAFEQORS_DIR>\server\cache


3b

Create file named ".orscdm" (note the dot at beginning) in directory <SAFEQORS_DIR>\bin. This file works as manual flag, which indicates that caches must be deleted during ORS startup.

4

Open the Services window (e.g. Start => Run => services.msc) and start all YSoft SafeQ ORS services:

  • YSoft SafeQ Terminal Server

  • YSoft SafeQ ORS

  • YSoft SafeQ ORS Web Service

5

Once the ORS cache is deleted, verify the correct ORS functionality according to the article YSoft SafeQ ORS Health Check.