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

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.

...

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

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.

...

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

...