JBoss.orgCommunity Documentation

Chapter 1. Installation

1.1. Overview
1.2. Prerequisites
1.3. Installation Instructions
1.3.1. Available databases and how to configure them
1.3.2. Upgrade web service for JBoss AS

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.0.GA or higher) jdk6 version, available from http://www.jboss.org/jbossas, and please upgrade the web service stack to version 3.2.2.GA, as described in the following 'Upgrade web service for JBoss AS' section.
  2. JBossESB (version 4.7.GA or higher), should download the jbossesb-4.7.GA.zip, available from http://www.jboss.org/jbossesb. This is only required to run the ESB/BPEL example.
  3. RiftSaw (version 2.0 or higher), available from http://www.jboss.org/riftsaw
  4. Ant, available from http://ant.apache.org

1.3. Installation Instructions

Note

If you have previously installed RiftSaw-2.0-M1, then you will need to undeploy this version using the ant undeploy command from the install folder of the M1 distribution. This is due to database schema changes.

  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 -Ddatabase=.... to deploy RiftSaw to JBossAS. The list of available databases, and how they should be configured, is explained in the following sub-section.
    • If JBossESB has been installed, then run: ant deploy-esb-examples to install the BPEL/ESB examples into the JBossESB samples/quickstart folder.

To de-install the RiftSaw distribution,

  1. Uninstall the RiftSaw distribution

    • From the install folder, run: ant undeploy -Ddatabase=.... to remove RiftSaw from JBossAS. The database option should specify the same value used during installation of RiftSaw.
    • If JBossESB has been installed, then run: ant undeploy-esb-examples to remove the BPEL/ESB examples from the JBossESB samples/quickstart folder.

Tip

In the Hsql database environment, if you install the RiftSaw, we will copy the h2 library into JBoss AS server. But when you undeploy the RiftSaw, we won't delete it. The reason for doing this is because the JBoss ESB or jBPM will use the h2 database also, if we remove the h2 database in the undeployment process, we might cause JBoss ESB or jBPM start failed. So if you want to remove the h2 database, please go to the $JBossAS/server/${config} (like default)/lib, and then remove it manually.

The following "in-memory" databases are available. If just evaluating the capabilities of RiftSaw, it is recommended that one of these options is used to reduce the time taken to get RiftSaw up and running.

  1. hsql

Other databases available, that require further configuration details, include:

  1. mysql
  2. postgres
  3. oracle
  4. sqlserver

The configuration properties for these database options can be found in the ${RiftSaw}/db/jdbc folder. These properties need to be specified before executing the ant deploy -Ddatabase=... command.

If you want to upgrade the web service stack for JBoss AS, in the ${RiftSaw}/install folder, just run command as following: ant deploy -Ddatabase=... -Dws.stack=... -Dws.version=... It will help you download the web service stack, and then upgrade it for JBoss AS.