Versions Compared

Key

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

...

To load the initial data just use the OFBiz install routine through ant or directly with Java and the ofbiz.jar executable JAR file. By default the install routine will load the "seed" and "demo" sets of data files, as defined in the entityengine.xml file and in the ofbiz-component.xml file in each component. Run one of these two options from the command line in the ofbiz home directory to run the default install routine:

Code Block

ofbiz$ ant run-install


or

Code Block

ofbiz$ java -jar ofbiz.jar -install


help can be obtained by by the following commands:

Code Block

ofbiz$ java -jar ofbiz.jar -help


or

Code Block

ofbiz$ java -jar ofbiz.jar -install -help


Note that you can choose to only load the basic "seed" data and not load the "demo" set of data files. To do this run something like:

Code Block

ofbiz$ java -jar ofbiz.jar -install -readers=seed,seed-initial


Definition: Seed Data is data that an application requires in order to run. It is created and maintained along with the code and should be loaded into the database when the code is updated. It should not be changed or removed in the application database without first having done so in the Seed Data XML files. In OFBiz these are the source of the Seed Data and they are maintained in the code repository along with the code. Add in components should do the same for this sort of data.

Definition: Seed Initial Data is data that is only required the first time the system is loaded like the password of the admin user. Later if you want to update the seed data, you normally do not want the password of admin set back to the 'ofbiz' value.

Expert Recommendation: For smaller installations we recommend loading the demo data and modifying it through the OFBiz applications rather than creating all of the data from scratch.

For larger installations we recommend creating data files with your own settings, copied from the demo data, or simply creating all data from scratch. These can be added to the "ext" set of install data files, which is done by referencing those files in an ofbiz-component.xml file entity-resource tag with the attribute reader-name="ext". To load the "seed" and "ext" groups run something like:

Code Block

ofbiz$ java -jar ofbiz.jar -install -readers=seed,ext


or the special ant target:

Code Block

ofbiz$ ant run-install-extseed


The OFBiz demo data includes a Party with ID "admin" and it has a number of UserLogin accounts associated with it that have varying permissions. Note the following configuration changes:

...

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

ofbiz$ java -jar ofbiz.jar


or through ant:

Code Block

ofbiz$ ant run


Then to access the application from your browser follow advices in Demo and Test Setup Guide

...

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

ofbiz$ 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 (Tomcat by default), but it can be changed by adding the catalina-container block. This allows to run the POS conccurently with Web eCommerce and Back Office.

...