| | 1 | = Installation Tips = |
| | 2 | |
| | 3 | A server with Tomcat and a Java servlet can be a tricky thing to setup. [[BR]] |
| | 4 | If you are not experienced with these things please contact us for help! [[BR]] |
| | 5 | By all means have a go if you are keen but contact us well BEFORE severe hair loss occurs ;-) [[BR]] |
| | 6 | We would rather help than have you give up and miss out on a great application. [[BR]] |
| | 7 | The general installation steps are [wiki:Installing here]. |
| | 8 | |
| | 9 | '''Tomcat Setup Tips''' |
| | 10 | |
| | 11 | * In Debian add/adjust the following lines in /etc/default/tomcat5.5: |
| | 12 | * JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun/ |
| | 13 | * JAVA_OPTS="-Djava.awt.headless=true -Xmx256M" |
| | 14 | * TOMCAT5_SECURITY=no |
| | 15 | * To work around a java.lang.!UnsatisfiedLinkError in Debian Lenny run the following commands: |
| | 16 | * i386: ln -s /usr/lib/jvm/java-1.5.0-sun/jre/lib/i386/libmlib_image.so /usr/lib |
| | 17 | * amd64: ln -s /usr/lib/jvm/java-1.5.0-sun/jre/lib/amd64/libmlib_image.so /usr/lib |
| | 18 | * both: ldconfig |
| | 19 | * Note: |
| | 20 | * The above security settings should not be used in production, see http://tomcat.apache.org/tomcat-5.5-doc/security-manager-howto.html |
| | 21 | * As always the more memory the better but gnuMims is known to run at this setting and perhaps even lower. |
| | 22 | |
| | 23 | '''Memory Tips''' |
| | 24 | |
| | 25 | * !GnuMims has been known to load and run on a 300Mhz laptop with <180MB total RAM but would not be very usable. |
| | 26 | * A Debian GNU/Linux machine with 512MB RAM and P4 equivalent processor is recommended. |
| | 27 | * For a Windows 2003 server you may need upwards of 2G or RAM (that's why we recommend a dedicated Debian GNU/Linux) |
| | 28 | * A vmware GNU/Linux + Tomcat virtual appliance with 1G of RAM should work ok on a Windows 2003 server if you must run Windows. |
| | 29 | |
| | 30 | '''Apache2 Setup Tips''' |
| | 31 | |
| | 32 | * It is common (but not required) to have Tomcat run through Apache. |
| | 33 | * This is an apache example config using libapache2-mod-jk: |
| | 34 | {{{ |
| | 35 | Alias /gnuMims /var/lib/tomcat5.5/webapps/gnuMims |
| | 36 | <Directory /var/lib/tomcat5.5/webapps/gnuMims/> |
| | 37 | Options FollowSymLinks Indexes MultiViews |
| | 38 | AllowOverride None |
| | 39 | order allow,deny |
| | 40 | allow from all |
| | 41 | </Directory> |
| | 42 | |
| | 43 | JkMount /gnuMims/* ajp13_worker |
| | 44 | }}} |
| | 45 | * To enable libapache2-mod-jk in Debian set these lines in /etc/apache2/mods-available/jk.conf: |
| | 46 | {{{ |
| | 47 | JkWorkersFile /etc/libapache2-mod-jk/workers.properties |
| | 48 | JkLogFile /var/log/apache2/mod_jk.log |
| | 49 | JkLogLevel info |
| | 50 | JkMount /*.jsp ajp13_worker |
| | 51 | JkMount /*/servlet/ ajp13_worker |
| | 52 | }}} |
| | 53 | * Then run: |
| | 54 | * a2enmod jk |
| | 55 | * /etc/init.d/apache2 restart |
| | 56 | |
| | 57 | One again contact us if this does not work for you! |
