ReStream 2.X Installation Manual

This document will try to help you install ReStream 2.X. ReStream 2.X consists on different programs and services. And of course a Dreambox.

Settings:

Here you can make your choice of installation OS. Each OS has his own settings. Most settings are already correct, but you can fill in the form below to get all the right settings for your setup. At least the IP number of the dreambox should be filled in manually!!

Variable Value
OS: Windows, Mac OS X, Linux
Dreambox ip:
Dreambox username:
Dreambox password:
Dreambox type:
VLC server executable:
VLC server ip:
VLC server port:
Wowza Media Server 2 ip:
Webserver ip:
Webserver port:
Restream path:

Setup:

1. Video Lan Client (VLC)

Windows
Download VLC and run it. Use the installation defaults.
Mac OS X
Download VLC. Double click the disk image and drag the VLC icon onto the application folder. You will see that VLC is installed in your application folder.
Linux
Download VLC and select your download for your Linux distribution. Follow the installation steps on the webpage of VLC. You can verify if VLC is succesfully installed by opening a console and start cvlc. This will show some information like:
'VLC media player 1.0.6 Goldeneye' and 'dummy interface: using the dummy interface module...'

2. Web server envoirnment

Windows
Download WAMP and run it on you Windows. Just follow the installation and use the defaults. After installation start the WAMP server and check if it is up. You will see a small icon next to you clock. Clik on that and put the system to 'online'. After that click again on the icon and select the top menu option 'localhost'. If you get a browser with an information page of WAMP, your setup is ok!
Mac OS X
Download MAMP and run it on you Mac OS X. Drag the folder MAMP to the application folder. After installation open you application folder and you will have a new folder MAMP. In that folder you can run the program MAMP. This will give you a tool to start the apache and mysql service. And it will show the help page in you browser. When you see this help page, your installation was successful. Remember, closing the MAMP application will also stop the apache and mysql service. So keep the application open.
Linux
Use you package manager to install the latest Apache and PHP 5. Normally this is done with some commands like 'aptitude install apache2 php5'. Or 'yum install apache2 php5'

3. Install Java

Windows
Download the latest version of Java from the official site. After downloading install the Java by double clicking on the file. Open a terminal by going to 'Start' and than run. Execute the command cmd and you will get a dos prompt. Execute the command 'java -version'. It should return something like
java version "1.6.0_20"
Java(TM) SE Runtime Environment (build 1.6.0_20-b02-279-10M3065)
Java HotSpot(TM) Client VM (build 16.3-b01-279, mixed mode)
The version numbers can differ.
Mac OS X
On Mac OS X you should already have the latest Java. You can check this by running the command 'java -version' in a terminal. You will get something back like
java version "1.6.0_20"
Java(TM) SE Runtime Environment (build 1.6.0_20-b02-279-10M3065)
Java HotSpot(TM) 64-Bit Server VM (build 16.3-b01-279, mixed mode)
The version numbers can differ.
Linux
Download the latest version of Java from the official site. Select the linux version that fits your linux distribution. Search with google if you have problems installing Java. It really depends on your distribution. At the end you should be able to run the following command: 'java -version'
java version "1.6.0_19"
Java(TM) SE Runtime Environment (build 1.6.0_19-b04)
Java HotSpot(TM) 64-Bit Server VM (build 16.2-b04, mixed mode)
The version numbers can differ.

4. Install Wowza Media Server 2

Windows
Download the latest version of Wowza Media Server from the official site. And requests a free 10 connections license. Double clikc the download file and follow the installation. Install the application for all users. During installation fill in your 10 connections serial. After installation you can start Wowza from the Windows menu. When you start Wowza Media Server 2 you will get a dos box. In that dosbox you should see something like:
INFO vhost comment _defaultVHost_ Bind attempt ([any]:1935:4)
INFO vhost comment _defaultVHost_ Bind successful ([any]:1935)
And test if it is running by clicking here. You will get a page with the following content:
Wowza Media Server 2 Developer 2.X.Y build[SOME NUMBER].
For now stop Wowza Media Server 2 by pressing Crtl-C in the terminal window.
Mac OS X
Download the latest version of Wowza Media Server from the official site. And requests a free 10 connections license.
Double click the downloaded DMG to open de disk image and start the installation by double clicking the package. Use the default values and finish the installation. After installation you will have a new folder in he application folder. Open the folder Wowza Media Server 2.X.Y and double click the Wowza Startup application. This will open a new terminal which will ask for a service license the first time. Enter the free 10 connections license key you have received by e-mail. After starting up, you should see something like:
INFO vhost comment _defaultVHost_ Bind attempt ([any]:1935:4)
INFO vhost comment _defaultVHost_ Bind successful ([any]:1935)
And test if it is running by clicking here. You will get a page with the following content:
Wowza Media Server 2 Developer 2.X.Y build[SOME NUMBER].
For now stop Wowza Media Server 2 by pressing Crtl-C in the terminal window.
Linux
Download the latest version of Wowza Media Server from the official site. And requests a free 10 connections license. Select the RPM or DEB package that fits your distribution. After installation create a Server.license file in the Wowza Media Server 2 configuration folder (/usr/local/WowzaMediaServer/conf/Server.license) and paste as one line your 10 connections license you have received in your e-mail. Than you can start the service with the command /etc/init.d/WowzaMediaServer (re)start.
And test if it is running by clicking here. You will get a page with the following content:
Wowza Media Server 2 Developer 2.X.Y build[SOME NUMBER].

