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