Chat Essentials Home

Chat Essentials Forum
 

Home Online Manual Installation Guide for Linux Installation

Installing Java

First make sure that you have Java on your machine. You must have at least JRE1.1 or JDK1.1 but new versions is preferred. For ensuring that you have Java or not, type "java" in your command shell and press enter. If Java is installed on your machine the Java virtual machine will execute and something will appear on your command shell. After this, search for JDK or JRE in following directories :

- /usr/java

- /usr/local/java

- /usr/jre

- /usr/local/jre

If you can not find Java then you must download it from "java.sun.com". Usually you can find it with a URL like this :

http://java.sun.com/products/jre/1.4/download.html

and find installation help in :

http://java.sun.com/j2se/1.4/jre/install-linux.html

There after we suppose that you have installed java in /usr/java and you have a directory like :

/usr/java/jre1.4.0

We will refer to this directory as JAVA_HOME later.

 

Installing GlassRoom

Download glassroom.tar.gz and copy in to "/usr" . Then execute the following commands :

cd /usr

tar -xzf glassroom.tar.gz

Installing client and server files

Once you have done that, a directory will be created : /usr/glassroom. Copy contents of /usr/glassroom/client subdirectory into your web server's root directory. For example if your root web directory is /var/www/html you can use the following command :

 

mkdir /var/www/html/glassroom

cp -R /usr/glassroom/client/* /var/www/html/glassroom/

Now you can remove client files or leave them as a back up.

Editing serial no. file

GlassRoom server expects a file in GlassRoom home directory named "serialno". It's a text file containing your serial number. To build this file use a text editor like Joe :

joe /usr/glassroom/serialno

then write your complete serial code in the FIRST line of text and save this file. Please don't use any white spaces in serial code.

Configuring server files

In this step you must edit one script file : /usr/glassroom/bin/glassroom.sh . You can do that by VI or Joe or any text editor you have. For example use this command :

 

joe /usr/glassroom/bin/glassroom.sh

now edit these lines of text :

 

# GlassRoom(R) chat starter script

#

 

JAVA_HOME=/usr/java/jdk1.3.1_02

export JAVA_HOME

 

GLASSROOM_HOME=/usr/glassroom

export GLASSROOM_HOME

 

GLASSROOM_WEB_DIR=/var/www/html/glassroom

export GLASSROOM_WEB_DIR

 

port=8100

 

# Usage :

#

This script considers "/usr/java/jdk1.3.1_02" as your Java home directory. You must correct it. For example if you have installed Java in /usr/java/jre1.4.0 then you must edit this line of above text :

JAVA_HOME=/usr/java/jdk1.3.1_02

into :

JAVA_HOME=/usr/java/jre1.4.0

If you installed Glassroom files in a directory other than /usr/glassroom, you must edit this line too :

GLASSROOM_HOME=/usr/glassroom

You must specify Glassroom's web directory  ( location of applet and HTML files) in the next section:

GLASSROOM_HOME=/var/www/html/glassroom

Glassroom needs this location to use a temporary folder for file transfer files between users.

In this file you can change your chat server's port. It's default value is 8100. We recommend you to do not change this but if you want to change default port then you will need to change chat applet port too.