Getting Started With JBoss ESB

JBESB-GS-9/22/06

 

 

 

 

 

 

 

 

 

 

 

 

Legal Notices

The information contained in this documentation is subject to change without notice.

JBoss Inc. makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. JBoss Inc. shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.

Java� and J2EE is a U.S. trademark of Sun Microsystems, Inc. Microsoft� and Windows NT� are registered trademarks of Microsoft Corporation. Oracle� is a registered U.S. trademark and Oracle9�, Oracle9 Server� Oracle9 Enterprise Edition� are trademarks of Oracle Corporation. Unix is used here as a generic term covering all versions of the UNIX� operating system. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Limited.

Copyright

JBoss, Home of Professional Open Source Copyright 2006, JBoss Inc., and individual contributors as indicated by the @authors tag.  All rights reserved.

See the copyright.txt in the distribution for a full listing of individual contributors. This copyrighted material is made available to anyone wishing to use, modify, copy, or redistribute it subject to the terms and conditions of the GNU General Public License, v. 2.0. This program is distributed in the hope that it will be useful, but WITHOUT A WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

See the GNU General Public License for more details. You should have received a copy of the GNU General Public License, v. 2.0 along with this distribution; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

Software Version

JBoss ESB 4.0 Beta 1

Restricted Rights Legend

Use, duplication, or disclosure is subject to restrictions as set forth in contract subdivision (c)(1)(ii) of the Rights in Technical Data and Computer Software clause 52.227-FAR14.

� Copyright 2006 JBoss Inc.

 

Contents

What This Guide Contains........................... 4

Audience....................................................... 4

Prerequisites................................................. 4

Organization................................................ 4

Documentation Conventions........................ 5

Additional Documentation........................... 5

Contacting Us.............................................. 5

Chapter 1..................................................... 6

Overview...................................................... 6

Prerequisites............................................... 6

Java........................................................... 6

Apache Ant................................................ 6

PostgreSQL Database................................ 7

JBoss Application Server............................ 7

Downloading JBoss ESB............................ 7

Building JBoss ESB.................................... 8

Configuring the JBossESB Environment..... 8

Building the Jars and Deploying the EAR to JBoss AS          11

Creating the JBoss ESB Database............ 12

A Simple Standalone Test Example.......... 13

Chapter 2................................................... 17

Overview.................................................... 17

 

About This Guide

The goal of this book is assist you in getting up and running with test applications on JBoss ESB as quickly as possible.  At the time of this writing, JBoss ESB was in beta release. 

This guide is anyone who is responsible for using JBoss ESB 4.0 Beta 1 installations and wants to know how to install and use it.

None.

This guide contains the following chapter:

1.     Chapter 1, Installation: This chapter reviews Prerequisites (software needed to operate JBoss ESB), Downloading JBoss ESB, and Building JBoss ESB.
Documentation Conventions

The following conventions are used in this guide:

Table 1      Formatting Conventions

In addition to this guide, the following guides are available in the JBoss ESB 4.0 Beta 1 documentation set:

1.     JBoss ESB 4.0 Beta 1 Programmer�s Guide:  Provides guidance for writing applications.

2.     JBoss ESB 4.0 Beta 1 TrailBlazer Guide: Provides a guide to understanding, configuring, deploying and running the LoanBroker TrailBlazer.

3.     JBoss ESB 4.0 Beta 1 Configuring Hypersonic Guide: This is necessary for setting up the Hypersonic database if you want to use it within the trailblazer.

Questions or comments about JBoss ESB 4.0 Beta 1 should be directed to our support team.

Chapter 1           

Installation

JBoss Enterprise Service Bus (JBoss ESB) is being maintained as source code while in beta.  This will offer you, the user, the opportunity to keep current with the status of changes as made from feedback from you.  Consequently, it is important for you to have the appropriate Java development environment in place.

Prerequisites

Java

Before you download and run JBoss ESB make sure you have an up-to-date version of Java on your machine.  JBoss ESB requires Java 5 for overall performance and the ability to work with the newer EJB3/Java EE 5 technologies. A full JDK install is not required to run JBoss ESB, but you will need a full JDK to build and run the JBoss ESB sources and examples.

We recommend JDK version 1.5.0.06.  This version is available from the Sun website.

Before getting started, make sure you have an appropriate JDK installed and that your JAVA_HOME environment variable is set to the directory where you installed Java.

Apache Ant

The building of JBoss ESB is enabled through the use of Apache Ant.  The use of Ant will make building JBoss ESB easy.

We recommend Ant version 1.6.5.  This version is available from the Apache Ant website.

Before getting started, make sure you have the appropriate version of Ant installed and that your ANT_HOME environment variable is set to the directory where you installed Ant.

In addition, if you are building JBoss ESB from the command line, put the path ANT_HOME/bin into your environment�s �path�.

PostgreSQL Database

You may certainly utilize any database platform you wish, provided it is supported by JBoss.  However, subsequent steps will employ the PostgreSQL database.

We recommend PostgreSQL version 8.1.3.  This version is available from the PostgreSQL website.

We have provided pg74.216.jdbc2ee.jar in the conf/lib folder and you can use that one for testing purposes.

The recommended PostgreSQL is JDBC 2 EE 8.1 Build 407.  This version is available from the PostgreSQL JDBC website.

Be sure and add the full path to the PostgreSQL_HOME/bin directory to your PATH environment variable.

JBoss Application Server

Because JBoss ESB includes Enterprise Java Bean version 3 (EJB3) support, make sure you have the generally-available 4.0.4 release of JBoss Application Server (JBoss AS) installed.

JBoss Application Server (JBoss AS) is available as a free download from the JBoss website. 

We recommend downloading and installing jboss-4.0.4.GA-Patch1-installer.jar.  During the installation of JBoss AS, be sure and select the EJB3 radio button in order to have EJB3 support.

Before getting started, make sure you have the appropriate version of JBoss AS installed and that your JBOSS_HOME