2.3.1. RealChat Server: Installing on UNIX/Linux platforms
586/200MHz with 64MB RAM or better. Dedicated PII/400MHz with 256MB RAM is enough to handle 400+ concurrent users.
RealChat Server for UNIX/Linux platforms requires Java Runtime Environment in order to run. Supported Java versions are JRE 1.1 and newer, however we strongly recommend using version 1.3 or newer. If you haven't already done so, please download and install one before you continue.
JRE for Linux is freely available from SUN: http://java.sun.com/jre/.
A list of Java ports for various platforms is available here.
It is recommended to install Java to a common location such as /usr/local/java/
, /home/username/java/
or in the same location as RealChat Server itself so it can be found by the configuration script.
In order to install and run RealChat Server you need to have ability ( permissions ) to run background processes ( daemons ) on the server machine. If unsure ask your hosting provider.
RealChat Server for for UNIX/Linux platforms comes packaged as single rcserverXXX.tar.gz
archive, located in the /server
folder of the distribution archive. Extract the archive to a location of your choice (e.g. /usr/local/rcserver/
or /home/username/rcserver/
). Enter that directory and run the RealChat Server configuration script:
./configure
This script will try to locate your Java Interpreter, look for a suitable chat server port, install cron jobs if needed, and setup the basic configuration files and 'realchat' start/stop utility.
If the script fails to start, please refer to the Troubleshooting section below.
Important Note: If you change the default server port, you *must* also change the PORT
parameter in the HTML page of the chat client.
Important Note: Never install RealChat Server files to a publicly available location such as /public_html
or /cgi-bin
directories!
After you installed RealChat Server, you can control it ( start, stop and restart ) through the 'realchat' start/stop utility:
./realchat
RealChat Server features built-in HTTP Control Server which you can use to get various statistics, as well as to access the server API. To open the Web Console point your browser to http://localhost:10010/
. User name: 'root', password: 'root'. If you happen to change the HttpControlPort
parameter in the server configiration file you should replace the default value of 10010 with the one you chose.
Note: By default, RealChat Server will only allow requests which come from localhost. See the TrustedIP
and AllowExternal
configuration directives for details.
After successfull installation it is recommended to setup RealChat Server to be started at system startup. To do so enter the directory you installed RealChat Server in and type:
cp ./realchat /etc/init.d/
update-rc.d realchat defaults
Note: You need root privileges to do this.
Solution: You need to make the configure
script executable:
chmod a+x ./configure
Solution: Edit the configure
script with a text editor; look for the first line which says:
#!/bin/sh
and change it to:
#!/bin/bash
or whatever shell you are using. You should also do the same with the realchat
script.
Contents |
Parent Topic |
Previous Topic |
Next Topic