== 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/
}}}
and change into the `openmind`directory

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 install
}}}

== 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/
}}}
and change into the `ismi-richfaces` directory

2. Database Setup
The ismi server stores the data in a mysql database. The connection to the database is configured in `src/main/resources/hibernate.cfg.xml`.

3. URLs for local deployment
Some URLs used by the AJAX frontend are hard-coded in the sources. To run a local development instance you need to change the `rest_url` variable in [[source:ISMI OpenMind/src/main/webapp/imageServer/resources/js/diva4ismi.js|src/main/webapp/imageServer/resources/js/diva4ismi.js]].


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

5. 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 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'.