Persisting Server settings during software update

SAFR Server provides settings files to modify its behavior and facilitate the integration with the customer's PACS.  One file exists for each access control system (e.g. genetec.properties, avigilon.properties)

These files are located in the following folder:

Windows: C:\Program Files\RealNetworks\SAFR\covi\app\config\covi
Linux: /opt/RealNetworks/SAFR/covi/app/config/covi

All files except persistent-overrides.properties are overwritten with each release. Therefore, any modifications made to other files will be lost with each release. To ensure configuration changes persist throughout the update, they should be copied into persistent-overrides.properties.

By default, persistent-overrides.properties includes a "".example"" extension.  This extension must be removed.  Once removed, properties from the other files may be added to this file.  This file will remain unchanged from release to release. If the update includes a hardware change, make sure to create a backup of the file and verify its compatibility with the new environment.

File Editing Process

The file persistent-overrides.properties requires administrative privileges to edit.  If using Windows Notepad, open Notepad as Administrator before opening the file.

ExampleAssume a facility id has been set in avigilon.properties.  The 'avigilon.facility.id.override' property and its value should be copied from avigilon.properties and added to persistent-overrides.properties.  persistent-overrides.properties should then look like the following: 

## Add properties here that should not be overwritten on overinstall

##
## Uncomment this, should see value in logging startup 
## instead of APPLICATION, OPERATION or DEFAULT
##
## application.override.present=PERSISTENT-OVERRIDE
avigilon.facility.id.override=123

Ovserve that the comments ( ""##""  characters ) must be removed from the font of the line in order for it to take effect.