-
Install JDK 6 or higher
You can install Oracle JDK or OpenJDK depending on the OS you use. Other JVM implementations should also work, but are untested.
-
Install Maven 3 or higher
Be sure to follow the provided installation instructions
-
configure JAVA_HOME and PATH environment variables
make sure the JAVA_HOME environment variable points to the path of your JDK installation and that both javac and mvn are available in your PATH-variable
-
Make sure you have at least 500MB of free space in your home-directory
By default all external dependencies required for the build are downloaded to your home-directory ($HOME/.m2/repository or %HOME%.m2\repository). You can configure the path of this directory as described in the Maven Configuration Guide
-
Make sure that enough memory is available to maven during the build-process
Therefore set the MAVEN_OPTS environment variable to "-Xmx2048m -XX:MaxPermSize=512m".
-
Run mvn install from the project's root directory
This might take some time depending on your internet connection and hardware configuration (maybe about 30 min)
That's it. You can find the distributable zip-archive at assembly/target/openengsb-framework-<version>.zip. It contains all binaries and third party dependencies required to run the openengsb-framework in Windows or *nix environments. To run the openengsb-framework distribution you need to extract the zip-archive and execute the corresponding startup-script in the distribution's bin-directory (openengsb.bat for Windows, openengsb for *nix OS).
To get started with domains and connectors that are already available, have a look at http://openengsb.org/index/download.html
Scripts which help you to create projects, run the workspace and so on are stored in a separated script folder (etc/scripts). Its not required to use them but they may help you with your effort.
Before creating a pull request, run the following command:
etc/scripts/pre-push.sh (or "mvn openengsb:prePush")
This readme gives only the most important information for developer. General information about this project is located at http://openengsb.org. The detailed developer and user documentation is located at http://openengsb.org/index/documentation.html.