== Setup of Openmind == 
In order to extend or to fix the ismi-server, we must previouly setup the openmind-project.
Follow the following steps to setup this project:

1. Checkout the source code
{{{
svn co https://it-dev.mpiwg-berlin.mpg.de/svn/openmind/
}}}

2. Install the framework called „hashMapping“ in your local maven repository.
{{{
mvn install:install-file -Dfile=~/openmind/lib/hashMapping.jar -DgroupId=cl.talca -DartifactId=hashMapping -Dversion=1.0 -Dpackaging=jar
}}}

3. Install the openmind framework in your local maven repository.
{{{
mvn clean compile assembly:single
cp target/openmind-1.0.0-jar-with-dependencies.jar /Users/jurzua/om4.jar 
mvn install:install-file -Dfile=/Users/jurzua/om4.jar -DgroupId=de.mpiwg.openmind -DartifactId=openmind -Dversion=1.0.0 -Dpackaging=jar
}}}

== Setup of ISMI-Server ==
Now, you will be able to setup the ismi-server. 

1. Checkout the source code:
{{{
svn co https://it-dev.mpiwg-berlin.mpg.de/svn/ismi-richfaces/
}}}

2. Database Setup
The ismi-server stores the data in a mysql database. The connection to the database is configured in ismi-richfaces/src/main/resources/hibernate.cfg.xml.
Old backups of the database can be found in ismi-richfaces/docs/db. You can import one of the backups to test your application.

3. Run ismi-server:
{{{
mvn tomcat7:run 
}}}

4. Release:
{{{
mvn clean package
}}}
== Deployment ==

1. Database configuration.
Before we generate the distributable war file of the ISMI web application, we have to check that the file hibernate.cfg.xml contains a valid MySQL account.

2. The first step of the deploment is the compilation of the source code and the generation of the distributable war file. The following command will generate a war file called ' ismi-richfaces-1.0.war' within the folder target of the project.
{{{
mvn clean package
}}} 


3. Currently, ISMI is running in tuxserve01. In order to deploy the war file, you should copy it into your tomcat distribution. For tuxserve01, you should execute following command:
{{{
cp /home/workspace/ismi-richfaces/target/ismi-richfaces-1.0.war /usr/local/java/tomcat/webapps/om4-ismi.war
}}}
It is worth noting that until now we call the ISMI web application 'om4-ismi', therefore we must rename the war file from 'ismi-richfaces-1.0.war' to 'om4-ismi.war'.


4. Sometimes tomcat has problem trying to redeploy an application. For this reason, I suggest to restart tomcat, always when a new application is deployed.
For this, you can run following command:
{{{
sudo service tomcat7 restart
}}}
If this command does not run successfully, you can get the process id to kill it with this command: 'ps aux | grep tomcat'.