SAFR Geutebrueck Integration Guide

Integrated SAFR Geutebrueck is only available on Windows.

Integrating SAFR’s facial recognition and analysis capabilities into Geutebrueck enables you to use SAFR’s video feed information overlays within Geutebrueck camera video feeds, thus making it much easier to quickly and accurately separate unknown people from authorized people from known threats. You’ll also have immediate access to additional infomation such as age, gender, sentiment, name, company, known associates, or any other configurable information you want to create.

Integrating the two systems also allows SAFR’s information-rich events to trigger and populate Geutebrueck events, alerts, and videotagging/bookmarking.

A final benefit to integrating SAFR and Geutebrueck is that you’ll be able to enroll individuals appearing in Geutebrueck cameras into SAFR’s Identity Database.

This page discusses how to install and configure SAFR and Geutebrueck so that the two systems are properly integrated. The SAFR Geutebrueck Operation Guide discusses how to operate the integrated systems.

Integration Overview

A typical deployment requires the following:

Cameras are connected to the Geutebrueck G-Core. The SAFR Desktop Client can then connect to the G-Core to perform analysis of the video and add overlays. Depending on the number of cameras you need, one or more machines may be required to run the SAFR Desktop Client(s), each processing multiple video feeds. The Desktop Client is also used to perform various management activities.

Install and Configure Geutebrueck

Install G-Core

  1. Download the latest G-Core installer from the Geutebrueck Download Portal.
  2. Run the installer, selecting the following options during installation:
    • Select all of the IP cameras.
    • Select Plugin > GBF Streamer.
    • Select Plugin > Media Channel Simulator.
    • Select Plugin > Livestream Reader.

Add a SAFR User Account

You’ll need to create a user account within Geutebrueck that SAFR will use to connect to Geutebrueck. To do this, do the following:

  1. Open the G-Set application.
  2. Go to General settings -> User.
  3. On the User configuration window on the right, click on the Add button in the upper left corner of the window.
  4. Enter a name and password for the new account.
  5. The new account will now be listed among the list of created user accounts.

Add a Camera

To add and configure a new camera to Geutebrueck, do the following:

  1. Open the G-Set application.
  2. Go to Media channels/Hardware -> Hardware. (#1 below)
  3. Click on the Add button at the top of the Hardware configuration window. Select the type of camera you want to add from the list of IP camera plugins. A new IP camera plugin entry will appear in the Hardware module list. (#2 below)
  4. Click on your new camera plugin entry. The right pane wll now display various settings for the new plugin.
  5. Enter the IP address for your camera as well as the credentials for its RTSP port, if applicable. (#3 below)
  6. Go to Media channels/Hardware -> Media channels. (#1 below)
  7. Click on Permanent recording for the camera plugin you just added. (#2 below)
  8. Tick the Permanent recording checkbox. (#3 below) This enables Geutebrueck to display reference images and event images.
  9. Go to Media channels/Hardware -> Hardware.
  10. Click on the Add button at the top of the Hardware configuration window. Select Plugin <Direct Image Feed Plugin> from the list of plugins, then press Add. A new IP plugin entry will appear in the Hardware module list. (#1 below)
  11. Click on the new plugin.
  12. Set the MediaChannelID of the MappedMediaChannel to the camera that’s being used. (#2 below)

Configure Geutebrueck Events

To add and configure a new Geutebrueck event type, do the following:

  1. Open the G-Set application.
  2. Go to Events/Behaviour rules > Events, (#1 below)
  3. Click on the Add button at the top of the Event Configuraton window. Your new event type will appear on the Event list. (#2 below)
  4. Click on your new event type. The right pane wll now display various settings for your new event type.
  5. Select the Event tab, if it’s not already selected.
  6. Enter a name for your new event type. (#3 below)
  7. Tick the Active and Event run time checkboxes. (#4 and #6 below, respectively)
  8. Select Start new instance from Retrigger mode’s drop-down menu. (#5 below)
  9. Select the Alarm tab. (#1 below)
  10. Tick the Active checkbox. (#2 below)
  11. Select the Media channels tab. (#3 below)
  12. Click on the Add button on the right of the Media channels window and select one of the listed cameras. The selected camera will now be a media channel for this alarm. (#4 below)
  13. Tick the Live checkbox. (#5 below)
  14. In the Event list, click on Recording tasks for your new event type. (#1 below) This will cause a new Recording task tab to appear on the right pane. Select that new tab.
  15. Select the Media channels tab, if not already selected.
  16. Click on the Add button on the right of the Media channels window and select one of the listed cameras. The selected camera will now be listed in the Media channels window. (#2 below)
  17. Tick the Record channel checkbox. (#3 below)
  18. In the Event list, click on StartBy for your new event type. (#1 below)
  19. Click on the Add button near the top of the Event configuration window.
  20. You will be prompted to select whivch action to add. Choose Face Recognition Result.
  21. In the Event list, click on the newly added Face Recognition Result.
  22. In the Settings window in the right pane, tick the channel checkbox.
  23. Select the media channel that you added in the previous steps from channel’s drop-down menu. (#2 below)

Install and Configure SAFR

To install SAFR, do the following:

  1. Go to the SAFR Download Portal.
  2. If you’re doing a cloud deployment, download and install Windows SAFR Desktop. Make sure to select the Geutebrueck install option.
  3. If you’re doing an on-premise deployment, download and install Windows SAFR Platform. Make sure to select the Geutebrueck install option.
    • When installing the SAFR Platform, 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, two icons will appear on your desktop: one labeled SAFRActions and another labeled SAFR. SAFRActions launches SAFR Actions, while SAFR launches the Desktop Client. The SAFR Server (when installed as part of a local deployment) automatically runs as a collection of background services.

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

Connect SAFR to Geutebrueck

To connect SAFR to Geutebrueck, do the following:

  1. Within your SAFR Desktop Client, select Tools->Preferences->Geutebrueck.
  2. Enter information for the first three settings on the SAFR Geutebrueck Preferences menu: Server, Username, and Password. See below for information about the available SAFR Geutebrueck preference settings.

SAFR Geutebrueck Preferences

You can configure several Geutebrueck-specific settings from the Tools->Preferences->Geutebrueck menu.

Verify the Connection to Geutebrueck

To verify that your SAFR system successfully connected to the Geutebrueck system, do the following:

  1. Open the Camera Feed Analyzer in the SAFR Desktop Client.
  2. Click on the camera selection drop-down menu at the top of the Camera Feed Analyzer.
  3. You should see the cameras connected to Geutebrueck among the available camera. Note: All Geutebrueck cameras will have “Geutebrueck” appended to the beginning of the camera name.
    • If you don’t see any Geutebrueck cameras listed, try shutting down and then restarting your SAFR Desktop Client.

See Also