Installation (Windows, Linux)

Installation guide (Windows standalone)

Simply download, unzip and execute the application RadicalChat - download is available on the page Radical-Flash-Chat. Before the application is started - please close all other programs which are using ports 1935 and 85.

Installation guide (Linux standalone)

This installation manual presume that Java, Apache (or lighttpd or any other http server) and PHP are already installed and successfully configured.
If you are just about to install Java - please see apendix I.

Step 1 - download RadicalChat for Windows (standalone package) and unzip it. Download is available on the page Radical-Flash-Chat.

Step 2 - create new web domain (or directory) on your linux server (in the example "www.mydomain.com") and copy the entire directory wwwPHP/SimplePresentation from windows os RadicalChat package using WinScp or other application. (See the image bellow).

Step 3 - edit the config.xml file. Update RTMPServerURL property - See the image bellow.

Step 4 - restart your http server. Check if domain www.mydomain.com is up and running. Especially check www.mydomain.com/service/service.php and PHP SOAP extension.

Step 5 - create an empty directory /home/streamserver. Copy the entire servers/wowza/ directory (RadicalChat windows package) to the /home/streamserver/. (See the image bellow Step 6).

Step 6 - copy the entire servers/radicalchatapps/ (RadicalChat windows package) to the /home/streamserver/.

Step 7 - edit /home/streamserver/wowza/conf/radicalchat/Application.xml and update value of ConfigDir. It is suppose to be /home/streamserver/radicalchatapps/

<Property>
<Name>ConfigDir</Name>
<Value>/home/streamserver/radicalchatapps/</Value>
</Property>

Step 8 - edit /home/streamserver/radicalchatapps/default.xml and update xml variables. Set RadicalWebServiceUrl - it should point to your service.php. Set Log property, eventually TextMessagesLog property. (See the image bellow).

Step 9 (optional, but it may speed up the application) - edit /etc/hosts and a line for "127.0.0.1 www.mydomain.com". (See the image bellow).

Step 10 - start Wowza stream server with Radical Flash Chat. Please use the following command to start RadicalFlashChat system on Linux.
Note: following lines represents one long command.

java -Xmx768M -Dcom.sun.management.jmxremote=true -Dcom.wowza.wms.AppHome="/home/streamserver/wowza" -Dcom.wowza.wms.ConfigURL="" -Dcom.wowza.wms.ConfigHome="/home/streamserver/wowza" -cp "/home/streamserver/wowza/bin/wms-bootstrap.jar" com.wowza.wms.bootstrap.Bootstrap start &

Do not forget to open ports 80 and 1935 in the Linux firewall.

iptables -I INPUT -p tcp --dport 80 -j ACCEPT
iptables -I INPUT -p tcp --dport 1935 -j ACCEPT

Now please open your web browser and try to login to the system - it should work.

Troubleshooting

Error message "Error Connection Lost" during start of the chat.:

You should check the configuration file step3 above - http://mirror2.cze.cz/radicalchat/installation4.jpg. If URL (or IP) and port is correct and you are sure that port 1935 (or whatever you use) is not blocked in the firewall (both on the client side "outgoing communication" and as well on the server side "incomming communication") then you are suppose to look into the log file to see what is the real reason of the connection rejection step5 - http://mirror2.cze.cz/radicalchat/installation5.jpg - tag <Log>.

Error in the stream server log "service.php cannot be found" or "connection timeout".

If the reason for rejecting connection is "service.php cannot be found" or "connection timeout" - that means stream server is not able to connect to the service.php. If you are running http server and stream server on the same server machine then the obvious solution is to edit file /etc/hosts file and add a line: "127.0.0.1 www.DomainWhereYouAreRunningTheServicePHP.com". After that you have to test directly in server's shell that the page service.php is available.

Installation guide (Windows, Linux as a service)

This installation manual presume that Java, Apache, PHP and Wowza media server are already installed and successfully configured.
If you are just about to install Java - please see apendix I.

The installation

First - copy the content of www directory - entire "service" folder (eventualy index.php, chat.php), ... somewhere to your HTTP server - for example to the root of your own domain (or subdomain) http://chat.mydomain.com/.

