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