Getting Started with SAFR Platform on Windows or macOS

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 Licensing for details.) Any additional instances of SAFR Server you install under the same SAFR Local 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 Large Scale Deployments.

SAFR Platform Contents

The Windows SAFR Platform installation includes the following:

The macOS SAFR Platform installation includes the following:

Prerequisites

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

Download and Install SAFR Platform

To download and install SAFR Platform using Windows or macOS, do the following:

  1. On the computer where you want to install SAFR Server, open a web browser and go to the SAFR Download Portal.

  2. Sign in with your SAFR Local Account’s credentials.

  3. Once signed in, select your operating system from the menu and download the appropriate SAFR Platform installer.

  4. After the download is complete, start the installation.

  5. The Platform installer displays a Choose Components window where you can choose the features you want to install, such as:

    • SAFR Face Attribute Recognition
      • Age
      • Gender
      • Occlusion
      • Sentiment
      • Optimize GPU models
    • SAFR Peripheral Sub-systems
    • VMS Extensions
      • Avigilon
      • Digifort
      • Genetec Security Center
      • Genetec Security Center with FaceRec
      • Milestone XProtect
    • Camera Extensions
      • Intel RealSense
      • Ximea
    • GPU Support
      • NVIDIA Accelerated Recognition
    • SAFR Application (This refers to the Desktop client)
      You may uncheck the boxes for any features you do not want to install. We recommend installing all the components except the VMS extensions the first time you install SAFR Platform.
      In addition to whatever components you selected, SAFR Platform also always installs SAFR Server.
  6. Follow the installer prompts as they guide you through the rest of the installation process. The final phase of the installation may take a few minutes to complete as it installs dependencies and runs the configuration scripts. Allow it to continue without interruption.

  7. On Windows the default SAFR port assignments sometimes conflict with other software port assignments. If a port conflict occurs, the error message shown below will pop up in the middle of your installation.

    If this happens, do the following:

    1. Click OK to edit port configurations.
    2. Notepad will open, displaying the safrports.conf file.
    3. Edit any conflicting ports to new values. (e.g. CoviHTTP=18080)
    4. Save and exit Notepad.
      The Platform installer will then restart and the new port values will be used. You can find the modified safrports.conf file at C:\Program Files\RealNetworks\SAFR\.

After the installation finishes, three icons will appear on your desktop:

The SAFR Server automatically runs as a collection of background services.

Immediately following installation, the Platform installer opens the Desktop client and prompts you to log in with your SAFR Local Account. Make sure to log in; it’s important in acquiring the SAFR license.

Check Server Status

To check the status of your SAFR Server, use the check script. See the table below for the location of the script.

Platform Script Name File Location
Windows check.bat C:\Program Files\RealNetworks\SAFR\bin
macOS check.sh /Library/RealNetworks/SAFR/bin

The check script displays the status of all SAFR services. The following screenshot shows a server installation with healthy statuses for all its services:

Connect Desktop Clients

A Desktop client that is installed on the same machine as the primary server is automatically connected with your primary server; no additional actions need to be taken.

Desktop clients that are installed on machines other than the primary server, however, need to be configured so they can 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 either SAFR Desktop or SAFR Edge for your OS from the SAFR 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 IP Address for localhost:
      • CoVi Server: http://localhost:8080/covi-ws
      • Event Server: http://localhost:8082
      • Object Server: http://localhost:8086
      • VIRGA Server: http://localhost:8084
    • If you are running the server with an SSL certificate, enter the following in the associated fields, substituting your server’s hostname for localhost:
      • CoVi Server: https://localhost:8081/covi-ws
      • Event Server: https://localhost:8083
      • Object Server: https://localhost:8087
      • VIRGA Server: https://localhost:8085
  5. Click OK to save the preference changes.

Next Steps

Great! Now that you’ve installed the SAFR Platform, you’re ready to explore SAFR’s features. We recommend that you do the following: