The computer used for the first installation of SAFR Platform acts as the primary server for the entire SAFR system. The primary server acquires a SAFR license that is then restricted to that machine (see On-Premises Licensing for details). Any additional instances of SAFR Server you install under the same SAFR account must be configured as secondary servers for the purposes of load balancing or redundancy and are linked to the primary server as described in SAFR Server Clusters.
The Linux SAFR Platform installation includes the following:
Before you begin the installation, ensure that you have the following prerequisites:
To download and install SAFR Platform on Linux, do the following:
Go to the SAFR Download Portal and enter your SAFR Local Account credentials.
On the download page, go to SAFR Platform and select Linux from the drop-down menu to the right.
Note: If you want to install SAFR Platform on NVIDIA Jetson system, you should instead select Jetson from the drop-down menu.
Right-click the Download button for your preferred Linux distribution and select Copy Link Address.
Download the file to your local machine. The following is an example cURL request which will accomplish this: curl -L -o safrinst.sh '<your copied link address>'
After the SAFR Platform installer is downloaded use chmod to make the downloaded file executable, if necessary.
Run the installer program.
The default SAFR port assignments sometimes conflict with other software port assignments. If a port conflict occurs, you'll see this error message:
Updating SAFR service port configuration
Enter new ports, or press enter to accept default.
You will be prompted to reconfigure your conflicted port values, one by one, until all conflicts are resolved.
CoviHTTP (8081):
The number in parenthesis is the current (i.e. conflicted) port number assignment.
If you enter an invalid value, (e.g. FRED) you will receive the error message
Invalid response: FRED - Enter integer value between 1024 and 65535.
You'll then be prompted to enter a different port number.
If you enter a port number that's also conflicted, you'll receive the error message
Port 1234 is already in use by CoviHTTP
You'll then be prompted to enter a different port number.
The Platform installer will then restart and the new port values will be used. You can find the modified safrports.conf file at /opt/RealNetworks/SAFR/
.
After it finishes, the installer exits. Your SAFR Server is now running as a collection of background services and is ready for use.
Note: Linux SAFR versions earlier than 3.1 are only compatible with NVidia driver versions 418.96 to 431.86.
To check the status of your SAFR Server, run the check script by executing the following command: /opt/RealNetworks/SAFR/bin/check
. The script displays the status of all SAFR services. The following screenshot shows a server installation with healthy statuses for all its services:
Sometimes long-running background processes that index or scan your hard drive (e.g. antivirus software) can cause your system to slow down or become unresponsive. If allowed to persist, this may result in system instability due to an accumulation of memory in writing images when large event volumes are experienced. Long write times can be confirmed by looking for write times greater than 500 milliseconds in the cv-object-storage.log file, located at /opt/RealNetworks/SAFR/cv-storage/cv-object-storage.log
.
This issue can be resolved by either disabling the problematic background process or by configuring the process to ignore files located in the cv-storage folder, located here: /opt/RealNetworks/SAFR/cv-storage
.
Desktop Clients that are installed on Windows or macOS machines need to be configured to connect with the primary server. Clients that aren't connected to a server are nearly useless and have very limited functionality.
To connect a remote Desktop Client, do the following: