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.
There are two scripts, run.sh and deploy.sh. The first one deploys OFBiz after loading the seed and demo data automatically into JavaDB database that comes with Glassfish server. The second one, deploy.sh just builds WARs and EAR and deploys to the Glassfish server. You are free to run either of one, depending on ur your need.
Setup
-
- Create a folder somewhere on the disk with ~800MB free memory. This becomes the work area. Referred as <work-folder> hence forth.
Download Glassfish Server v2.1 and install. (Download it from [1])
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])
- Build OFBiz sources (in case of svn checkout) using 'ant' command. This will create 'ofbiz.jar' file.
- Generate container templates for Glassfish v2.1 server.
- Goto the OFBiz source folder (referred as OFBIZ_HOME).
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'.
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; }
- Install and start the database server if its not done already. For JavaDB, run GLASSFISH_HOME/javadb/bin/startNetworkServer
Create / 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'.
Load seed and demo data (optional, but highly recommended) by using './ant run-install' command under OFBIZ_HOME. Refer [5].
- Copy OFBIZ_HOME/setup/glassfish21/deploy.sh to <work-folder>.
- Run deploy.sh. (without quotes) './deploy.sh <glassfish-home> <glassfish-domain-path>'.
- Check domain.xml for XML validation errors. This to make sure the patching happened properly in previous step.
- Start/restart glassfish server if its not already running.
- If you have opted for loading demo data, goto http://localhost:8080/ecommerce and http://localhost:8080/webtools to verify the installation.
References :
[1] : https://glassfish.dev.java.net/downloads/v2.1-b60e.html
[2] : [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] : [OFBTECH:Apache OFBiz Technical Production Setup Guide] (2.c. Database Setup)
[5] : [OFBTECH:Apache OFBiz Technical Production Setup Guide] (2.d. Seed Data Loading)
This works was kindly provided by Vadiraj Deshpande