== Install == 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 DeveloperStartPage 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 options: * The development [http://www.gnumims.org/downloads/dev/gnuMims.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. * The production [http://www.gnumims.org/downloads/prod/gnuMims.war WAR] is configured to use MySQL (we currently use Debian Lenny: mysql-server-5.0) * To use this option a MySQL server with the following setup is required: * Hostname = "gnumimssql01" (Setup DNS or add an entry to /etc/hosts) * Port = "3306" (The default MySQL port) * database = "gnumims_prod" * username = "gnumimsadmin" (This user must have all access to the database above) * password = "gnumimsadmin" (Having an open password is not a problem if MySQL is suitably firewalled and/or accepts only local connections) * For other database options please see the developer page. '''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". * Navigate to 'Admin' and create the base data (demo data is optional). '''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 * Note: as always the more memmory the better but gnumims is know to run at this setting and perhaps even lower.