UltraGrid Setup (Linux)

This site will guide you through the instalation of the UltraGrid software on your Linux machine.

OS setup

At first download UltraGrid tarball, unpack it somewhere and follow the steps described below (assuming that the current working directory is ultragrid, x86_64 architecture is used and working linux kernel headers are installed).

First extend network buffer sizes:

• Add the following text to file /etc/sysctl.conf
• After the file is edited, run sysctl -p to apply the changes

# Extended network buffers for UltraGrid net.core.wmem_max = 8388608 net.core.wmem_default = 8388608 net.core.rmem_max = 8388608 net.core.rmem_default = 8388608

To compile UltraGrid, you require gcc, make, automake and autoconf packages (the package names work for all OSes):

 # as root:
 yum install gcc make automake autoconf # Fedora, CentOS
 apt-get install gcc make automake autoconf # Ubuntu, Debian
 zypper install gcc make automake autoconf # OpenSUSE

TODO: Martin - explain the following or move it to FAQ

Make sure that especially the following services are stopped, disabled or not installed at all:

 avahi-daemon
 iptables
 irqbalance

Names of the services may slightly vary across different systems.

TODO

Drivers

After setting your OS, install card driver for your card (if any):

• Centaurus
• Quad
• DeckLink

Additional modules

If you are willing to use some of the extensions, you must get them ready prior to compiling UltraGrid:

• Portaudio
• DXT compression
• GPU accelerated DXT compression

Compiling UltraGrid

Once all above is done, based on your preferences, run the configuration script:

 cd ultragrid && ./autogen.sh

Note: If you intend to use DVS (Centaurus) card, you have to use slightly modified command ./autogen.sh --with-dvs=<path_to_DVS_SDK>, where the path is where you extracted the tarball (in step installing Centaurus drivers.

Here you can check whether all the features you have selected were detected and are going to be included. If so, compile UltraGrid:

 make

If no error has occured, the compilation is complete and ultragrid is ready to run. If you do not have zip installed, the following error will occur. This is because of an attempt to install an extension and has no effect on ultragrid's overall installation.

 Creating AccessGrid plugin: uvRecieverService.zip
 make: zip: Command not found
 make: *** [ag_plugin/uvRecieverService.zip] Error 127

Run

Now you are ready to run UltraGrid