5. Unpack / move ReStream 2.0 files to the webroot

Windows
When you have unpacked the ReStream 2.0 zip file, you will have a ReStream_2.0 folder. Move this folder to the webroot of WAMP. This is normally at 'C:\wamp\www'. So copy the ReStream_2.0 folder into that folder. You can check if the files are on the right place by clicking here. You will get a message that the dreambox is offline. That is good for now!
Mac OS X
When you have unpacked the ReStream 2.0 zip file, you will have a ReStream_2.0 folder. Move this folder to the webroot of MAMP. This is normally at '/Applications/MAMP/htdocs'. So copy the ReStream_2.0 folder into that folder. You can enter this folder by opening the applications, open the MAMP folder and enter the htdocs folder. You can check if the files are on the right place by clicking here. You will get a message that the dreambox is offline. That is good for now!
Linux
When you have unpacked the ReStream 2.0 zip file, you will have a ReStream_2.0 folder. Move this folder to the webroot of Apache. This is normally at '/var/www'. So copy the ReStream_2.0 folder into that folder. You can check if the files are on the right place by clicking here. You will get a message that the dreambox is offline. That is good for now!

6. Add Wowza Media Server Applications and Setup

Windows

Copy from folder restream_2.0/apps/wowza/* to the installation folder of Wowza Media Server 2. The folder should be on the location 'C:\Program Files\Wowza Media Systems\Wowza Media Server 2.1.2'.

Now edit the file 'C:\Program Files\Wowza Media Systems\Wowza Media Server 2.1.2\conf\aliasmap.dreambox.play.txt'. Make sure that the following line is the only line in the file:
*=http://:/restream.sdp?channel=${Stream.Name.Part1}

Start Wowza from the Windows menu.

Mac OS X

Copy from folder restream_2.0/apps/wowza/* to the installation folder of Wowza Media Server 2. The folder should be on the location '/Library/WowzaMediaServer'. Make sure that you don't replace the existing folders. Because that will delete other files that are needed with Wowza Media Server 2.

Now edit the file '/Library/WowzaMediaServer/conf/aliasmap.dreambox.play.txt'. Make sure that the following line is the only line in the file:
*=http://:/restream.sdp?channel=${Stream.Name.Part1}

Start Wowza Media Server 2 by double clicking on the Start Wowza icon in the Wowza folder in the application folder.

Linux

Copy from folder restream_2.0/apps/wowza/* to the installation folder of Wowza Media Server 2. The folder should be on the location '/usr/local/WowzaMediaServer/'.

Now edit the file '/user/local/WowzaMediaServer/conf/aliasmap.dreambox.play.txt'. Make sure that the following line is the only line in the file:
*=http://:/restream.sdp?channel=${Stream.Name.Part1}

Restart Wowza Media Server 2 with the command: sudo /etc/init.d/WowzaMediaServer restart.

7. Edit the ReStream 2.0 Settings.class.php

Windows

Edit the file 'C:\wamp\www\restream_2.0\Settings.class.php' and set the following variables:

private static $dreamboxIP = "";
private static $dreamboxUserName = "";
private static $dreamboxPassword = "";
private static $dreamboxEnigmaVersion = "";
private static $vlcLanStreamPort = "";
private static $vlcIP = "";
private static $wowzaServerName = "";
private static $lVLCLocationMacOSX = "";

Other variables are optional

Mac OS X

Edit the file 'Applications/MAMP/htdocs/restream_2.0/Settings.class.php' and set the following variables:

private static $dreamboxIP = "";
private static $dreamboxUserName = "";
private static $dreamboxPassword = "";
private static $dreamboxEnigmaVersion = "";
private static $vlcLanStreamPort = "";
private static $vlcIP = "";
private static $wowzaServerName = "";
private static $lVLCLocationMacOSX = "";

Other variables are optional

Linux

Edit the file '/var/www/restream_2.0/Settings.class.php' and set the following variables:

private static $dreamboxIP = "";
private static $dreamboxUserName = "";
private static $dreamboxPassword = "";
private static $dreamboxEnigmaVersion = "";
private static $vlcLanStreamPort = "";
private static $vlcIP = "";
private static $wowzaServerName = "";
private static $lVLCLocationMacOSX = "";

Other variables are optional

8. Happy Restreaming! :D

Windows
Click here to start Restreaming. http://:/
Mac OS X
Click here to start Restreaming. http://:/
Linux
Click here to start Restreaming. http://:/