Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Open Engineering Service Bus, an easy-to-use engineering tool integration platform

README.md

OpenEngSB Framework

The OpenEngSB Framework is the underlying engine of the OpenEngSB implementing and wiring together all required concepts and tools to provide a common integration environment.

Build Status

How to build

  • 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

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.

Full Tests

Before creating a pull request, run the following command:

etc/scripts/pre-push.sh (or "mvn openengsb:prePush")

Further Information

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.

Something went wrong with that request. Please try again.