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 openminddirectory

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 them:

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