== Install == There are two ways to get gnuMims running: 1. Download the WAR file and deploy to a Java Servlet (see bellow). 1. Download the source code, build and run with Grails. (See the the DeveloperStartPage if you want to build a custom war.) Note: there is an online [http://democo.gnumims.com Demo] '''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 [http://www.gnumims.org/downloads/gnuMims.war 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) '''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. * Restart Tomcat if required. * Login with the user name "admin" and password "pass". '''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