Review Notes

- KB used as template: Helpdesk : SAFR Helpdesk

- Doc used for content: SAFR Server Operational Overrides Persistence - SAFR - Confluence

@Steve: Where can I find the available options that can be set in the override files? Is there a specific list of values for PACS?

SAFR Server provides settings files to modify its behavior and facilitate the integration with the customer's PACS.

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.

Notes

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.

Overrides Order

There’s an order to overrides:

Java code > applications.properties > operations.properties > persistent-overrides.properties

This is a default value present in the Java code:

@Value(""${application.override.present:DEFAULT-VALUE}"")
    private String applicationOverridePresent;

Defaults written in Java code may be overridden by values in applications.properties:

application.override.present:APPLICATIONS-PROPERTIES

Then operations properties in operations.properties:

application.override.present:OPERATIONS-PROPERTIES

Then overrides in persistent-override.properties

application.override.present:PERSISTENT-OVERRIDE

Example

Assume 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.