= 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, Safari etc) so there are no installation requirements for user machines. [[BR]]

There are three ways to get gnuMims running:
 1. Easy: [http://www.gnumims.org/services.html get service] everything will be done for you.
 1. Harder: [http://www.gnumims.org/downloads/gnuMims.war Download WAR] and [http://www.gnumims.org/trac/browser/trunk/gnuMims-config.groovy Config file] and deploy to a Java Servlet (as detailed bellow).
 1. Hardest: 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-6.
 * Oracle Java-7 SDK.
  * We currently use "jdk1.7.0_75" (See http://www.kromhouts.net/blog/server-admin/oracle-sun-java-jdk-for-debian-ubuntu-linux-mint/)
 * Database.
  * We currently use "MySQL-5.5" (Debian Wheezy: mysql-server-5.5)
   * See [wiki:MysqlConfig MySQL Configuration Guide].
  * For other database options please see [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]]

 * Stop Tomcat.
 * Copy the war file to [$TOMCAT_HOME]/webapps/gnuMims.war.
 * Copy the config file to [$TOMCAT_HOME]/commons/classes/gnuMims-config.groovy
 * Read and follow the advice in gnuMims-config.groovy to set the data source.
 * Start Tomcat.
 * View the Tomcat log files [wiki:TomcatLogExample $TOMCAT_HOME/logs/example].
 * Point your web browser to !http://localhost:8080/gnuMims/ or !http://myserver:port/gnuMims.
 * The exact case and name of the war file must match the browser URL.
 * Login with the user name "admin" and password "pass".
 * For production, disable demo data in the admin view.

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