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.
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.
The macOS and Linux standalone VIRGO installers can be downloaded from the SAFR Download Portal here: https://safr.real.com/developers
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.
Installer name: Virgo.pkg
Follow these steps to install VIRGO on your macOS machine:
VIRGO will be installed into the following location:
~/Library/RealNetworks
~/Library/RealNetworks
Installer name: virgo_installer.tar.gz
Follow these steps to install VIRGO on your Linux machine:
tar -xzf virgo_installer.tar.gz
–-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:
/opt/RealNetworks
~/RealNetworks
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
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
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
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.
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
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
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.