JBoss.orgCommunity Documentation

Chapter 1. Installation

1.1. Overview
1.2. Prerequisites
1.3. Installation Instructions

1.1.  Overview

This chapter provides details of the pre-requisites for using the RiftSaw BPEL project, and how to install the engine into a JBossAS environment.

The examples distributed with RiftSaw are split into two categories, quickstarts that are pure BPEL that can run directly in the JBossAS server, and ESB based examples that require JBossESB. If you only want to use the pure BPEL examples, then JBossESB will not be required.

1.2. Prerequisites

  1. JBossAS (version 5.1.GA or higher), available from http://www.jboss.org/jbossas
  2. JBossESB (version 4.6.GA or higher), should download the jbossesb-4.6.GA.zip, available from http://www.jboss.org/jbossesb. This is only required to run the ESB/BPEL example.
  3. RiftSaw (version 2.0-M1 or higher), available from http://www.jboss.org/riftsaw
  4. Ant, available from http://ant.apache.org

1.3. Installation Instructions

  1. Install JBossAS

    Unpack the JBossAS installation into the required location.

  2. Install JBossESB

    This is only required if you want to run the ESB/BPEL examples.

    Unpack the JBossESB installation into a location alongside the JBossAS installation. Then follow the instructions in the JBossESB installation (install/readme.txt), to deploy JBossESB into the JBossAS environment.

  3. Install the RiftSaw distribution

    Unpack the RiftSaw distribution into a location alongside the JBossAS installation.

    • Edit the install/deployment.properties file to update the JBossAS and JBossESB location settings.
    • From the install folder, run: ant deploy to deploy RiftSaw to JBossAS.
    • If JBossESB has been installed, then run: ant deploy-esb-examples to install the BPEL/ESB examples into the JBossESB samples/quickstart folder.