= 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/export/935/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. * Sun Java-6 SDK. * We currently use "Java-6.24" (Debian Squeeze: sun-java6-jdk). * Database. * We currently use "Mysql-5.1.49" (Debian Squeeze: mysql-server-5.1) * 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]'''