== Install ==

There are two ways to get gnuMims running:
 1. Download the [http://www.gnumims.org/downloads/gnuMims.war war] file and deploy to a Java Servlet (see bellow).
 1. Download the source code, build and run with Grails.

Note: there is an online [http://democo.gnumims.com Demo]

'''Requirements'''

 * Java servlet, we currently use tomcat5.5.
 * Sun java sdk, we currently use "1.5.0_17" (Debian Lenny: sun-java5-jdk).
 * Database
  * The war is built to use an in memory database (hsqldb), this will NOT save data between restarts!
  * Most databases can be used, we currently use MySQL (Debian Lenny: mysql-server-5.0)
 * See the the DeveloperStartPage if you want to build a custom war.

'''Steps'''

 * Copy the war file into the [$TOMCAT_HOME]/webapps folder or choose to upload through the Tomcat online console.
 * Point your web browser to !http://localhost:8180/gnuMims/ or !http://myserver:port/gnuMims .
 * Sign on with the user name "admin" and password "pass"
 * Start using gnuMims.

'''Tomcat'''

 * In Debian add/adjust the following lines in /etc/default/tomcat5.5:
  * JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun/
  * JAVA_OPTS="-Djava.awt.headless=true -Xmx256M"
  * TOMCAT5_SECURITY=no
 * Note: the above security settings should not be used in production, see http://tomcat.apache.org/tomcat-5.5-doc/security-manager-howto.html