Mint

Installing a Mint version for use with the DM2E setup.

1. Prerequisites

We use 1.8.7, but other 1.8.+ version might work too.
 * 1.1 Java (Mint is tested and developed on 1.6 but might run just fine on 1.7)
 * 1.2 Mint code from github
 * 1.3 Tomcat ( tested and run regularly on Tomcat 6 ). Might work with other java/tomcat combinations.
 * 1.4 Josso (Java Single Sign On solution) libraries to be added to tomcats lib directory
 * 1.5 PostgreSQL instance 9.1+

2. Configurations

The out-of-the box configuration might just work. Copy the mint code into a directory under webapps and start tomcat normally. If you expect a lot of usage, you might want to increase the JVM memory.
 * 2.1 Tomcat config


 * 2.2 Josso config

This list pertains to josso-1.8.7 and tomcat6

During installation we found that the josso gsh installer for tomcat6 doesn't work (completely) on the linux machine we used. So step by step tomcat was modified like this:


 * 2.2.1: Copy lot of libs into tomcat/lib folder


 * well, some of those were already there, but due to this, we would not recommend to modify an existing server but use a separate one for josso. All the libs should be included in the josso distribution.


 * 2.2.2: Copy the josso-agent-config.xml into the tomcat/lib dir. It might need modification, if the app name is not dm2e.
 * 2.2.3: tomcat/conf/server.xml needs some additions:


 * and

 at appropriate places, along with the removal of the normal Realm for user database.
 * 2.2.4: Put the jaas.conf into a place, maybe tomcat/conf. You'll need to reference it in 5:


 * 2.2.5: Start tomcat with -Djava.security.auth.login.config=tomcat/conf/jaas.conf
 * tomcat/bin/setenv.sh might be a good place to add this option.
 * (use absolute path, its safer)


 * 2.3 PostgreSQL config
 * 2.3.1 Run a normal PostgreSQL instance.
 * 2.3.2 Create a user 'dm2e' and an empty database with charset UTF8 and collation C
 * 2.3.3 Modify the hibernate.properties in the mint code to reflect user, database and password of that database
 * 2.3.4 Modify WEB-INF/src/createSchema.sql to create schemaname 'dm2e' and execute it on the empty database