Installing

Back to User Guide Index

GnuMims is a web application built with the Grails web framework.
Once installed to a server all user access is via a web browser (IE, Firefox, Safari etc) so there are no installation requirements for user machines.

There are two ways to get gnuMims running:

1. Download a prepared WAR file and deploy to a Java Servlet (as detailed bellow).
2. Download the source code and build a custom WAR with Grails (see the Developer Start Page for this option).

Note: the online ​Demo provides the easiest way to take gnuMims for a test run.

Requirements

• Java servlet.
  • We currently use Tomcat-6.
• Sun Java SDK.
  • We currently use "Java-6.24" (Debian Squeeze: sun-java6-jdk).
• Database.
  • The development WAR is configured to use an in memory database (HSQLDB).
    • This will NOT save data between restarts!
    • But has the advantage that no database setup is required, good for quick demo runs.
    • May be handy to check that the Java server is working.
  • The production WAR is configured to use MySQL.
    • We currently use "Mysql-5.1.49" (Debian Squeeze: mysql-server-5.1)
    • See MySQL Configuration Guide.
  • For other database options please see Changing the Database.

WAR Deployment Steps

A server with Tomcat and a Java servlet can be a tricky thing to setup.
If you are not experienced with these things please contact us for help!
By all means have a go if you are keen but contact us well BEFORE severe hair loss occurs ;-)
We would rather help than have you give up and miss out on a great application.

• Copy the war file to [$TOMCAT_HOME]/webapps/gnuMims.war or choose to upload through the Tomcat Manager.
• Point your web browser to http://localhost:8180/gnuMims/ or http://myserver:port/gnuMims[Live|Dev].
• Restart Tomcat if required.
• The exact case and name of the war file must match the browser URL.
• Login with the user name "admin" and password "pass".

More Installation Tips