= Installing =
[wiki:UserGuide Back to User Guide Index] [[BR]]

!GnuMims is a web application built with the Grails web framework. [[BR]]
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. [[BR]]

There are two ways to get gnuMims running:
 1. Download a prepared WAR file and deploy to a Java Servlet (as detailed bellow).
 1. Download the source code and build a custom WAR with Grails (see the [wiki:DeveloperStartPage Developer Start Page] for this option).

Note: the online [http://democo.gnumims.com 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 [http://www.gnumims.org/downloads/dev/gnuMimsDev.war 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 [http://www.gnumims.org/downloads/prod/gnuMimsLive.war WAR] is configured to use MySQL.
   * We currently use "5.0.51" (Debian Lenny: mysql-server-5.0)
   * See [wiki:MysqlConfig MySQL Configuration Guide].
  * For other database options please see the [wiki:ChangingTheDatabase Changing the Database].

'''WAR Deployment Steps'''

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

 * 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".

'''[wiki:InstallationTips More Installation Tips]'''