Short Installation Instructions for Eremise

the following installation text covers the installation on an freebsd-5 system,
so it will differ from system to system but should be fairly easy to adopt.
the main differences will be pathnames to files and directories.


To get this Project running you have to install some other programs:
Download Tomcat from jakarta.apache.org and install it.
Current Version of eremise is tested with:

jakarta-tomcat-5.0.28

You will need java 1.4+.

If you want to run eremise on apache you have to install Apache and jk.
Current Version of eremise is tested with:
mod_jk2-apache2-2.0.2
apache-2.0.50

To build a new Version of Eremise you also need to install ant.
Current Version of eremise is tested with:
apache-ant-1.6.2

The Content for eremise is stored in a mysql database. Other databases are planned.
So you need to install a mysql server.
Current Version of eremise is tested with:
mysql-server-4.0.21 and 5.0.0

If everything is installed you may first create a new database:

mysql> CREATE DATABASE eremise;

After that you can insert the tables from $EREMISE_HOME/db/install.sql
Replace $EREMISE_HOME with the folder of Eremise

mysql> SOURCE $EREMISE_HOME/db/install.sql


Then you have to create a new mysql user and give him the rights on the database.
"eremisesystem" is the username, "12345678" is the passwort and "localhost" is the host 
from where you want to connect. You have to change these variables.;)

mysql> GRANT ALL ON eremise.* to eremisesystem@localhost identified by '12345678'
mysql> FLUSH PRIVILEGES;

Then you have to insert theses settings into a property file 
$EREMISE_HOME/conf/eremise.properties.

Change the mysql username:
c3p0.user=eremisesystem

change the mysql passwort:
c3p0.password=12345678

They should be the same like those you set up before in the database.;)

There are some other settings in that config file you have to change.
The Authentication Process works like this: The Program opens a ssh connection to
an unix server where all users have their accounts. You need a default user account for 
this first connection. The username and the passwort you have to insert in the following 
variables:
Default user:

authenticator.ssh.defaultUser=defaultuser

Default password:

authenticator.ssh.defaultPass=defaultpass

Hostname of the unix server to connect to:

authenticator.ssh.host=localhost

Save your eremise.properties and change to $EREMISE_HOME.
There you have a build.xml which is used to compile a new version of eremise and put it 
into the tomcat home. Set the Environment Variable $CATALINA_HOME to the Folder of your 
tomcat home, f.Ex.: 
set CATALINA_HOME=/usr/local/jakarta-tomcat5.0/
After that you can start the buildfile by typing:
ant deploy

If everything works fine, the buildfile compiles eremise sources and put everything in a 
ERemise.war file and copies it to $CATALINA_HOME/webapps/ .
Look into that folder if the file exists after your build.

If your tomcat server isnt running yet, start it with now.

if everything works fine you can see the eremise webpage on your server:

http://yourtomcatserver:yourtomcatport/ERemise/

Every user on the unix system you want to connect to has to have an entry in the database.
see table USER!



to bee continued... ;)