Update: These instructions work for latest SVN red5 tags that build with ANT.
Updated for Red5 1.0 RC3 +
Updated for OpenJDK 1.6.0_24 (32bit/64bit).
Updated for ANT 1.9.4 .
Here is how we installed latest Red5 and JDK on a server with Linux CentOS . These hints can help you install on many linux VPS or Dedicated enviroments.
You will need root access to deploy new software on the server. On some dedicated/vps configuration providers only give a regular account that you can use to access root indirectly with su root. Process is more complicated as you have write access with first account only on your home: you need to exchange any files with a tool like WinSCP using that location.
We use WinSCP and PuTTy on Windows and muCommander & Terminal on MacOS.
First, know your server (linux distribution and processor type ie. x86_64):
cat /etc/*release*
uname -a
Then, make sure there are all prerequisites to install the rpm:
yum install rpm-build redhat-rpm-config
Allow required ports (not necessary if already opened): 3690 (svn), 5080, 1935, 1936, 8088. See more details at the end of this tutorial.
JAVA INSTALLATION
Easiest java to install is with:
yum install java-1.6.0-openjdk*
export JAVA_HOME=/usr/lib/jvm/jre
Or install latest JDK from http://www.oracle.com/technetwork/java/javase/downloads/index.html .
You can install latest Java6 JDK (scroll down) or latest (top) depending on applications you plan to use.
Use uname -a to see if you need to download a 64 bits version.
Went to root/tmp folder for downloads:
cd /root/tmp
We got Java SE Development Kit, JDK 6 Update 31. We selected linux multilanguage, right clicked > properties on the jdk-6u31-linux-i586-rpm.bin and downloaded it with wget urlon the server. It downloaded with a big name with parameters (ls to see after download). We use WinSCP so we right clicked, refreshed from there and then renamed the new file that showed up in the root home directory.
You can also rename it from shell. Make sure you use mv “old_long_name” new_name for the long name as it uses special characters.
Make sure you install JDK and not JRE.
wget http://download.oracle.com/otn-pub/java/jdk/6u31-b04/jdk-6u31-linux-x64-rpm.bin
Made it executable and executed it:
chmod a+x jdk-6u31-linux-i586-rpm.bin
./jdk-6u31-linux-i586-rpm.bin
If it’s just .rpm install it with rpm -Uhv file :
rpm -Uhv jdk-7-linux-x64.rpm
Press space or enter to scroll terms and when it asks you type yes and hit enter.
If needed confirm Java DB update, yes ENTER.
We installed it on multiple servers and had to change some shortcuts on ones that already had an older java, so it runs the new one. Usually if preinstalled it’s located in a java or jdk folder in /usr or /usr/local .
Make sure the shortcuts in /usr/local point to the new locations (/usr/local/jdk to /usr/java/jdk1.6.0_14 and /usr/local/jre to /usr/java/jdk1.6.0_14/jre) .
ln -s /usr/java/latest /usr/local/jdk
ln -s /usr/java/latest/jre /usr/local/jre
Also /usr/bin/java shortcut should point to /usr/java/latest (not /etc/alternatives/java):
rm /usr/bin/java
ln -s /usr/java/latest/bin/java /usr/bin/java
export JAVA_HOME=/usr/java/latest/
Make sure this is the one used if you also have older versions installed:
java –version
ANT INSTALLATION
Downloaded ant (can be done from any mirror – see http://ant.apache.org/bindownload.cgi), unpacked it, moved it to a good location and added variable, shortcut.
Get ANT
wget http://www.eu.apache.org/dist//ant/binaries/apache-ant-1.9.4-bin.tar.gz
tar zxvf apache-ant-1.9.4-bin.tar.gz
mv apache-ant-1.9.4 /usr/local/ant
If older ANT is preferred get one from http://archive.apache.org/dist/ant/binaries/ .
i.e. ANT 1.7.1
wget http://www.apache.org/dist/ant/binaries/apache-ant-1.7.1-bin.tar.gz
tar zxvf apache-ant-1.7.1-bin.tar.gz
mv apache-ant-1.7.1 /usr/local/ant
Configure
export ANT_HOME=/usr/local/ant
ln -s /usr/local/ant/bin/ant /usr/local/bin/ant
Replace old ant
rm /usr/bin/ant
ln -s /usr/local/ant/bin/ant /usr/bin/ant
Checked ant version:
ant –version
If this can’t find java, make sure you run:
export JAVA_HOME=/usr/lib/jvm/jre
Error: JAVA_HOME is not defined correctly.
We cannot execute /usr/local/jdk/bin/java
SUBVERSION INSTALLATION
yum install subversion
If that doesn’t work because of something like Missing Dependency: perl(URI) >= 1.17 is needed by package subversion … maybe this can help:
Fix: Install perl uri:
wget http://mirror.centos.org/centos/5/os/i386/CentOS/perl-URI-1.35-3.noarch.rpm
rpm -Uvh perl-URI-1.35-3.noarch.rpm
Fix: This time got “Error: Cannot retrieve repository metadata (repomd.xml) for repository: atrpms. Please verify its path and try again” .
Solution: yum –disablerepo=atrpms install subversion .
RED5 BUILD AND INSTALLATION
Then we downloaded Red5:
svn co http://red5.googlecode.com/svn/java/server/trunk red5
If latest trunk has bugs or does not work fine with your required software you can download other versions from http://red5.googlecode.com/svn/java/server/tags/ .
Example:
svn co http://red5.googlecode.com/svn/java/server/tags/1_0_2_RC1/ red5
svn co http://red5.googlecode.com/svn/java/server/tags/1_0/ red5
svn co http://red5.googlecode.com/svn/java/server/tags/0_8_0/ red5
svn co http://red5.googlecode.com/svn/java/server/tags/0_9rc1/ red5
Built red5 :
cd red5
ant prepare
ant dist
You could also remove sample applications if you don’t plan to use these:
rm -rf /opt/red5/dist/webapps/live
rm -rf /opt/red5/dist/webapps/installer
rm -rf /opt/red5/dist/webapps/vod
rm -rf /opt/red5/dist/webapps/installer
rm -rf /opt/red5/dist/webapps/root/demos
rm -rf /opt/red5/dist/webapps/root/WEB-INF
When upgrading, copy webapps to new build:
cp -rf /opt/red5/dist/webapps/* /root/tmp/red5/dist/webapps/
Then rename old red5 (backup).
Move Red5 from home folder:
cd ..
mv red5 /opt/red5
Start Red5:
cd /opt/red5/dist
./red5.sh > start.log &
The > start.log is to have it output the logs in the file and & is to keep it running in the background.
Verified that Red5 is running:
ps aux | grep red5
This should report a long line with java and many options and this command. Check start.log if it failed to start.
Make sure these ports are active and red5 (java) is listening:
netstat -anp | grep 1935
netstat -anp | grep 5080
If 1935 shows up and 5080 doesn’t it probably means web server is not running. On latest versions Red5 no longer includes tomcat. See Red5 JEE Container Plugins for details.
You will need to overwrite conf/jee-container.xml with one extracted from plugin jar and create a plugins/ folder with multiple jars (get this from older red5 distributions).
START RED5 ON BOOT
The nice way would be to run Red5 as a service by adding a red5 file with execution permissions to /etc/rc.d/init.d :
#!/bin/bash
#
#
# chkconfig: 2345 85 85
# description: Red5 flash streaming server
# processname: red5
#
PROG=red5
RED5_HOME=/opt/red5/dist
DAEMON=$RED5_HOME/$PROG.sh
PIDFILE=/var/run/$PROG.pid
# Source function library
. /etc/rc.d/init.d/functions
[ -r /etc/sysconfig/red5 ] && . /etc/sysconfig/red5
RETVAL=0
case “$1” in
start)
echo -n $”Starting $PROG: “
cd $RED5_HOME
$DAEMON >/dev/null 2>/dev/null &
RETVAL=$?
if [ $RETVAL -eq 0 ]; then
echo $! > $PIDFILE
touch /var/lock/subsys/$PROG
fi
[ $RETVAL -eq 0 ] && success $”$PROG startup” || failure $”$PROG startup”
echo
;;
stop)
echo -n $”Shutting down $PROG: “
killproc -p $PIDFILE
RETVAL=$?
echo
[ $RETVAL -eq 0 ] && rm -f /var/lock/subsys/$PROG
;;
restart)
$0 stop
$0 start
;;
status)
status $PROG -p $PIDFILE
RETVAL=$?
;;
*)
echo $”Usage: $0 {start|stop|restart|status}”
RETVAL=1
esac
exit $RETVAL
Then you can use service red5 start|stop|restart .
Or add these lines to to /etc/rc.d/rc.local so it starts on each server start:
cd /opt/red5/dist
/opt/red5/dist/red5.sh > restart.log &
Make sure your run it from the right folder. The one in /opt/red5 will not work – you must run it from /opt/red5/dist/ .
When Red5 is running you should be able to access http://your-server-domain-or-ip:5080/ .
If it works first thing go to http://your-server:5080/installer/and install admin. Then to http://your-server:5080/admin/register.html and register an username and password. Then you can check application statistics anytime from http://your-server:5080/admin/ with server ip and the registered username, password.
RED 5 RESTART
Restart Red5 anytime you update files in the /opt/red5/dist/webapps folder – where all applications should be installed.
Usually these should work and should be used each time you add a new application.
1. Check if red5 is running:
ps aux | grep red5
2. Go to its folder and shut red5 down:
service red5 stop
or
cd /opt/red5/dist
./red5-shutdown.sh
3. See if it’s still running or not:
ps aux | grep red5
4. Restart it, and also make it output the logs into a file of your choice:
service red5 start
or
./red5.sh > start.log &
5. Make sure it’s back online:
ps aux | grep red5
We also noticed that red-shutdown.sh sometimes does not close it down to allow restart when webapps are added or updated. This usually occurs when red5 freezes becasue it encounters errors like running out of memory. So we run ps aux | grep red5 to see process id (first number: PID) and then run kill process id if it’s still alive.
ALLOWING PORTS
On some systems root cannot bind ports above the early 1000’s so red5 must be run from another account.
Verify that Red5 is listening on port 5080 if you can’t get http://yourserver:5080/:
netstat -anp | grep 5080
If using iptables enable these ports:
iptables -A INPUT -p tcp -m tcp -—dport 3690 -j ACCEPT
iptables -A INPUT -p tcp -m tcp —-dport 5080 -j ACCEPT
iptables -A INPUT -p tcp -m tcp -—dport 1935 -j ACCEPT
iptables -A INPUT -p tcp -m tcp —-dport 1936 -j ACCEPT
iptables -A INPUT -p tcp -m tcp -—dport 8088 -j ACCEPT
Sometimes ports need to be configured in a hardware firewall. Contact server provider / administrator for more details about enabling ports.
This info provided by a host could also be helpful.
Please be advised that custom iptables rules should be placed in the directory listed below.
/etc/sysconfig/iptables-custom
The software firewall rule is listed as follows:
# cat /etc/sysconfig/iptables-custom/99Red5 *filter
-A INPUT -p tcp -m tcp –dport 1935 -j ACCEPT
-A INPUT -p tcp -m tcp –dport 1936 -j ACCEPT
-A INPUT -p tcp -m tcp –dport 5080 -j ACCEPT
-A INPUT -p tcp -m tcp –dport 8088 -j ACCEPT
COMMIT
RED5 & VIDEOWHISPER
This was done for the installation of VideoWhisper applications. To do that just download the latest videowhisper rtmp application, unzip it on your computer and copy the videowhisper folder and all its contents to/opt/red5/dist/webapps . As verification, check that you have a /opt/red5/dist/webapps/videowhisper/WEB-INF/ folder on your server. After copying/updating this, restart the Red5 server (as explained above) and you can install the videowhisper video conferencing / live streaming scrips to use the new rtmp application.
The Red5 VideoWhisper RTMP Application has some cool settings, like enabling access with external players / archiving of all video streams as flv files / limiting access to certain domains / setting absolute paths for live streams and recordings to be able to share videos with other applications (i.e. video sharing). Edit all these in WEB-INF/red5-web.properties and restart the Red5 server.
If we forgot to mention something here, or you have any questions about this submit your inquiries on Video Whisper Contact Page or comment below.
An alternative to doing the red5 installation yourself would be to order red5 installation .
If you don’t have the time and experience to run your own server or vps, you should use managed red5 hosting .
cp -rf /opt/red5/dist/webapps/* /root/tmp/red5/dist/webapps/
