OS Specific Installation

Hint

If you are looking for an evaluation, please use the Docker Express Install.

See Nginx and Lighttpd for the Nginx or Lighttpd installation.

Amazon Linux

Amazon Linux is similar to CentOS as yum is used as packager manager, however, below CentOS instructions cannot be used as packages are not binary compatible.

Install

First, download the packages:

  • Download the mp4split package (which also contains unified_capture).
  • Download the Apache package

Secondly, install the dependencies and Apache:

#!/bin/bash

yum install expat.x86_64 \
  curl.x86_64 \
  sqlite.x86_64 \
  libuuid.x86_64 \
  openssl.x86_64

Then, use rpm to install mp4split and mod_smooth_streaming:

#!/bin/bash

rpm -i mp4split-x.y.z-amli-RELEASE.x86_64.rpm

rpm -i mod_smooth_streaming-x.y.z-amli-RELEASE.x86_64.rpm

Uninstall

Uninstalling mp4split and mod_smooth_streaming is the reverse of installing:

#!/bin/bash

rpm -r mp4split \
   mod_smooth_streaming

Debian

Install

First, download the packages:

  • Download the mp4split package (which also contains unified_capture).
  • Download the Apache package

Secondly, install the dependencies and Apache

#!/bin/bash

sudo apt-get install libexpat1 \
  uuid \
  libsqlite3-0 \
  libcurl3 \
  apache2

Then use dpkg to install both mp4split and mod_smooth_streaming:

#!/bin/bash

sudo dpkg -i mp4split_x.y.z_RELEASE_amd64.deb

sudo dpkg -i libapache2-mod-smooth-streaming_x.y.z_RELEASE_amd64.deb

Uninstall

Uninstalling mp4split and mod_smooth_streaming is the reverse of installing:

#!/bin/bash

sudo dpkg -r mp4split \
   libapache2-mod-smooth-streaming

CentOS

The installation as described below can be downloaded and run as a single script:

#!/bin/bash

wget http://repo.unified-streaming.com/install-apache-usp.sh
chmod +x install-apache-usp.sh
./install-apache-usp.sh -y

Setup and dependencies

To install the dependencies on CentOS, please do the following:

#!/bin/bash

yum install expat.x86_64 \
  curl.x86_64 \
  sqlite.x86_64 \
  libuuid.x86_64 \
  openssl.x86_64

To install Apache:

#!/bin/bash

yum install httpd.x86_64 \
  httpd-tools.x86_64

Repository

You can install mp4split and the Apache module from our repository.

This is done by creating a file unified-streaming.repo in /etc/yum.repos.d with the following content:

[unified-streaming]
name=unified-streaming
baseurl=VERSION
enabled=1
gpgcheck=1
gpgkey=http://yum.unified-streaming.com/unifiedstreaming.pub

and replace VERSION with the baseurl from below table.

The following versions are available:

Version Baseurl
CentOS 7.2 http://yum.unified-streaming.com/centos/72/x86_64
CentOS 6.8 http://yum.unified-streaming.com/centos/68/x86_64

A search for mp4split:

#!/bin/bash

yum search mp4split

then results in the following:

unified-streaming
================================================================================== N/S matched: mp4split
mp4split.x86_64 : Command line utility for processing MP4 files (mp4split)

MP4split

To install mp4split:

#!/bin/bash

yum install mp4split.x86_64

Apache

To run mod_smooth_streaming you also need to install Apache.

#!/bin/bash

yum install mod_smooth_streaming.x86_64

Further setup and configuration can be found in the Configuration documentation.

Uninstall

Uninstalling mp4split and mod_smooth_streaming is the reverse of installing:

#!/bin/bash

yum remove mp4split \
  mod_smooth_streaming.x86_64

Ubuntu

The installation as described below can be downloaded and run as a single script:

#!/bin/bash

wget http://repo.unified-streaming.com/install-apache-usp.sh
chmod +x install-apache-usp.sh
sudo ./install-apache-usp.sh -y

Setup and dependencies

First, make a backup of your apt sources list:

#!/bin/bash

sudo cp /etc/apt/sources.list /etc/apt/sources.list.backup

Then add the Unified Streaming repository to your apt sources:

#!/bin/bash

sudo sh -c 'echo "deb [arch=amd64] http://apt.unified-streaming.com trusty multiverse" >> /etc/apt/sources.list'

Note

Use 'xenial' instead of 'trusty' if you want to install for Ubuntu 16.

Add the Unified Streaming key to your keyring (otherwise apt will fail complaning about missing keys).

#!/bin/bash

wget http://apt.unified-streaming.com/unifiedstreaming.pub
sudo apt-key add unifiedstreaming.pub

The shell will print 'OK', but you can check if the key is imported like this:

#!/bin/bash

sudo apt-key list

Now you are almost setup to install USP, the only thing left is to update apt:

#!/bin/bash

sudo apt-get update

MP4split

Installing mp4split is a 2 step process: first the dependencies, then mp4split:

#!/bin/bash

sudo apt-get install libexpat1 \
  uuid \
  libsqlite3-0 \
  libcurl3

Please note that for LIVE streams sqlite3 is required.

Then install mp4split:

#!/bin/bash

sudo apt-get install mp4split

Apache

After installing mp4split, we will now install Apache and the webserver module:

#!/bin/bash

sudo apt-get install apache2 \
  libapache2-mod-smooth-streaming

After installation with apt-get, you need to enable the new module:

#!/bin/bash

sudo a2dismod mpm_event

sudo a2enmod mpm_worker \
  headers \
  mod_smooth_streaming

Configuration

For an overview of the Apache configuration options, please see the Configuration section.

Uninstall

Uninstalling mp4split and mod_smooth_streaming is the reverse of installing:

#!/bin/bash

sudo apt-get remove mp4split \
  libapache2-mod-smooth-streaming

Windows

Self contained zip files of Windows builds are available:

Next steps

Verify your setup

The image comes fully installed with the demo content as outlined in the Verifying Your Setup section.

Start with Live

Following the Starting with Live section you can learn how to setup Live streaming with USP.