Installing BPELUnit

BPELUnit contains various components and can be installed with a command line client, an Ant task, an Eclipse client, and tool support for writing the test specification files. Additionally, deployers can be installed for two BPEL engines. This page contains the installation instructions for all available components.

Please note that a BPELUnit installation for command line and Ant is always completely separate from an Eclipse client installation, meaning you can install just one of them or both. The tool support is dependent on the Eclipse client and therefore bundled with it, however, after installation it may be used separately from the client.

BPELUnit is written in Java 5. A Java Virtual Machine >=5.0 must thus be installed for BPELUnit to work.


Command Line and Ant

BPELUnit can be installed to be run from the command line, or from within an Ant script. The installation is the same for both clients.

To install BPELUnit for command line or ant usage, unzip the BPELUnit package somewhere on your disk. Add a BPELUNIT_HOME environment variable. The BPELUNIT_HOME variable must point to the base directory of the BPELUnit package (not to any bin or lib directory) and should carry a trailing slash.

The BPELUnit command line and ant package can be found at Sourceforge: Download Standalone Version

The installation is now ready for use.

Eclipse client and tool support

The Eclipse client and tool support consist of a set of plugins for Eclipse 3.2. Thus, Eclipse 3.2 must first be installed:

The Eclipse 3.2 distribution can be found here.

After Eclipse is installed, the BPELUnit plugins must be extracted into the Eclipse directory (the one which contains the features and plugins directories).

The BPELUnit Eclipse distribution can be found at Sourceforge: Download Eclipse Version

Unzip this file directly into the Eclipse directory and restart Eclipse.

Depending on your settings, the plugins may be recognized automatically. You can check this by trying to open the BPELUnit view. If it is not available, select Help > Software Updates > Manage Configuration. Select the Show Disabled Features Button (third from the left). Now, right-click on BPELUnit in the tree view and select Enable.

The installation is now ready for use.

Deployer Installation

BPELUnit comes with two deployers; one for the ActiveBPEL engine, and one for the Oracle BPEL PM server. While the ActiveBPEL deployer does not require any further installation, the Oracle deployer requires an installation before use.

The BPELUnit OracleUnDeployer is a small script/java app which deploys and undeploys processes to an Oracle BPEL server. The script is designed to live inside an Oracle BPEL Server installation, like the internal Oracle tools.To install the Oracle deployer, you must have the Oracle BPEL PM Server installed on your system. The Oracle UnDeployer was developed for Version 10.1.:

The Oracle BPEL PM server 10.1 can be found here.

After the Oracle BPEL PM server is installed, it resides in some directory on the local disk (identified in the following as $OraBPELPM). To install the Oracle UnDeployer, extract the ZIP file somewhere on disk:

The Oracle UnDeployer can be found at Sourceforge: Download Oracle UnDeployer

To install the OracleUnDeployer, the three files in the ZIP file must be integrated into the Oracle Server installation as follows:

Note that the bpeldeploy.bat is intended for Microsoft Windows Operating Systems. If you work on a different platform, you may need to change this script, which is rather simple, as the script only invokes the Java-based UnDeployer with all necessary libraries on the CLASSPATH. Have a look at the script for more information.