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 src/main/webapp/imageServer/resources/js/diva4ismi.js​.

4. Run ismi-server:

   mvn tomcat7:run 
   

5. Release:

   mvn clean package
   

Deployment

On ismi.mpiwg-berlin.mpg.de the code projects 'openmind' and 'ismi-richfaces' are checked out in the directory /usr/local/java/src/.

Updates and deployment steps should be performed as root user.

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 deployment is the compilation of the source code and the generation of the distributable war file. The following command will generate a webapp folder and a war file called 'ismi-richfaces-1.0.war' within the folder target of the project:

   cd /usr/local/java/src/ismi-richfaces
   mvn package
   

3. Currently, ISMI is running on ismi.mpiwg-berlin.mpg.de. In order to deploy the war file, you should copy it into your tomcat distribution. For ismi, you should execute following command:

   rsync -auv /usr/local/java/src/ismi-richfaces/target/ismi-richfaces-1.0/ /usr/local/java/ismi-tomcat/webapps/om4-ismi/
   

It is worth noting that until now we call the ISMI web application 'om4-ismi', therefore we renamed the webapp folder from 'ismi-richfaces-1.0' to 'om4-ismi'.

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:

service tomcat restart

If this command does not run successfully, you can get the process id to kill it with this command: 'ps aux | grep tomcat'.