This document outlines the creation of a Red5 Virtual Appliance on Jeos using VMWare Workstation 6.5.

Please Refer to this article Building a Virtual Appliance with Jeos for details on Virtual Appliance Creation and Jeos installation, and deployment.

This virtual appliance can be downloaded here.

Enter the following commands to install prerequisite packages:

sudo apt-get install subversion
sudo apt-get install java-package
sudo apt-get install sun-java6-jdk
sudo apt-get install ant

Enter the following to install openssh

sudo apt-get install openssh-server

Enter the following to create a temporary red5 directory and navigate to it

mkdir red5
cd red5

Enter the following command to download red5 source code from googlecode

svn checkout http://red5.googlecode.com/svn/java/server/trunk/ red5-read-only

Enter the following commands to set your environment variables

export JAVA_HOME=/usr/lib/jvm/java-6-sun
export ANT_HOME=/usr/share/ant/

Change directories to the red5-read-only directory and enter the ant command to compile the code

cd red5-read-only
/usr/share/ant/bin/ant

After the code is compiled create a permanent directory for the red5 installation

sudo mkdir /usr/share/red5

The code was compiled to the dist directory. Change directories to dist

cd dist

Enter the following to copy all of the compiled files to the permenant installation directory

sudo cp -R * /usr/share/red5

Make the red5.sh startup script executable

sudo chmod 777 /usr/share/red5/red5.sh

Test red5 installation by entering the following

/usr/share/red5/red5.sh &

Open your browser and goto http://IPADDRESS:5080

Next we will install a startup script so that the red5 server will start automatically when the system boots. Create a file named red5 in the /etc/init.d directory

sudo vi /etc/init.d/red5

Enter the following code

#! /bin/sh
#
# red5 red5 initscript
#
# Author: Simon Eisenmann .
#

set -e

PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
DESC=”Red5 flash streaming server”
NAME=red5
RED5_HOME=/usr/share/red5
DAEMON=$RED5_HOME/$NAME.sh
PIDFILE=/var/run/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME

# Gracefully exit if the package has been removed.
test -x $DAEMON || exit 0

# Read config file if it is present.
if [ -r /etc/default/$NAME ]
then
. /etc/default/$NAME
fi

#
# Function that starts the daemon/service.
#
d_start() {
start-stop-daemon –start –pidfile $PIDFILE \
–chdir $RED5_HOME –background –make-pidfile \
–exec $DAEMON
}

#
# Function that stops the daemon/service.
#
d_stop() {
start-stop-daemon –stop –quiet –pidfile $PIDFILE \
–name java
rm -f $PIDFILE
}

case “$1″ in
start)
echo -n “Starting $DESC: $NAME”
d_start
echo “.”
;;
stop)
echo -n “Stopping $DESC: $NAME”
d_stop
echo “.”
;;
restart|force-reload)
echo -n “Restarting $DESC: $NAME”
d_stop
sleep 1
d_start
echo “.”
;;
*)
echo “Usage: $SCRIPTNAME {start|stop|restart|force-reload}” >&2
exit 1
;;
esac

exit 0

Enter the following to make file executable

sudo chmod 777 /etc/init.d/red5

Enter the following to activate startup script

sudo update-rc.d red5 defaults

At this point all that is left is cleanup and packaging. Please refer to:
Please Refer to this article Building a Virtual Appliance with Jeos for details.

For installation see of this virtual appliance see Installing Red5 Virtual Appliance

If you have questions or problems with this build please leave a comment below.

We are starting with a fresh Ubuntu 9.04 install (using ubuntu-9.04-server-amd64.iso). The only software selected during installation was OpenSSH Server.

After installation, assign a static IP address and log in remotely with putty (see Ubuntu Setting Static IP Address).

Execute the following command to update apt packages:

sudo apt-get update

Install Subversion so you can download code from google code:

sudo apt-get install subversion

Press Y for yes

Repeat to install java package:

sudo apt-get install java-package

Repeat to install java jdk:

sudo apt-get install sun-java6-jdk

When the Sun License Agreement page comes up, use the right arrow key to select OK and press Enter to continue

Press the Left Arrow and select Yes to agree

Repeat to install ant

sudo apt-get install ant

Next we will download Red5 source code from googlecode. Create a temporary directory to download the code

mkdir -p ~/svn/red5

Change directories to go to the red5 code directory

cd ~/svn/red5

Now execute the following command to download the code:

svn checkout http://red5.googlecode.com/svn/java/server/trunk/ red5-read-only

Execute the following two commands to set environment variables in order to compile the code:

export JAVA_HOME=/usr/lib/jvm/java-6-sun

export ANT_HOME=/usr/share/ant/

Change directories to the red5-read-only directory:

cd ~/svn/red5/red5-read-only

Execute the ant command to compile the code:

/usr/share/ant/bin/ant

The source code will be compiled into the dist directory. This will take a couple minutes.

Next, we will create a permanent directory where the final red5 installation will go:

sudo mkdir /usr/share/red5

Change directories to the dist directory:

cd ~/svn/red5/red5-read-only/dist

Copy all of the files to the new red5 directory:

sudo cp -R * /usr/share/red5/

Change directories to the new red5 directory and change permissions on the red5 startup script to allow it to be executed:

cd /usr/share/red5

sudo chmod 755 red5.sh

Execute the following command to start the red5 server:

/usr/share/red5/red5.sh &

After server starts up, you can access the web console by entering the following URL in your browser:

http://IPADDRESS:5080

If this screen comes up your installation was a success. Follow the instructions thru the web console to install and test out the demos.

If you have questions or problems with this build please leave a comment below.

The Red5 server is an excellent open source solution for streaming video and other types of flash media. It is a free alternative to using Adobe Flash Media Server.

For more information and to download the installer visit the Google Code project page at http://code.google.com/p/red5/. In this build we will use the Red5 0.8.0 for Windows.

If not already installed, download the latest version of Java 6 for Windows 2003 from sun.com.

After download completes, execute Java installer. Click Install.

Java will install in a few minutes. Press finish.

Next run the Red5 installer. Press Next.

Click I Agree

Choose installation directory for the Red5 server. In this build we use Z:\Program Files\Red5

Choose Start Menu Folder

Installer runs for a few minutes. Press Next when complete.

Press Finish.

Reboot server to make sure new environment variables take effect.

To make sure that Red5 server is running, goto Start -> Administrative Tools -> Services

Check for the Red5 service and make sure it is set to Automatic and running

Now it’s time to test the server. Open the browser on the server and goto http://localhost:5080

If the above page comes up, your installation was a success.

If you have problems or questions with this build please leave a comment below.