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.

The installation assumes that you have a working web server where this software package is installed on.

All software should be installed on the same server to keep it a simple setup. That means that the web server should also have VLC and Wowza Media Server 2 (optional) installed.

Dreambox settings:





option settings:

Select your operating system:

Install VLC on the server:

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 successfully installed by opening a console and start cvlc. Do this with a normal user. Root user is not allowed to start VLC. This will show some information like:
'VLC media player 1.0.6 Goldeneye' and 'dummy interface: using the dummy interface module...' 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. Download VLC and run it. Use the installation defaults.

VLC Settings:
Use an internal IP number for VLC. VLC should not be accessible for the outside world.
The port number should be a number that is higher than 1024. The default value should be good enough. (Yes it uses 8668 as default)


Use Wowza Media 2 Server:

Install Java on the server:

Download Java JDK and select your download for your Linux distribution. Or you can use your repositories to install Java. On Ubuntu you need to enable the parter repository. After installing you can verify if Java is installed by running the command 'java -version'. This should give some information about the installed java environment. Download Java JDK and install it. ...... No more info Download Java JDK and install it. ...... No more info
OpenJDK is also possible but not tested.

Install Wowza Media Server 2 on the server:

Download Install Wowza Media Server 2 and select your download for your Linux distribution. Install Wowza Media Server 2 by making the download file executable and execute the download file. Instructions are below the download link. During installation just use the default values. After that you have to download a developer license. You can do that on the same page. Install the license and restart Wowza Media Server 2. You can check if the service is running by entering in the browser: http://[SERVERIP]:1935. You should get a page with the Wowza Media Server 2 server number and build number. Download Install Wowza Media Server 2. 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 that you have to download a developer license. 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. Download Install Wowza Media Server 2 Double click the download file and follow the installation. After that you have to download a developer license. 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.
You can here also use the ip address or hostname of the server that is running Wowza. This can be an internal or external IP address. Use external only if you want to watch TV over the internet without port forwarding. The server needs a direct connection to the internet.

Setup Wowza Media Server 2 on the server:

In the folder apps/wowza you have multiple folders. Copy the content of folder conf to the Wowza Media Server 2 conf folder at /usr/local/WowzaMediaServer/conf/. Create the folder 'dreambox' in the Wowza Media Server 2 application folder at /usr/local/WowzaMediaServer/applications. This needs to be done as root user.
Edit the file dreambox/Application.xml and add between the tags <StorageDir> </StorageDir> the full path to your web folder of restream. Something like /var/www/restream_2.0/apps/wowza/content.
Now restart Wowza Media Server 2 as root user. Check if the server is still working at http://[SERVERIP]:1935 In the folder apps/wowza you have multiple folders. Copy the content of folder conf to the Wowza Media Server 2 conf folder at /Library/WowzaMediaServer/conf/. Create the folder 'dreambox' in the Wowza Media Server 2 application folder at /Library/WowzaMediaServer/applications.
Edit the file dreambox/Application.xml and add between the tags <StorageDir> </StorageDir> the full path to your web folder of restream. Something like [RESTREAM_2.0 LOCATION]/apps/wowza/content.
Now restart Wowza Media Server 2. Check if the server is still working at http://[SERVERIP]:1935 In the folder apps/wowza you have multiple folders. Copy the content of folder conf to the Wowza Media Server 2 conf folder at C:\Program Files\Wowza Media Systems\Wowza Media Server 2.X.Y\conf\. Create the folder 'dreambox' in the Wowza Media Server 2 application folder at C:\Program Files\Wowza Media Systems\Wowza Media Server 2.X.Y\applications.
Edit the file dreambox/Application.xml and add between the tags <StorageDir> </StorageDir> the full path to your web folder of restream. Something like [RESTREAM_2.0 LOCATION]/apps/wowza/content.
Now restart Wowza Media Server 2. Check if the server is still working at http://[SERVERIP]:1935

Dreambox ReStream setup summary:

Make sure that the web server has write rights on the folder 'apps/wowza/content'

Copy the file 'restream_2.0\Settings.sample.class.php' to 'restream_2.0\Settings.class.php' and set the following variables:

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

Other variables are optional