DivertServlet Installation (Tomcat on Linux)

Overview
Product Tour
Download
Installation
Registration
FAQs
Email

1. Install Tomcat from jakarta.apache.org

Download jakarta-tomcat-3.2.tar.gz (or latest release) from jakarta.apache.org. Expand the downloaded tar file into /usr/local directory.

mv jakarta-tomcat-3.2.tar.gz /usr/local
cd /usr/local
/usr/local # tar xzvf /jakarta-tomcat-3.2.tar.gz

2. Install jdk-1_2_2_006-linux-i386_tar.gz (or latest release) from java.sun.com

mv jdk-1_2_2_006-linux-i386_tar.gz /usr/local
cd /usr/local
/usr/local # tar -xzvf jdk-1_2_2_006-linux-i386_tar.gz

You can choose to install JRE instead.

3. Edit .bash_profile (of the unix user who is going start Tomcat)

JAVA_HOME=/usr/local/jdk1.2.2
PATH=$JAVA_HOME/bin:$PATH
export TOMCAT_HOME=/usr/local/jakarta-tomcat-3.2/
export CLASSPATH=$TOMCAT_HOME/webapps/divert/servlets/divert.jar:$CLASSPATH
export LD_LIBRARY_PATH=TOMCAT_HOME/bin:$LD_LIBRARY_PATH

If you have install newer version of jdk, replace 'jdk1.2.2' in JAVA_HOME accordingly.
If you have install newer version of Tomcat, replace 'jakarta-tomcat-3.2' in TOMCAT_HOME accordingly.

Create a new terminal session (reboot if you have to). Reboot might be necessary to ensure environment variables in .bash_profile
is effective.

[root@web /root]# echo $PATH
/usr/local/jdk1.2.2/bin:.....
[root@web /root]# echo $TOMCAT_HOME
/usr/local/jakarta-tomcat-3.2
[root@web /root]# echo $CLASSPATH
/usr/local/jakarta-tomcat-3.2/webapps/divert/servlets/divert.jar:......
[root@web /root]# echo LD_LIBRARY_PATH
/usr/local/jakarta-tomcat-3.2/bin:.....

Echo the environment variables entered in .bash_profile to make sure they are set. If they are not set, you need to enter them on the command line before proceeding to next step.

4. Expand divert-1.1.tar.gz and deploy the files to Tomcat

tar -xzvf divert-1.1.tar.gz
./tomcat.sh

5. Ftp Server

FTP server is use to validate divert users.
If you prefer to have your own user validation, please follow the link here.
Divert users logon are passed to FTP server for verification. Edit Validate.properties to enter the port number if your FTP server is not using port 21.

[root@web /root]# ftp localhost

Try to logon to a user to make sure FTP server is OK.
Make sure your FTP server is up before you proceed.

6. Start up TomCat.

[root@web /root]# cd $TOMCAT_HOME/bin
[root@web bin]# ./startup.sh

6. Setup browsers

Proceed to set up your browsers to complete the installation