Architect: SOA
 Oracle Service Bus
 Projects Archive
 Resources Archive
SOA, Integration, Fusion, All Architect Articles

Jumpstart for Oracle Service Bus Development

by Ronald van Luttikhuizen and Eric Elzinga

Installation and Configuration Guide

Published October 2009

In this article:

  1. Introduction
  2. Installation and Configuration Guide
  3. Tutorial 1: First spin - Getting to know Oracle Service Bus by exposing a simple service
  4. Tutorial 2: New adapters
  5. Tutorial 3: Data enrichment

[ Page 1] [Page 2] [ Page 3] [ Page 4] [ Page 5]

Install Oracle Service Bus

Download and install Oracle Service Bus 10gR3 or later. This will install Oracle WebLogic Server, Oracle Service Bus, and Oracle Workshop for WebLogic. Oracle Service Bus runs on Oracle WebLogic Server. Oracle Workshop is the Eclipse-based IDE for developing OSB artifacts.

Installation instructions can be found at the Oracle Service Bus page on OTN.

Figure 1: Installing Oracle Service Bus

Create domain

We now continue to create a new domain called "waai". The Oracle Service Bus projects that are created in the tutorials will be deployed to this domain.

  1. Start the "Configuration Wizard" to create the new domain. The Configuration Wizard is located in <OSB_HOME>/wlserver_10.3/common/bin. Run config.exe (Windows) or (Unix).

  2. Select "Create a new WebLogic Domain" in the first step of the wizard and click "Next".

  3. Select the "Oracle Service Bus" option in the "Select Domain Source" window and keep all other defaults. Click "Next".
    Figure 2: Oracle WebLogic Configuration Wizard - Select Domain Source
  4. Enter "weblogic" as username and provide its password. Click "Next".

  5. Keep the default settings for development mode and JDK. Click "Next".

  6. Keep the default settings in the "Customize Environment and Services Settings" and click "Next".

  7. Enter "waai" as the domain name and select "Create".
    Figure 3: Oracle WebLogic Configuration Wizard - Create WebLogic Domain
    The domain "waai" will now be created.
    Figure 4: Oracle WebLogic Configuration Wizard - Creating Domain
  8. Start the newly created domain by running startWebLogic.cmd (Windows) or (Unix) located in <OSB_Home>/user_projects/domains/waai.

Let's continue by deploying the required resources using Oracle Workshop.

Oracle Workshop for WebLogic

Time to start Oracle Workshop.

  1. Choose a workspace location to store the Oracle Service Bus projects we will create in the tutorials. Click "Workbench" to open Oracle Workshop.
    Figure 5: Oracle Workshop for WebLogic
    The tutorials in this article will use several resources such as Web Services that we first need to import and deploy to the "waai" domain.

  2. Unzip the Resources Archive to your workspace directory. Import the projects by selecting File Import... General Existing Projects into Workspace from the menu. Browse to the workspace directory where you unzipped the resources archive. Keep all other defaults and click "Next". The following projects should be shown in the dialog: KlantWebService, KlantWebServiceEAR, MailClient, OrderWebService, and OrderWebServiceEAR.
    Figure 6: Importing existing projects in Oracle Workshop
    The MailClient project is a simple Java application used for testing purposes in the second tutorial while the other projects are JAX-WS Web Services that are used as resources in the OSB projects.

    Note that "klant" means customer in Dutch. Part of the tutorial is to create an OSB project that exposes the local Dutch service as global service for Foo Inc. and translates its content into the English canonical data model.

    Click "Finish". The projects are now listed in the "Project Explorer".

    Figure 7: Oracle Workshop after importing the projects

We need to configure a server connection in Oracle Workshop to deploy the imported resources to the "waai" domain.

  1. Select File New Other... from the menu. Select Server Server from the dialog and click "Next". This will open the "New Server" dialog.
    Figure 8: Defining a new server connection in Oracle Workshop
  2. Enter a name for the server connection. Keep the defaults -Oracle WebLogic Server v10.3- and click "Next".

  3. Enter the domain directory, which should be located in <OSB_Home>/user_projects/domains/waai- and click "Finish".
    Figure 9: Defining a new server connection in Oracle Workshop
  4. Deploy the required Web Services to the "waai" domain by right-clicking the KlantWebServiceEAR project in the "Project Explorer" and selecting Run As Run on Server . In the "Run on Server" dialog select the server connection that we just created and click "Finish". Repeat these steps for the OrderWebServiceEAR project.

The projects are deployed to the server. You should see the projects if you log into Oracle WebLogic Server Console; normally located at http://host:7001/console.

Figure 10: Oracle WebLogic Server Administration Console

The final configuration step in Oracle Workshop is to create a new Oracle Service Bus Configuration Project. Oracle Service Bus projects are associated with an Oracle Service Bus Configuration Project. An OSB Configuration Project is also used to create and contain resources for SMTP, UDDI, and so on that can be accessed by all projects in the configuration project.

  1. Select File New Other... from the menu. Select Oracle Service Bus ? Oracle Service Bus Configuration Project. Click "Next". Enter "OSB Configuration" as name and click "Finish".
    Figure 11: Creating a new Oracle Service Bus Configuration Project

The default location of the Oracle Service Bus Administration Console is http://host:7001/sbconsole. After logging in you'll be able to see all deployed Oracle Service Bus projects.

Figure 12: Oracle Service Bus Administration Console

You have now completed the initial configuration in Oracle Workshop by importing and deploying Web Service projects, configuring a server connection to the "waai" domain, and creating an Oracle Service Bus Configuration Project.

Mail server

Tutorial 2: New adapters requires access to a mail server. Install and configure a simple mail server such as Java Email Server (JES) if needed, and create the email address "". Installation and configuration instructions for JES can be found here.

You are now ready to start the tutorials!