Preparing your Computer

This is a guide which provides instructions on how to install the needed dependencies to install Mistral-IdM.
After installing dependencies, you can start with the Mistral-IdM installation here.

This guide is organized as follow:

Tomcat Installation

Tomcat requires java (http://java.sun.com/javase/downloads/index.jsp) and requires setting the JAVA_HOME variable. The best way to do this is to set it in your .bashrc file adding the line:

export JAVA_HOME=/usr/lib/jvm/java-6-sun

Now you will download and extract tomcat from http://tomcat.apache.org/. At this point you can start tomcat by just executing the startup.sh script in the tomcat/bin folder.

Activate SSL Support

First of all you have to generate a keystore

$JAVA_HOME/bin/keytool -genkey -alias tomcat -keyalg RSA

Then, edit tomcat server configuration file, by default $CATALINA_BASE/conf/server.xml

<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="someengine" SSLRandomSeed="somedevice" />

For further information go here.

Mistral needs opening SSL connections to hosts using JSSE, so you must add the server's certificate to the KeyStore with your trusted certificates. A easy way to do this is following the manual here.

eXist-db Installation

Download the latest standard distribution of eXist. This package is recommended for new eXist users and includes a graphical installer that guides you through the installation process. This standard distribution comes as an executable .jar (Java Archive) file, which automatically determines the correct system settings (i.e. paths and environment variables) for eXist.
Once the download has completed, start the eXist installation by doing:

java -jar eXist-[version]-build-XXXX.jar

This will launch the installer. Simply follow the steps to complete the installation process.

Take into account eXist-db default listening port is 8080, matching with tomcat listening port. In that case, you should change one of them.

OpenLdap Installation

Download lastest stable version of OpenLDAP from http://www.openldap.org.

Untar it on any folder and execute:

./configure

make

make install

Note: If you see a error on Ubuntu like: 'getpeereid.c:65: error: storage size of peercred isnt known' you had rather compile with CPPFLAGS=-D_GNU_SOURCE. To do this execute:

env CPPFLAGS=-D_GNU_SOURCE

And then compile with make.

 

Configure a database

After installing, you need to configure a database. To do this you can modify slapd.conf file adding for instance:

database bdb

directory /usr/share/mistral/mistral-fi

index objectClass eq

suffix "dc=mistral,dc=com"

rootdn "uid=admin,ou=users,dc=mistral,dc=com"

rootpw admin