Versions Compared

Key

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

...

Sponsored by:
Integral Business Solutions (http://www.go-integral.com)
Hotwax Media, Inc (http://www.hotwaxmedia.com)

Table of Contents
  1. Data To Gather for Setup
  2. Technical Setup Process
    1. Tools Installation
    2. OFBiz Installation
    3. Database Setup
    4. Seed Data Loading
    5. OFBiz Configuration
      1. Cache Settings
      2. Debug Settings
      3. Security Settings
      4. URL and Port Settings
      5. Ports, Default Values
      6. SSL Certificate Setup
      7. Currency, Locale Settings
      8. Email Server Settings
      9. Mounting a Root WebApp
    6. Running OFBiz
    7. Performance Monitoring and Tuning
  3. POS Setup Process

...

There are various ways to run OFBiz, and they all come down to some variation of the executing the "ofbiz.jar" executable JAR file. On the command line this can be as simple as:"

Code Block
java \-jar ofbiz.jar

...

For production use you will want to setup a start script that contains special settings for things like memory heap size, and so on. There are example start and stop scripts in the root ofbiz directory in the startofbiz.sh and stopofbiz.sh files.

Expert Recommendation: Instead of running the startup and shutdown scripts manually it might be a good idea to set them up as services on the system, or use something like daemontools to make sure the process is restarted automatically if it goes down for some reason.

Running OFBiz Automated Tests

Each component running in OFBiz can have its own set of tests. These are usually defined in the "testdef" directory in each component, and the test set XML files are specified in the ofbiz-component.xml file for each component.

To run all automated tests use the following command:

Code Block
ofbiz$ java -jar ofbiz.jar -test

To run just the tests for one component run something like (for the entity component):

Code Block
java -jar ofbiz.jar test component=entity

Performance Monitoring and Tuning

...

To run OFBiz in the POS "mode" just run: "

Code Block
java \-jar ofbiz.jar \-pos

...

Note that this uses the pos-containers.xml file instead of the ofbiz-containers.xml file and by default it doesn't load a web container (ie Tomcat or Jetty), but that can certainly be added by changing that file.

...