Installing a Binary Distribution

Download Binary Distribution

Binary distributions have the filename format obe-<version>.[zip|tar|gz|bz2] . You can download them from SourceForge.

Installing OBE from a binary distribution

Using your favourite decompression utility (such as WinZip on Windows or Gnome File-Roller on Linux/Gnome) expand the compressed archive to a convenient location on your hard disk.  It will create the following directory structure:

Directory Use
obe-<version> The top-level directory, referred to as OBE_HOME .
bin
 Executable shell scripts
config
 Basic (non-J2EE) OBE configuration directory ($obe.config)
xml
 Runtime XML resources
etc
 Sundry resources
sql
 DDL scripts for various databases
examples
 OBE Examples
config
 Example OBE configuration directory
processes
 Example process definitions
resources
 Example runtime XML resources
docs
 Documentation on the examples
etc
 Sundry resources for running the examples
DataTransformation
 Resources for the Sales Order Processing workflow
NewEmployee
 Resources for the New Employee workflow
TravelBooking
 Resources for the Travel Bookings workflow
WfMCSample
 Resources for the WfMC Sample workflow
src
 Source code for the examples
j2ee
 J2EE resources
jboss
 JBoss support
conf
 JBoss configuration
deploy
 JBoss OBE resource definitions
jms
 JBoss JMS OBE destination definitions
lib
 OBE J2EE EAR, WAR archives
wls-7.0
 WebLogic 7.0 support
wls-8.1
 WebLogic 8.1 support
lib
 Runtime libraries and third party dependencies
license
 Third party licences
tests
 OBE unit tests and associated resources
classes
 JUnit test classes
config
 Test OBE configuration directory ($obe.config)
processes
 Test process definitions 1
resources
 Test resources 1
results
 Test results 1
html
 HTML summary of test results 1
1 These directories are created by running the tests.

Preparing the Staging Area

Before executing OBE you need to prepare the staging area. Preparation updates the shellscripts in the $OBE_HOME/bin directory to match your environment.
  1. Create a custom Java properties file containing any staging properties that you wish to override.
  2. Navigate to the OBE_HOME directory.
  3. Execute the following command:
Windows:        .\prepare [<custom-properties-file>]

Unix/Linux:   ./prepare [<custom-properties-file>]
followed by:   . bin/obeinit

This will create a $OBE_HOME/local.properties file and update various files in $OBE_HOME/bin. If you do not supply a custom properties file OBE will use defaults for all values. You can modify local.properties and re-run prepare at any stage.

Configuring the Clients and Server

Please follow the instructions for configuring the OBE clients, server and database.

J2EE Deployment

To deploy OBE to a J2EE application server simply copy or drag and drop the file $OBE_HOME/j2ee/lib/obeserver.ear into the application server's default auto-deploy directory.  For JBoss this is the $JBOSS_HOME/server/default/deploy directory.