Licensing

SAFR systems require a license to operate.

License Limit Metrics

SAFR licenses limit usage according to the following metrics:

License limit metrics for your SAFR license can be found on the Status page of the Web Console. Note that Max Days Between Reports won’t appear on your Web Console if you have a cloud deployment.

Licensing for Local Deployments

In local deployments, SAFR licenses are attached to your SAFR system’s primary server. The following describes how the SAFR license is managed:

Offline Licensing

If your SAFR system doesn’t have Internet connectivity, do the following to get a SAFR license:

  1. Obtain a license request file for the machine on which SAFR Platform is installed.
    1. On the machine that has SAFR Platform installed, run get-license-request.py.
      • For Windows: C:\Program Files\RealNetworks\SAFR\bin\get-license-request.py
      • For Linux: /opt/RealNetworks/SAFR/bin/get-license-request.py
      • For macOS: /Library/RealNetworks/SAFR/bin/get-license-request.py
    2. When prompted, enter the SAFR account name and password.
    3. The script will attempt to read safrports.conf to communicate with CoVi. If safrports.conf can’t be found, then the script will use the default port, 8080.
    4. The script can be copied and run from any system that has Python 3 installed. If you run the script on a machine other than the one hosting SAFR Platform, use the -n parameter to provide the hostname of the machine hosting SAFR Platform.
    5. Running the script generates a file called safr_license_request.json in the same working directory as the script. Make sure to run the script in a directory that you have write access to.
  2. Retrieve the license by sending the license request to SAFR Cloud.
    1. Copy the newly generated safr_license_request.json file and the script get-license.py to a machine that has Internet access and has Python 3 installed. get-license.py can be found at the following locations:
      • For Windows: C:\Program Files\RealNetworks\SAFR\bin\get-license.py
      • For Linux: /opt/RealNetworks/SAFR/bin/get-license.py
      • For macOS: /Library/RealNetworks/SAFR/bin/get-license.py
        Note: On a macOS machine you might receive an error message about being unable to load SSL root certificates. This is an issue with the way Python handles SSL certificates on Macs. More information about the issue can be found here. A workaround can be found here.
    2. When prompted, enter the SAFR account name and password.
    3. You can use the -p parameter to tell the script where safr_license_request.json is located.
    4. You can use the -e parameter to set the environment value. (i.e. prod, int2, or dev) The default is prod.
    5. Running the script generates a file called safr_license.json in the same working directory as the script. Make sure to run the script in a directory that you have write access to.
  3. Install the retrieved license onto your installed SAFR Platform.
    1. Copy safr_license.json to the machine running your SAFR Platform.
    2. Run insert-license.py to install the license onto your SAFR installation.
      • For Windows: C:\Program Files\RealNetworks\SAFR\bin\insert-license.py
      • For Linux: /opt/RealNetworks/SAFR/bin/insert-license.py
      • For macOS: /Library/RealNetworks/SAFR/bin/insert-license.py
    3. When prompted, enter the SAFR account name and password.
    4. The script will attempt to read safrports.conf to communicate with CoVi. If safrports.conf can’t be found, then the script will use the default port, 8080.