This section describes the setup process required for OpenEngSB development.
If you would like to view a use-case centric tutorial take a look at the continuous integration example.
If you are already familiar with Java EE servers about 15 minutes. We will not be using advanced concepts, so you likely be able to continue with the tutorial even without it.
It is assumed you have basic knowledge of system administration and you are able to set up auxiliary software (i.e. JDK 1.6) youself.
First of all the JDK6 should be installed on the system and the JAVA_HOME variable should be set. (Java download).
Also, make sure that the java-command is available in the PATH-variable.
Download the latest OpenEngSB release from here.
Extract the archive, and run the openengsb-script (bin/openengsb.bat on windows, bin/openengsb otherwise). Click the following link to open the web interface in your browser http://localhost:8090/openengsb.You should automatically be directed to a page asking for a login. The default login is "admin" with "password" as password.
If everything works fine you should be welcomed by the following page presenting you the currently installed domains:
OpenEngSB implements it's functionality in so called features. Each feature contains a number of OSGi bundles. While all features are distributed with the OpenEngSB not all of them are installed to speed up the startup. For the next section (First Steps) it is required to install additional features. Therefore open the console in which you've started the OpenEngSB and enter "list" which should output something like:
karaf@root> list START LEVEL 100 , List Threshold: 50 ID State Blueprint Level Name [ 42] [Active ] [Created ] [ 60] Apache Karaf :: Shell :: Service Wrapper (2.2 ... [ 116] [Active ] [ ] [ 60] Jackson JSON processor (1.5.3) [ 117] [Active ] [Created ] [ 60] OpenEngSB :: Core :: Common (1.2.0.SNAPSHOT) [ 118] [Active ] [Created ] [ 60] OpenEngSB :: Core :: Events (1.2.0.SNAPSHOT) [ 119] [Active ] [Created ] [ 60] OpenEngSB :: Core :: Persistence Layer (1.2.0 [ 120] [Active ] [Created ] [ 60] OpenEngSB :: Core :: Security (1.2.0.SNAPSHOT [ 121] [Active ] [Created ] [ 60] OpenEngSB :: Core :: Workflow Engine (1.2.0.S [ 122] [Active ] [Created ] [ 60] OpenEngSB :: Domains :: Auditing :: Implement [ 123] [Active ] [Created ] [ 60] OpenEngSB :: Connector :: MemoryAuditing (1.2 [ 124] [Active ] [Created ] [ 60] OpenEngSB :: Domain :: Example (1.2.0.SNAPSHO [ 125] [Active ] [Created ] [ 60] OpenEngSB :: Connector :: Example (1.2.0.SNAP [ 126] [Active ] [Created ] [ 60] OpenEngSB :: Core :: Ports :: JMS (1.2.0.SNAP [ 127] [Active ] [Created ] [ 60] OpenEngSB :: User Interface :: Common (1.2.0. [ 128] [Active ] [ ] [ 60] OpenEngSB :: User Interface :: Administration [ 129] [Active ] [Created ] [ 60] OpenEngSB :: Core :: Deployer :: Connector (1
To find out about all installable features simple type features:install openengsb-connector-TAB while TAB indicates that you hit your tab key. This should present something like:
karaf@root> features:install openengsb-connector- openengsb-connector-git openengsb-connector-jira openengsb-con openengsb-connector-plaintextreport openengsb-connector-trac openengsb-con
For the next example we require the openengsb-connector-email feature. Type features:install openengsb-connector-email and validate the result by entering "list" again:
karaf@root> features:install openengsb-connector- karaf@root> features:install openengsb-connector-email karaf@root> list START LEVEL 100 , List Threshold: 50 ID State Blueprint Level Name [ 42] [Active ] [Created ] [ 60] Apache Karaf :: Shell :: Service Wrapper (2.2 ... [ 117] [Active ] [Created ] [ 60] OpenEngSB :: Core :: Common (1.2.0.SNAPSHOT) [ 118] [Active ] [Created ] [ 60] OpenEngSB :: Core :: Events (1.2.0.SNAPSHOT) [ 119] [Active ] [Created ] [ 60] OpenEngSB :: Core :: Persistence Layer (1.2.0 [ 120] [Active ] [Created ] [ 60] OpenEngSB :: Core :: Security (1.2.0.SNAPSHOT [ 121] [Active ] [Created ] [ 60] OpenEngSB :: Core :: Workflow Engine (1.2.0.S [ 122] [Active ] [Created ] [ 60] OpenEngSB :: Domains :: Auditing :: Implement [ 123] [Active ] [Created ] [ 60] OpenEngSB :: Connector :: MemoryAuditing (1.2 [ 124] [Active ] [Created ] [ 60] OpenEngSB :: Domain :: Example (1.2.0.SNAPSHO [ 125] [Active ] [Created ] [ 60] OpenEngSB :: Connector :: Example (1.2.0.SNAP [ 126] [Active ] [Created ] [ 60] OpenEngSB :: Core :: Ports :: JMS (1.2.0.SNAP [ 127] [Active ] [Created ] [ 60] OpenEngSB :: User Interface :: Common (1.2.0. [ 128] [Active ] [ ] [ 60] OpenEngSB :: User Interface :: Administration [ 129] [Active ] [Created ] [ 60] OpenEngSB :: Core :: Deployer :: Connector (1 [ 130] [Active ] [Created ] [ 60] OpenEngSB :: Domain :: Notification (1.2.0.SN [ 131] [Active ] [Created ] [ 60] OpenEngSB :: Connector :: Email (1.2.0.SNAPSH [ 132] [Active ] [ ] [ 60] Apache ServiceMix :: Bundles :: mail (1.4.1.3
Now that the OpenEngSB is up and running (and all required bundles are installed) start with the first integration tutorial.