Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Guidelines to run OFBiz under WASCE 2.0.0.1 or Geronimo 2.0.3

Goal

This is intended to be used at production stage. The idea is to develop as normal under OFBiz, and then, when at production stage, to deploy on a WASCE/Geronimo server. You can then update anew when needed from developement machine(s).

How it works

This uses a totally exploded EAR architecture (with exploded WARs as well).
The deployment tool is for the moment intended to be use on a sole machine. You can deploy remotely (on a Linux Server from a Windows machine for instance, or whatever actually) but there are some drawback drawbacks due o to Geronimo itself. See comments at end of this page. So the idea is to have an OFBiz instance on the server you want to deploy and to update it from your development machine(s) (using Subversion for instance). Then to deploy locally from this updated OFBiz instance on the server.

Info
Updating on server
Updating on server
  • Follow instructions in the generated META-INF/README file to update WASVE/Geronimo running scripts on your server.
  • If you have developed your own applications, don't forget, before deploying, to update accordingly in framework\appserver\templates\wasce2
    • application.xml
    • geronimo-application.xml

WASCE 2.0.0.1 is based on Geronimo 2.0.3 which is a snapshot (previous versions, and so far 2.1, don't work), I got it there http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/assemblies/geronimo-tomcat6-jee5/2.0.3-SNAPSHOT/geronimo-tomcat6-jee5-2.0.3-20080318.171132-2-bin.zip
To know more have a look at https://issues.apache.org/jira/browse/GERONIMO-3947

...

You can't redeploy OFBiz modules (web apps actually) independently. You have to redeploy the whole ear. This is because we use a totally exploded EAR (with WARs exploed inside) more information on Geronimo forum.

Remote deployment (not recommended)

Remote deployment using the --inPlace option (for a totally exploded EAR with exploded and only exploded WARs inside as OFBiz is deployed above) is only possible if you exactly replicate the deployed directory structure on both the client and the server machine. If you are on Windows you must even replicate the drive more information on Geronimo forum. I have open a Jira issue for this https://issues.apache.org/jira/browse/GERONIMO-3963. Also beware of heterogeous environments (Windows to Linux for instance) as I did any such tests.