Set Up

Setting up JAMS is not entirely straightforward, although easier than configuring a sendmail.cf file!

Pre-requisites

Before you will need to download the following resources:-

Instant DB is a zip file. Unpack the files into your top level directory. COBRA and JAMS are .jar files, JAMS should be unpacked into your top level directory, COBRA does not need to be unpacked.

Instant DB

JAMS uses the Instant DB database for storing user account details and email messages. Instant DB is a pure Java RDBMS. Before JAMS can be used:

download Instant DB
execute runsql in the uk/co/kimble/jams directory to set up the database schema. The schema is stored in the file jams.sql
Note: you will need to edit this file to include the IDB package in the CLASSPATH, for example:

CLASSPATH="$CLASSPATH:$HOME/src/Classes/IDB.JAR:$HOME/src/Classes/IDBEXMPL.JAR"

On a Unix system, where $HOME/src is the top level directory.,
include Instant DB in your CLASSPATH

dnsjava

Brian Wellington's DNS resolver is used for looking up mail exchanger (mx) records. Download and build this package and include it in your classpath. If you are using make edit the file called jams.make to set the classpath for your system.

COBRA

Instant DB is accessed through the COBRA object persistence layer. This saves writing any SQL and provides a persistence mechanism for JAMS objects. COBRA can be downloaded from this site, the .jar file will need to be set in your CLASSPATH.

Unpacking JAMS

After you've downloaded the JAMS jar file you will need to unpack it:

$ jar -xvf jams-version.jar

Jams.ini

Set the IP address of your DNS server and optionally the port number used by JAMS (usually port 25 for SMTP)

Building JAMS source

Go to the uk/co/kimble/jams directory. Edit jams.make then type make.

Running JAMS

Either type make run from the uk/co/kimble/jams directory or from the top level directory:-

$ java -classpath "$HOME/src/Classes/IDB.JAR:$HOME/src/cobra-1.0.3.jar:$HOME/src:$HOME/src/dnsjava/" uk.co.kimble.jams.Jams uk/co/kimble/jams/jams.ini

Remember that on Unix boxes you will not be able to bind to the SMTP well known port (port number 25) unless you are root. You will not be able to bind to this port if you have another mail server running. You can set an alternative bind port in jams.ini.