Second - copy the following files:

\servers\wowza\lib\axis.jar 
\servers\wowza\lib\commons-discovery-0.2.jar 
\servers\wowza\lib\commons-lang-2.4.jar 
\servers\wowza\lib\javax.wsdl_1.5.1.v200806030408.jar 
\servers\wowza\lib\jaxrpc.jar 
\servers\wowza\lib\jid3lib-0.5.4.jar 
\servers\wowza\lib\org.apache.commons.logging_1.0.4.v200904062259.jar 
\servers\wowza\lib\radicalchat.jar

from "RadicalFlashChat" \servers\wowza\lib directory to the "lib" directory of your Wowza (Red5) stream server the stream server can run on different physical machine that HTTP server.

Third - create an empty folder named "radicalchat" (access rights 777 - read write execute for operating system Linux) in the "application" folder of your Wowza stream server application directory. Perhaps c:\Program Files\Wowza\Wowza Media Server 2.1.1\Applications (Windows), /usr/local/WowzaMediaServerPro-2.1.1/Applications (Linux).

Fourth - copy \servers\stream.xml to the Wowza conf directory and update at least "RadicalWebServiceURL" property:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<streamServerConfiguration>
<!-- 
Following parameter specify where is Radical Web Service running.
-->  
<RadicalWebServiceURL>http://127.0.0.1:85/service/service.php</RadicalWebServiceURL> 
<!-- 
Absolute or relative path to the stream server log file.
If  parameter is empty, then logging will be disabled.
-->
<Log>.\wwwPHP\ChatFor4\service\logs\streamserverlog.txt</Log>
<!-- 
LogLevel. Available values are note, info, warn, error.
-->
<LogLevel>note</LogLevel>   
<!-- 
Absolute or relative path to the text messages log file.
If  parameter is empty, then logging will be disabled .-->  
<TextMessagesLog>.\wwwPHP\ChatFor4\service\logs\messages.txt</TextMessagesLog>
</streamServerConfiguration>

the property value should point to the service.php script for example http://chat.mydomain.com/service.php.

Fifth - copy paste folder \servers\wowza\conf\radicalchat\ to the conf directory of your wowza stream server and edit the only file in it Application.xml. Please edit following lines:

   <Properties>
       <Property>
           <Name>ConfigFile</Name>
           <Value>.\servers\stream.xml</Value>
       </Property>
   </Properties>

ConfigFile has to be the absolute path to the stream.xml file.

Now everything should work correctly and you can build your own online videoconference.

OPTIONAL:
If you want to improve security - please alter $BIND_ADDRESSES_REGEXP in www root\service\serviceconfiguration.php.

Apendix 1

Java Installation

The installation is very simmilar on Ubuntu, Debian or any other Linux distribution.

First you have to install and configure Java environment Java6-JRE:

Setup Repository

The apt-get command makes use of a source configuration file, which contains a list of the repositories the package manager should query to retrieve the correct package. The source configuration file is known as sources.list and is situated in the /etc/apt/sources.list location. The following command can be used to edit the source file to ensure the multiverse repository is included.

Code: sudo nano /etc/apt/sources.list

Note: in Debian do not use "sudo" command.

Ensure that the following lines are presented in the configuration file:

For Ubuntu:

deb http://za.archive.ubuntu.com/ubuntu/ intrepid main restricted
deb http://za.archive.ubuntu.com/ubuntu/ intrepid multiverse

For Debian:

deb http://ftp.debian.org/debian/ unstable main non-free

After the configuration file is updated, the package repository needs to updated with the following command:

Code: sudo apt-get update

To install Java version 6, the following command needs to be executed:

Code: sudo apt-get install sun-java6-jre

Verify the Java Installation (optional part)

To verify that the correct version of java is installed the following command can be used:

Code: java -version

 This command will print the current version of java that is active. Should there be more than one version of Java be installed on the operating system, the following command can be used to list the available java versions:

Code: update-java-alternatives -l

 This command list all the available Java runtime environments on the Ubuntu system. To change from one version to another, the following command can be used:

Code: sudo update-java-alternatives -s <JRE Version>

Now Java runtime environment is successfully installed.