VIRGO Installation Guide

This page describes how to install the standalone Video Recognition Gateway (VIRGO).

Note: If you installed VIRGO when you installed SAFR Platform or SAFR Desktop, there's no need to install standalone VIRGO.

System Requirements

See the VIRGO System Requirements page before you start the VIRGO installation process. Note that VIRGO depends on certain 4r party libraries which must be installed before installing VIRGO.

Download the VIRGO Installer

The macOS and Linux standalone VIRGO installers can be downloaded from the SAFR Download Portal here: https://safr.real.com/developers

VIRGO Installer Package

This package installs VIRGO as a system or user daemon. The system daemon installation ensures that VIRGO will be able to run independently of any logged in user and it will start running as soon as the computer is booted up. Administrator privileges are required to complete the installation. VIRGO will look for factory default settings in the /etc/virgo-factory.conf file. The user installation, on the other hand, links VIRGO to the user who installed it. The VIRGO daemon will only be accessible to this user and it will only run while this user is logged in. However no administrator privileges are required to install and operate VIRGO in this mode. VIRGO will look for factory default settings in the ~/virgo-factory.conf file.

The following sections describe how to use the platform-specific version of the VIRGO installer package.

macOS

Installer name: Virgo.pkg

Follow these steps to install VIRGO on your macOS machine:

  1. Download the macOS VIRGO installer from the SAFR Download Portal here: https://safr.real.com/developers
  2. Double click it.
  3. The installer will guide you through the necessary steps to complete the installation. Note that you can choose between a system and user installation by selecting the appropriate install location option.

VIRGO will be installed into the following location:

Linux

Installer name: virgo_installer.tar.gz

Follow these steps to install VIRGO on your Linux machine:

  1. Download the Linux VIRGO installer from the SAFR Download Portal here: https://safr.real.com/developers
  2. Decompress the package: tar -xzf virgo_installer.tar.gz
  3. Make sure that the necessary third-party library dependencies are installed. For a list of required libraries see the VIRGO system requirements documentation.
  4. Run the installer script. The installer script will by default install VIRGO as a system daemon. Although we strongly recommend that you install VIRGO as a system daemon, we do support user daemon installations. You can explicitly specify the desired type of installation by passing the –-user or –-system option to the script:
    • virgo_installer/install.sh --user installs VIRGO as a user daemon.
    • virgo_installer/install.sh --system installs VIRGO as a system daemon.

VIRGO will be installed into the following location:

The installer script will ask you for all necessary information and guide you through the installation process.

The final VIRGO configuration information is written to a factory configuration file which is stored in the required file system location from where VIRGO is able to read it. Note that for security reasons the factory configuration file is only readable and writeable by the user who owns the VIRGO daemon. The following code block shows an example of how to install VIRGO as a system daemon:

> sudo virgo_installer/install.sh

FAQ for macOS Installations

  1. I've installed VIRGO as a system daemon. How do I change the factory configuration?

    Place your custom factory configuration file in the /etc directory and then reset the VIRGO service like this:

    Assuming that the factory configuration file is at:
    
    /etc/virgo-factory.conf
    
    > virgo service reset
  2. I've installed the VIRGO Package. How do I uninstall VIRGO?

    For system daemon installations, execute the following command from the Terminal:

    > sudo /Library/RealNetworks/virgo/uninstall.sh

    For user daemon installations, execute the following command from the Terminal:

    > ~/Library/RealNetworks/virgo/uninstall.sh
  3. I've installed the VIRGO as a user daemon. How do I stop virgod?

    Execute the following command from the Terminal:

    > launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.real.virgod.plist

    This command terminates the virgod daemon. Keep in mind that the VIRGO command line tool will automatically restart virgod when you use it again.

FAQ for Linux Installations

  1. I've installed VIRGO as a system daemon. How do I change the factory configuration?

    Place your custom factory configuration file in the /etc directory and then reset the VIRGO service like this:

    Assuming that the factory configuration file is at:
    
    /etc/virgo-factory.conf
    
    > virgo service reset
  2. I've installed the VIRGO Package. How do I uninstall VIRGO?

    For system daemon installations, execute the following command from a shell:

    > sudo /opt/RealNetworks/virgo/uninstall.sh

    For user daemon installations, execute the following command from the Terminal:

    > ~/RealNetworks/virgo/uninstall.sh
  3. I've installed VIRGO as a user daemon. How do I stop virgod?

    Execute the following command in a shell:

    > systemctl stop --user com.real.virgod.service

    This command terminates the virgod daemon. Keep in mind that the VIRGO command line tool will automatically restart virgod when you use it again.

See Also