Tutorials

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Getting Started with the Oracle Service Bus Tutorials

The Oracle Service Bus tutorials are based on a typical Web services scenario that uses Oracle Service Bus for configuring business services and adaptive message routing. This section describes the tasks required to configure the Oracle Service Bus and Weblogic Server environment to deploy the business cases used in the tutorials. The Oracle Service Bus example suite is used as a basis for instruction in the following tutorials. (See Oracle Service Bus Examples).

This topic consists of the following sections:

After completing this section, you will know how to deploy a typical Oracle Service Bus environment in which you can define resources and design Web services. You must complete all the tasks in this section before you start the tutorials.

 

Scenarios in the Tutorials

The tutorials are based on a mortgage broker scenario describing a typical loan application process. A primary mortgage company uses Oracle Service Bus to route loan applications to appropriate business services. The loan applications are routed to different business services depending on qualifying criteria, such as the requested interest rate and the requested principal amount. The applicant’s credit rating information is required to complete the loan application when the principal amount is greater than US $25 million.

In the first tutorial, you will become familiar with the basic functionality of Oracle Service Bus that facilitates Web service mediation, including message routing and Web service resource creation. In subsequent tutorials you will develop and customize Web services for routing, transforming and validating a loan application.

 

Setting Up the Tutorials

Do the following to set up and run the tutorials:

  1. Install Oracle Service Bus
  2. Create an Oracle Service Bus Domain
  3. Change Domain Configuration Settings
  4. Start Oracle Service Bus
  5. Build and Deploy Business Services
  6. Log into Oracle Service Bus Consoles

The files (including pre-built business services) that support the building of the tutorial solutions are located in the following directory:

BEA_HOME\osb_10.3\samples\servicebus\examples

The tutorial files contain properties that you must set to run the tutorials. In the tutorial, you can use four different business services. Each business service also has a set of files associated with it. The structure for each of the business services is the same.

The directory structure for one of the business services– the NormalLoan business service, is described in Table 2-1. You can explore the other directories as an exercise.

Table 2-1 Sample Files Provided in Support of the Tutorials
Filename/Location
Description
/src/setEnv.cmd
This file sets the environment properties.
/src/examples.properties
This file contains business service build and deployment properties.
For each business service:
BEA_HOME\osb_10.3\samples\
servicebus\examples\src\
examples\webservices\
jws_basic\normal
The files contained in this directory are those required by the normalLoan business service. The same file structure exists for the other three business services used in this tutorial (ManagerLoanReview, LoanSaleProcessor, and CreditRating).
SimpleBean.java
The jws-181 Web service definition.
/client/LoanStruct.java
The definition of the message.
build.xml
The build script that is used to build each of the services using ant.
*.wsdl
A Web service Definition Language (WSDL) file defines each of the services.
/client/Main.java
The Java client with which each of the business services interacts.

Install Oracle Service Bus

Install Oracle Service Bus. For installation instructions, see Oracle Service Bus Installation Guide.

Create an Oracle Service Bus Domain

To develop and run the Oracle Service Bus tutorials, you must create an Oracle Service Bus domain using the Configuration Wizard. You can invoke the Configuration Wizard in the graphical mode or console mode. For this tutorial, you will start the Configuration Wizard in graphical mode.

  1. To start the Configuration Wizard in graphical mode, choose the Configuration Wizard option in the Oracle WebLogic group from the Windows Start menu:

    2. Start > All Programs > Oracle WebLogic > WebLogic Server 10gR3 > Tools > Configuration Wizard

  2. Using the Configuration Wizard, select the following product components:
    1. In the Welcome page, the Create a new WebLogic domain radio button is selected by default. Accept the default selection and click Next.
      2. Figure 2-1 Configuration Wizard - Create Domain Option


      Configuration Wizard - Create Domain Option

    2. In the Select Domain Source page, select Oracle Service Bus check box. Click Next.
      3. Figure 2-2 Configuration Wizard - Select Domain Source


      Configuration Wizard - Select Domain Source

    3. In the Configure Administrator Username and Password page, configure a new administrator user name and password. You can use the default weblogic user name, but you must create a unique password. Click Next to proceed to the Configure Server Start Mode and JDK page.
      4. Figure 2-3 Configuration Wizard - Create Username and Password


      Configuration Wizard - Create Username and Password

    4. In the Configure Server Start Mode and JDK page, Development Mode is selected as the default startup mode for the WebLogic domain. Accept the default settings and click Next.
      5. Figure 2-4 Configure Server Start Mode and JDK


      Configure Server Start Mode and JDK

    5. In the Customize Environment and Services Settings page, the default customization option for the environment and services settings is No. Click Yes to change the Listen Port in Configure the Administrator Server.
      6. Figure 2-5 Customize Environment and Service Settings


      Customize Environment and Service Settings

    6. Click Next in the Configure RDBMS Security Store Database window.
    7. Set the value for Listen Port to 7001.
      8. Figure 2-6 Configure the Administrator Server


      Configure the Administrator Server

    8. Click Next to proceed Configure Managed Servers page. Accept the default options for:
    • Configure Managed Server
    • Configure Machines
    • Configure JDBC Data Sources
    • Run Database Scripts
    • Configure JMS Stores

      • Click Next on Review WebLogic Domain to go to Create WebLogic Domain page.

    1. In the Create Weblogic Domain page specify the domain name as ServiceBusTutorial. Click Create.
      2. Figure 2-7 Configuration Wizard - Create Weblogic Domain


      Configuration Wizard - Create Weblogic Domain

    2. When the domain is created successfully, Do not click Start Admin Server. Click Done to finish.

