Verifying Your Setup

The goal of this section is provide a demo/test setup that looks like our online Unified Streaming Demo, which in turn looks like this:

../_images/demo.png

Also note that if you have a question or need help, you can ask in our forum.

Download and Installation

Attention

Please download and install your License Key in /etc/usp-license.key before running the install script outlined below.

After installation of the license key, the next step is to run the install script:

#!/bin/bash

wget http://repo.unified-streaming.com/install-tears-of-steel.sh
chmod +x install-tears-of-steel.sh
sudo ./install-tears-of-steel.sh

Linux

Once installed you can direct your browser to the following URL:

http://evaluation.unified-streaming.com

Please note, you will need to edit your hosts file to map the IP address of your (virtual) server to the URL:

#!/bin/bash

sudo sh -c 'echo "10.0.0.1 evaluation.unified-streaming.com" >> /etc/hosts'

Where 10.0.0.1 is an example ip address, the ip address used should be that of the (virtual) machine USP runs on.

Windows

On Windows the procedure is slightly different, as IIS is setup different from Linux webservers.

Download:

wget http://repo.unified-streaming.com/tears-of-steel-x.y.z.zip

Unzip beneath the IIS webroot (usually c:\\inetpub\\wwwroot).

Then edit the 'hosts' file on Windows (c:\\windows\\system32\\drivers\\etc\\hosts) and add:

10.0.0.1 evaluation.unified-streaming.com

Where 10.0.0.1 is an example ip address, the ip address used should be that of the (virtual) machine USP runs on.

Virtual hosts and DNS

In the section above we simple mapped the name 'evaluation.unified-streaming.com' to a local ipaddress in the hosts file. This assumes you're using the same server to stream and view which is not a real world scenario. Use your DNS to set up a mapping from hostname to ip address, so the hostname resolves to the ipaddress of the server USP runs on.

In all cases, you really should use hostnames and not ip addresses.

The virtual host file of the webserver (which configures the webserver for a certain location) should use the same hostname, e.g. for Apache (where HOSTNAME should be replaced with your hostname):

ServerName HOSTNAME

For Apache on Ubuntu the vhosts can be found in /etc/apache2/sites-enabled.

For other webservers please refer to their documentation or see Unified Origin.

Tears of Steel

The demo setup is based on the Tears of Steel movie by the Blender Foundation.

The zip file contains all the required files for playback together with a test video:

File Comment
conf Contains the Apache config file.
index.html The page showing the feature overview.
players Contains players for HSS, HDS and MPEG-DASH.
video The Tears of Steel video.

The Apache config file in the 'conf' directory contains a virtual host and a few other directives, for instance related to Remote Storage.

The video directory contains a Makefile which will show you how the server manifests are created.

Both are to be considered as reference.

A few other files and directories can be found as well, but these are used internally by the demo.

Files

The video directory contains following audio/video/subtitle files:

File Comment
tears-of-steel-1200k-bp.ismv The video track at 1200 kbits/second, Base Profile
tears-of-steel-800k-bp.ismv The video track at 800 kbits/second, Base Profile
tears-of-steel-400k-bp.ismv The video track at 400 kbits/second, Base Profile
tears-of-steel-128k.isma The audio track at 128 kbits/second, AAC
tears-of-steel-ac3.mp4 The audio track as Dolby Digital
tears-of-steel-de.srt The German subtitles in srt format
tears-of-steel-en.srt The English subtitles in srt format
tears-of-steel-es.srt The Spanish subtitles in srt format
tears-of-steel-fr.srt The French subtitles in srt format
tears-of-steel-nl.srt The Dutch subtitles in srt format
tears-of-steel-ru.srt The Russian subtitles in srt format

Manifests

The manifests for the different formats are the following:

Device/player URL Description
http://evaluation.unified-streaming.com/video/tears-of-steel/tears-of-steel.ism/Manifest The HTTP Smooth Streaming client manifest.
http://evaluation.unified-streaming.com/video/tears-of-steel/tears-of-steel.ism/.m3u8 The master .m3u8 playlist for HTTP Live Streaming
http://evaluation.unified-streaming.com/video/tears-of-steel/tears-of-steel.ism/.f4m The HTTP Dynamic Streaming manifest.
http://evaluation.unified-streaming.com/video/tears-of-steel/tears-of-steel.ism/.mpd The MPEG DASH manifest.

Video Fragments

Common Errors

System.Exception 4001 An error has occured.

The PDK/EE3 Silverlight players only work with client manifests containing exactly one audio track.

Sample Scripts

In most parts of the documentation command snippets are used as example to setup a certain feature.

For some parts we provide ready made scripts that contain the all the steps, so they only need to be executed. These scripts use Tears of Steel as outlined above.

A fully featured demo using Tears of Steel can be found in the online Unified Streaming Demo.

Your just created test/evaluation will look similar, but with fewer options turned on. Please contact us if you would like to learn more.