wiki:Installing

Version 16 (modified by Gavin, 9 years ago) (diff)

--

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 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-5.5.
  • Sun Java SDK.
    • We currently use "1.5.0_17" (Debian Lenny: sun-java5-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, this is what the online demo runs.
      • May be handy to check that the Java server is working.
    • The production WAR is configured to use MySQL.
    • For other database options please see the Changing the Database.

WAR Deployment Steps

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

More Installation Tips