wiki:Installing

Version 9 (modified by Gavin, 15 years ago) (diff)

--

Install

GnuMims is a web application built with the Grails web framework. Once installed to a server all user access is via a web browser (IE, Firefox etc) so there are no installation requirements for user machines.

There are two ways to get gnuMims running:

  1. Download a prepared WAR file and deploy to a Java Servlet (as detailed bellow).
  2. Download the source code and build a custom WAR with Grails (see the DeveloperStartPage for this option).

Note: the online 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 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 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.