Getting Started with SAFR Platform on Linux

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.

SAFR Platform Contents

The Linux SAFR Platform installation includes the following:

Prerequisites

Before you begin the installation, ensure that you have the following prerequisites:

Download and Install the SAFR Platform

To download and install SAFR Platform on Linux, do the following:

  1. Go to the SAFR Download Portal and enter your SAFR Local Account credentials.

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

  3. Right-click the Download button for your preferred Linux distribution and select Copy Link Address.

  4. 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>'

  5. After the SAFR Platform installer is downloaded use chmod to make the downloaded file executable, if necessary.

  6. Run the installer program.

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

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

Check Server Status

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:

Configure Background Processes

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.

Connect Remote Desktop Clients

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:

  1. On the remote machine download and install SAFR Desktop for your OS from the Download Portal.
  2. Start the Desktop Client. If prompted, cancel the camera login screen. Also cancel the SAFR Account login if it is displayed.
  3. Click Tools > Preferences. On the Account tab, enter your user identifier and password for your SAFR Local Account.
  4. Select SAFR Custom from the drop down menu of the Environment setting. Do one of the following:
    Note: If you customized ports when installing SAFR Server, use the customized port values instead of the values listed below.
    • If you are running the server without an SSL certificate, enter the following in the associated fields, substituting the server URL for localhost:
      • CoVi Server: http://localhost:8080
      • Event Server: http://localhost:8082
      • Object Server: http://localhost:8086
      • VIRGA Server: http://localhost:8084
    • If you are running the server with an SSL CERT, enter the following in the associated fields, substituting your server's hostname for localhost:
      • CoVi Server: https://localhost:8081
      • Event Server: https://localhost:8083
      • Object Server: https://localhost:8087
      • VIRGA Server: https://localhost:8085
  5. Click OK to save the preference changes.