Changes between Version 9 and Version 10 of InstallationTips

Timestamp:

May 19, 2011, 5:01:29 AM (13 years ago)

Author:

Gavin

Comment:

--

InstallationTips

@@ -8 +8 @@
 All our testing and configuration is done against Debian servers. [[BR]]
 
- * Install sun-java5, be sure that no gcj (GNU java) packages are installed:
+ * Install sun-java-6, be sure that no gcj (GNU java) packages are installed:
 {{{
 dpkg --get-selections |grep gcj
@@ -14 +14 @@
  Note: The above search command must return NO packages.
 {{{
-aptitude install sun-java5-jdk
+aptitude install sun-java6-jdk
 }}}
 
  * Install tomcat:
 {{{
-aptitude install tomcat5.5
+aptitude install tomcat6
 }}}
 
@@ -29 +29 @@
 '''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
+ * In Debian add/adjust the following lines in /etc/default/tomcat6:
+  * JAVA_HOME=/usr/lib/jvm/java-6-sun
+  * JAVA_OPTS="-Djava.awt.headless=true -Xms256m -Xmx256M -XX:PermSize=80m -XX:MaxPermSize=80m -XX:+UseConcMarkSweepGC"
+  * As always the more memory the better but gnuMims is known to run on the demo at this setting.
+
+Only Debian Lenny (old stable):
  * To work around a java.lang.!UnsatisfiedLinkError in Debian Lenny run the following commands:
   * i386: ln -s /usr/lib/jvm/java-1.5.0-sun/jre/lib/i386/libmlib_image.so /usr/lib
@@ -39 +41 @@
  * Note: 
   * The above security settings should not be used in production, see http://tomcat.apache.org/tomcat-5.5-doc/security-manager-howto.html
-  * As always the more memory the better but gnuMims is known to run at this setting and perhaps even lower.
 
 '''Memory Tips'''
 
  * !GnuMims has been known to load and run on a 300Mhz laptop with <180MB total RAM but would not be very usable.
- * A Debian GNU/Linux machine with 1GB RAM and P4 equivalent processor is recommended.
+ * A Debian GNU/Linux machine with at least 1GB RAM and P4 equivalent processor is recommended.
  * For a Windows 2003 server directly running tomcat you may need more than 2G of RAM (that's why we recommend a dedicated Debian GNU/Linux)
  * A vmware virtual appliance (GNU/Linux + Tomcat + Mysql) with 1G of RAM should work ok on a Windows 2003 server if you must run Windows.
@@ -53 +54 @@
   * This is an apache example config using libapache2-mod-jk:
 {{{
-Alias /gnuMims /var/lib/tomcat5.5/webapps/gnuMims
-<Directory /var/lib/tomcat5.5/webapps/gnuMims/>
-    Options FollowSymLinks Indexes MultiViews
-    AllowOverride None
-    order allow,deny
-    allow from all
-</Directory>
+JkMount /gnuMims/* ajp13_worker
 
-JkMount /gnuMims/* ajp13_worker
+<VirtualHost *:80>
+    ServerAdmin contact@example.com
+    ServerName gnumims.example.com
+
+    #Requests for "/" and "/gnuMims" are redirected to "/gnuMims/"
+    #[R] is an external redirect so the url is passed back to the browser.
+    RewriteEngine  on
+    RewriteRule    ^/$              /gnuMims/       [L,R]
+    RewriteRule    ^/gnuMims$       /gnuMims/       [L,R]
+
+   JkMount /gnuMims/* ajp13_worker
+
+</VirtualHost>
 }}}
   * To enable libapache2-mod-jk in Debian set these lines in /etc/apache2/mods-available/jk.conf:
@@ -73 +80 @@
   * To configure mod-jk in Debian double check these lines in /etc/libapache2-mod-jk/workers.properties:
 {{{
-workers.tomcat_home=/usr/share/tomcat5.5
-workers.java_home=/usr/lib/jvm/java-1.5.0-sun
+workers.tomcat_home=/usr/share/tomcat6
+workers.java_home=/usr/lib/jvm/default-java
 }}}
   * Then run: 
@@ -89 +96 @@
 
  * Every server must have a firewall, we use shorewall firewall.
- * Ports of interest - http:80, https:443, Tomcat(Debian):8180, MySQL:3306.
+ * Ports of interest - http:80, https:443, Tomcat(Debian):8180 or 8080, MySQL:3306.
 
 === One again, please contact us if any of this does not work for you. ===