Page History

...

Table of contents

...

This document describes an initial setup process and basic configuration options for the Open For Business Project. For more detail see related documents such as the Framework Configuration Guide, the Entity Engine Configuration Guide, the Service Engine Configuration Guide, and other related documents you may found at OFBiz Documentation Index

If you run into trouble there are various resources available to help. The first steps would be to search on the New OFBiz Docs Site and Old OFBiz Wiki (now archived), and then on the OFBiz Mailing Lists. If you can't find you answer there, then subscribe to the Apache OFBiz Users Mailing List, and send a message with as much detail as possible about the problem you are having.

Quick & Easy Setup

There are 3 2 possibilities to get up and running OFBiz quickly by following some simple instructions:

• Download an OFBiz release
• Check out from the repository (see below for more).
• Download an OFBiz complete distribution, ready to use (those are nightly snapshots, be sure to read the "Developers Only" section)

For more options and explanations, see the rest of this document.

1. Download and install Java 1.8 or higher JDK/J2SDK (not the JRE, you need the full SDK) from Sun's Java (J2SE) site. You can use OpenJdk 8 (or higher).
   Make sure your JAVA_HOME environment variable is set to this JDK after installation (NOTE that for Mac OS X no JVM setup is needed, just make sure Java is up to date with the OS X Software Update facility).
   There are still people using older versions, even it it's of course not recommened, notably for security reasons. By and large see this page on system requirements.
2. "Download" OFBiz in the directory of your choice (see comments below about that). This should create one sub-directory: ofbiz. This will be the OFBIZ_HOME location.
3. (not for snapshots) Load OFBiz demo data in the embedded Apache Derby data base database running "gradlew loadDefaultloadAll" on Windows or "./gradlew loadDefaultloadAll" on Linux/Unix/OSX.
4. Start OFBiz with embedded Tomcat by going into the ofbiz directory and then running
   • Windows: "gradlew startofbiz" or "startofbiz.bat" (or even "%JAVA_HOME%\bin\java -jar build\libs\ofbiz.jar")
   • Linux/Unix/OSX: "./gradlew start ofbiz" or "./startofbiz.sh" (or even "$JAVA_HOME/bin/java -jar build/libs/ofbiz.jar").
5. Open a browser and go to
   httphttps://127.0.0.1:8080/ecommerce/control/mainlocalhost:8443/ecommerce or https://localhost:8443/ecomseo for the ecommerce application or
   https://127.0.0.1localhost:8443/webtools /control/mainfor the WebTools application or
   https://127.0.0.1localhost:8443/catalog /control/mainfor the Catalog Manager application.
6. The default administrative account is username: "admin", password: "ofbiz".
7. Have fun with it! You are running on a Java database. For more discussion of databases, read the section below on that topic.
8. For more detailed options and configuration information, read on!

...

Now go into the "ofbiz" directory and run "gradlew" (Windows), or "./gradlew" (Linux/Unix/OSX). It will compile all modules and leave you an executable jar (ofbiz.jar) in the "ofbiz/build/libs" directory.

...

You can get more information about available Gradle possiblities possibilities using "gradlew takstasks" (Windows) or "./gradlew takstasks" (Linux/Unix/OSX)

Database Setup

Database setup is done in the entityengine.xml file. There are many options there which are described in the Entity Engine Configuration Guide

The OFBiz package comes with Apache Derby, an open source Java database with DB2 specs and is based on the IBM Cloudscape product. This database is good for demonstration purposes because it is easy to setup and use. It is not the best for large data sets and does not provide the same performance or scalability that a major database would, but compared to HypersonicSQL (that we used to use) it is significantly better because while not as fast for small scale operations it is closer to a production database environment and allows us to catch issues earlier on. Smaller sites might even consider this as an option for their production deployment, especially once the database is a bit more stabilized.

There are many open source databases that will scale well and deliver good performance. The two most popular are PostgreSQL and MySQL. Postgres is a very full featured database with transaction support, foreign keys, stored procedures, et cetera. Postgres also has very friendly license terms. MySQL is a pretty good option these days as well but we recommend PostgreSQL. Please note that if you use MySQL in a commercial production instance you may have to purchase a commercial license because it is GPL licensed and so is the JDBC driver. MySQL AB allows use of the JDBC driver in open source projects in spite the GPL license, but this may not apply for commercial use of a modified OFBiz. For some, a commercial license is the preferred way to go anyway because of support and warranty and other issues. For those with this preference considering Postgres there is also a commercial Postgres derivative called EnterpriseDB.

...

Default data can be loaded through the "loadDefaultloadAll" Gradle target as mentioned in the Building from SVN section.

...