Start Oracle Service Bus

You can start Oracle Service Bus using one of the following methods:

When Oracle Service Bus is started, a server command console window will display status information about WebLogic Server.

Note: A valid username and password is required to start the server, if a production mode domain is used. For more information about creating and configuring domains, see Creating WebLogic Domains Using the Configuration Wizard.

Load the Client Application

To test the loan application using the test console, you must first deploy the client jars in the WebLogic Server Administration Console, which are available at {BEA_HOME}\osb_10.3\samples\servicebus \examples\build\webservices. The following client jars are available:

To deploy creditLoan_jws_basic_ejb client jar:

  1. Go to the WebLogic Server Administration Console: http://localhost:7001/console.
  2. On the Home page, click Deployments to go to the Summary of Deployments page (see Figure 2-8).
    3. Figure 2-8 Summary of Deployments


    Summary of Deployments

    1. Click Install.
    2. Navigate to BEA_HOME\osb_10.3\samples\servicebus\examples\build\webservices
    3. Select creditLoan_jws_basic_ejb. Click Next to choose the targeting style.
    4. In Choose Targeting Style page accept defaults (deploy as an application). Click Next to go to Optional Settings page.
    5. In Optional Settings page accept defaults and click Finish. The application is deployed automatically.

Repeat the previous steps to deploy largeLoan_jws_basic_ejb, manager_jws_basic_ejb, and normalLoan_jws_basic_ejb in the WebLogic Server console.

For more information on deploying and starting client jars in WebLogic Server console, see Enterprise Applications in Administration Console Online Help.

Log in to Oracle Service Bus Console

Oracle Service Bus Console is a Web services management dashboard that allows you to monitor Web services and servers and perform service management tasks. The console enables you to perform operational tasks such as configuring proxy and business services, setting up security, managing resources, and capturing data for tracking or regulatory auditing. It provides views to monitor current state and health of the Oracle Service Bus environment by displaying detailed statistics about servers, services, and alerts. The Oracle Service Bus Console also enables you respond rapidly and effectively to changes in your service-oriented environment.

To log in to Oracle Service Bus Console
  1. Open a browser window and enter the following URL:

    2. http://host:port/sbconsole

    Enter http://localhost:7001/sbconsole URL in your browser to open the Oracle Service Bus Console for the ServiceBusTutorial domain. Log in if necessary with Oracle Service Bus Console the user name and password that you specified when you created the Oracle Service Bus tutorial domain.

Note: You can also open the Oracle Service Bus Console from the Windows Start menu by selecting the following options:
Note: Start > All Programs > Oracle WebLogic > User Projects > ServiceBusTutorial > Oracle Service Bus Admin Console for Oracle Service Bus Admin Console.

Where to Go from Here

After you complete the tasks required to set up the tutorials, you can proceed to Tutorial 1. Routing a Loan Application, which describes how you can configure Oracle Service Bus with the resources required for the loan application routing scenario. Each of the tutorials include instructions to design and configure the Oracle Service Bus resources, and procedures you can use to test the completed configurations.


  Back to Top       Previous  Next