The odyssey of JWChat

This document serves to describe the steps to set up JWChat (a web based Jabber client),
using the JabberHTTPBind servlet by the same author.
This document might be redundant, but I hope it will help new or unexperienced webmasters to
get JWChat running. I will try to include the links to referenced documents whenever
possible.

Note: I used Apache version 2.0.50, mod_jk 1.2.14, Tomcat 5.5.9,
jabberd 1.4.2, JWChat 1.0beta2 and JabberHTTPBind 0.3. For other configurations,
you will have to improvise (and use the search engines often).

Note: I wasn't able to get Erlang (necessary for ejabberd) running on
Windows 2003. I would encourage you to take a look at it though, as it seems
quite good.

Note: You best stop Apache, Tomcat and JabberD before changing
confguration files.

Set up Apache

If needed, download and install Apache. Make sure you know where you put your
website files (also called WebRoot).

Rename the mod_jk file you downloaded to "mod_jk.so" and copy it into the
directory Apache-Dir\modules.

Set up Tomcat

Download and install the JRE.

Download and install Tomcat. Either keep the default port (8080) or change it
to something Ok for you.
Test your Tomcat installation by trying to access it through
http://localhost:your-port. You should get Tomcat's welcome page
with access to the manager and other useful things.

Set up Jabberd

Download and install.

You will need a text editor that can save files in UNIX format!

Edit Jabberd-Dir\jabber.xml and replace all
occurances of localhost with the name you choose for your jabber server,
for example jabber.myserver.com.

If you want your jabber server to only work internally (like in an intranet),
comment out the following sections:

Rename the file Tomcat-Dir\jk2.properties to
jk2.properties.orig. Copy the following jk2.properties file into the
Tomcat-Dir\conf directory:

## THIS FILE MAY BE OVERRIDEN AT RUNTIME. MAKE SURE TOMCAT IS STOPED
## WHEN YOU EDIT THE FILE.
## COMMENTS WILL BE _LOST_
## DOCUMENTATION OF THE FORMAT IN JkMain javadoc.
# Override the default port for the socketChannel
# channelSocket.port=8019
# Default:
# channelUnix.file=${jkHome}/work/jk2.socket
# Just to check if the the config is working
shm.file=Apache-Dir/logs/jk.shm
# In order to enable jni use any channelJni directive
channelJni.disabled = 0
# And one of the following directives:
# apr.jniModeSo=/opt/apache2/modules/mod_jk2.so
# If set to inprocess the mod_jk2 will Register natives itself
# This will enable the starting of the Tomcat from mod_jk2
apr.jniModeSo=inprocess