Page History

HOW-TO

This page describes how to deploy OFBiz on Glassfish Server v2.1. The process is tested on Solaris and Ubuntu and the current (as of July 12th 2009) SVN trunk. The procedure is to setup a free area where the automated scripts create the required WARs and the ofbiz EAR file out of the OFBiz source. Finally the EAR file is copied to autodeploy folder of the specified glassfish domain.

...

1. 1. Create a folder somewhere on the disk with ~800MB free memory. This becomes the work area. Referred as <work-folder> hence forth.unmigrated-wiki-markup
   2. Download Glassfish Server v2.1 and install. (Download it from \ [1\])unmigrated-wiki-markup
   3. Download OFBiz source (if you have not done already). (Either download a release or what not from [http://ofbiz.apache.org/download.html] or checkout from SVN. Refer \ [2\])
   4. Build OFBiz sources (in case of svn checkout) using 'ant' command. This will create 'ofbiz.jar' file.
   5. Generate container templates for Glassfish v2.1 server.
      1. Goto the OFBiz source folder (referred as OFBIZ_HOME).unmigrated-wiki-markup

      2. Use

         the

         command

         'java

         \

         -jar

         ofbiz.jar

         \

         -setup

         glassfish21'

         to

         generate

         the

         templates.

         For

         more

         information

         refer

         \

         [3

         \

         ].

         This

         will

         create

         a

         new

         folder

         called

         'setup'

         inside

         OFBIZ_HOME

         and

         place

         the

         generated

         templates

         under

         the

         folder

         'setup/glassfish21'.

         &nbsp;

          

         Code Block
         if (you are using JavaDB && want seed and demo data loaded) { Copy OFBIZ_HOME/setup/glassfish21/run.sh to <work-folder>; run run.sh script now !; // (without quotes) './run.sh <glassfish_home> <glassfish-domain-path>' } else { read ahead; }

1. Install and start the database server if its not done already. For JavaDB, run GLASSFISH_HOME/javadb/bin/startNetworkServer
2. Wiki MarkupCreate / update entityengine.xml to include your database server details (Refer \ [4\]). If you want to use JavaDB with default settings, you can use the patch entityengine.xml.patch readily available under 'OFBIZ_HOME/setup/glassfish21'.unmigrated-wiki-markup
3. Load seed and demo data (optional, but highly recommended) by using './ant run-install' command under OFBIZ_HOME. Refer \ [5\].
4. Copy OFBIZ_HOME/setup/glassfish21/deploy.sh to <work-folder>.
5. Run deploy.sh. (without quotes) './deploy.sh <glassfish-home> <glassfish-domain-path>'.
6. Check domain.xml for XML validation errors. This to make sure the patching happened properly in previous step.
7. Start/restart glassfish server if its not already running.
8. If you have opted for loading demo data, goto http://localhost:8080/ecommerce and http://localhost:8080/webtools to verify the installation.

References :

Wiki Markup\[1\] : [https://glassfish.dev.java.net/downloads/v2.1-b60e.html] \
[2\] : [https://cwiki.apache.org/confluencedisplay/OFBADMIN/Demo + and + Test + Setup + Guide] (Building from SVN) \
[3\] : OFBIZ_HOME/framework/appserver/README (where OFBIZ_HOME is OFBIZ source root on your local disk. \
[4\] : [https : //cwiki.apache.org/confluencedisplay/OFBTECH/Apache + OFBiz + Technical + Production + Setup + Guide] (2.c. Database Setup) \
[5\] : [https : //cwiki.apache.org/confluencedisplay/OFBTECH/Apache + OFBiz + Technical + Production + Setup + Guide] (2.d. Seed Data Loading)

This works was kindly provided by Vadiraj Deshpande