Versions Compared

Key

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

...

  • After installation, you may set your GERONIMO_HOME env var (for me for instance, on Windows it was C:\Program Files\IBM\WebSphere\AppServerCommunityEdition).
    But you might prefer to set it in the appserver.properties file. In the same time check the content of this file and adapt it suiting your needs.

Setup and deploy

  • First check and adapt the content of the appserver.properties file
    • For instance system/manager are the defaut login/pwd coming with WASCE (and Geronimo). You may need to change them, but there are more important informations
  • From a clean OFBiz installation which runs well on the same machine than where WASCE is installed, at OFBiz root (or Eclipse, or what else) run
    Code Block
    java -jar ofbiz.jar -setup wasce2
    This should deploy OFBiz under your application server (offline or inline depending of appserver.properties file setting for offline parameter) and generate 3 kinds of files
  1. OFBiz jar files in the Geronimo repository
  2. Deployment plans (application.xml and geronimo-application.xml) in a generated META-INF directory (in OFBiz root directory). Though the term "deployment plans" is normally used for Geronimo specific "J2EE deployment descriptors" (application.xml for instance is a standard "J2EE deployment descriptors")
  3. Deployment plans (geronimo-web.xml) in each applications WEB-INF directories

Actually there is one more README file generated in OFBiz META-INF directory. Open it and follow its intructions before running your application server (so the 1st time you need to deploy offline).
Don't forget to have a look in this file, there are important informations generated there

Something like "Illegal character in path" in the log means that you must remove the corresponding file, these errors are often related to .xls of .pdf files (or what else) found in the OFBiz directories structure (these kinds of files don't exist in OFBiz OOTB). If it's not related directly to OFBiz remove it.

...

Don't worry, this is because the deployment tool try before to undeploy. And if you see this message it's only because this module is not deployed on the server.Note that system/manager are the defaut login/pwd coming with WASCE (and Geronimo). You may need to change them in appserver.properties

I should mention that it seems to me that deploying with a server already running (offline=false in appserver.properties) is faster but I did not measure exactly yet. Anyway, you need to deploy offline the 1st time you deploy since you need to put in the geronimo script (.bat or .sh) the generated and mandatory informations found in META-INF/README before running the server. Else OFBiz modules will not load and the server will hang.

...