[Equanda-svn-commit] SF.net SVN: equanda: [154] trunk/src/site/wiki

[<tri...@us...>]

Revision: 154
          http://equanda.svn.sourceforge.net/equanda/?rev=154&view=rev
Author:   triathlon98
Date:     2007-11-15 08:19:29 -0800 (Thu, 15 Nov 2007)

Log Message:
-----------
jboss tuning docs

Modified Paths:
--------------
    trunk/src/site/wiki/gettingstarted.wiki

Added Paths:
-----------
    trunk/src/site/wiki/jbosstuning.wiki

Modified: trunk/src/site/wiki/gettingstarted.wiki
===================================================================
--- trunk/src/site/wiki/gettingstarted.wiki	2007-11-15 09:01:51 UTC (rev 153)
+++ trunk/src/site/wiki/gettingstarted.wiki	2007-11-15 16:19:29 UTC (rev 154)
@@ -8,7 +8,7 @@
 
 - Install [maven|http://maven.apache.org/]. It has been tested with v2.07, higher versions should also work, not sure about lower versions.
 - Download and install [firebird|http://www.firebirdsql.org].
-- Download the jboss, it is easiest to use this [equanda tuned configuration|http://www.progs.be/equandajboss4.2.0.tgz] of 4.2.0. Unzip at a location of your choice.
+- Download the jboss, it is easiest to use this [equanda tuned configuration|http://www.progs.be/equandajboss-4.2.2.zip] of 4.2.2GA. Unzip at a location of your choice. Or you can [tune your own|jbosstuning.html] copy.
 - Download the example application at [http://www.progs.be/equanda-example.tgz] (or get it from svn). Unzip at a location of your choice.
 
 h2. Prepare the deployment

Added: trunk/src/site/wiki/jbosstuning.wiki
===================================================================
--- trunk/src/site/wiki/jbosstuning.wiki	                        (rev 0)
+++ trunk/src/site/wiki/jbosstuning.wiki	2007-11-15 16:19:29 UTC (rev 154)
@@ -0,0 +1,38 @@
+h1. Tuning jboss
+
+There is a specially preconfigured jboss 4.2.2GA distribution for equanda available for download at [http://progs.be/equandajboss-4.2.2.zip].
+This equanda version is tuned for both speed and size and has some customizations which are needed for equanda.
+
+The differences between the equanda version and the jboss distrubution are
+- there is only one server version "equanda" which is based on the jboss "default" configuration.
+- the "docs" directory has been removed as this is not needed for running jboss.
+- run.bat has been modified to have the following default options "-Xms256m -Xmx382m -XX:MaxPermSize=128m -Dsun.net.inetaddr.ttl=15 -Dfile.encoding=UTF-8". This reservers more memory and a bigger permspace, allows services with dynamic ip addresses to be used and forces the file encoding to be UTF-8 instead of the system default.
+- run.conf has also been modified to have better settings for deployment if the environment variable JAVA_OPTS has not been defined.{code}   JAVA_OPTS="-server -Xms382m -Xmx1024m -XX:MaxPermSize=200m"
+   JAVA_OPTS="$JAVA_OPTS -XX:+UseConcMarkSweepGC -XX:+CMSIncrementalMode -XX:+CMSIncrementalPacing -XX:CMSIncrementalDutyCycleMin=0 -XX:CMSIncrementalDutyCycle=10"
+   JAVA_OPTS="$JAVA_OPTS -Dsun.net.inetaddr.ttl=15 -Djava.awt.headless=true -Dfile.encoding=UTF-8 -Djaas.security.domain=equanda"
+   JAVA_OPTS="$JAVA_OPTS -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000 -XX:ThreadStackSize=128"{code}
+- run.sh is modified to bind to all ip addresses.   
+- exceptionsorter.java has been added. This catches exceptions for the firebird database, assuring that transaction retries are attempted when needed.
+- jaybird-2.1.1.jar has been added in server/equanda/lib to assure that [firebird|http://www.firebirdsql.org] database support does not require extra downloads.
+- the following files have been removed from server/equanda/deploy, if they are needed for your application, you should add them again (from the full jboss distribution).
+-- jms support has been removed as this is by default not used in equanda applications. 
+-- management (web-console) has been removed as this requires JSP. This distribution is tuned to have JSP removed.
+-- mail-ra.rar
+-- http-invoker.sar
+-- jboss-web.deployer/ROOT.war
+-- bsh-deployer.xml
+-- cache-invalidation-service.xml
+-- jsr88-service.xml
+- changes in the deploy directory
+-- jmx-console is secured (in jmx-console.war/WEB-INF/ both web.xml and jboss-web.xml)
+-- equanda-test-ds.xml is added as example (firebird) datasource
+-- ejb3-entity-cache-service.xml added (local cache only, not clustered)
+-- ejb3-interceptors-aop.xml modified to copy (equanda) state from client to server
+-- jboss-web.deployer/META-INF/jboss-service.xml has "UseJBossWebLoader" configured to "true".
+- configuration changes
+-- conf/jboss-log4j.conf has been modified for improved useability (to my taste at least), but you probably want to change this some more.
+-- conf/jboss-service.xml has the JSR-77 support removed, RMIObjectPort modified (from 4444 to 14444) to allow co-habitation with [Selenium|http://www.openqa.org/selenium/].
+-- conf/login-config.xml default does not uses configuration in "prop" subdirectory and example equanda specific login manager. 
+
+Other improvements which could be made
+- For deployment, the "client" directory can also be removed.


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.