> Tutorials > Getting Started with the ALSB Tutorials

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 ALSB Tutorials

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

This topic consists of the following sections:

After completing this section, you will know how to deploy a typical ALSB 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 ALSB 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 ALSB 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 ALSB
  2. Create an ALSB Domain
  3. Change Domain Configuration Settings
  4. Start ALSB
  5. Build and Deploy Business Services
  6. Log into ALSB Consoles

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

BEA_HOME\alsb_3.0\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\alsb_3.0\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 ALSB

Install ALSB. For installation instructions, see AquaLogic Service Bus Installation Guide.

Create an ALSB Domain

To develop and run the ALSB tutorials, you must create an ALSB 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 BEA Products group from the Windows Start menu:

    2. Start > All Programs > BEA Products > 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 AquaLogic 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 username and password. You can use the default weblogic username, 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. Set the value for Listen Port to 7001.
      7. Figure 2-6 Configure the Administrator Server


      Configure the Administrator Server

    7. 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 ALSB

You can start ALSB using one of the following methods:

When ALSB 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 WLS console, which are available at {BEA_HOME}\alsb_3.0\samples\servicebus \examples\build\webservices. The following client jars are available:

To deploy creditLoan_jws_basic_ejb client jar:

  1. Click WLS Console on the dashboard to go to the WLS Console.
    1. In left pane click Lock and Edit in the Change Center.
    2. Click on Deployments in Domain Structure to go to the Summary of Deployments page (see Figure 2-8).
      3. Figure 2-8 Summary of Deployments


      Summary of Deployments

    3. Click Install. Use Install Application Assistant (see Figure 2-9) to install the client jar you want to deploy.
      4. Figure 2-9 Install Application Assistant


      Install Application Assistant

    4. Use this to navigate to BEA_HOME\alsb_3.0\samples\servicebus\examples\build\webservices
    5. Click the radio button associated with creditLoan_jws_basic_ejb (see Figure 2-10). Click Next to choose the targeting style.
      6. Figure 2-10 Choose Client Jar


      Choose Client Jar

    6. In Choose Targeting Style page accept defaults. Click Next.
      7. Figure 2-11 Choose Targeting Styles


      Choose Targeting Styles

    7. In Choose Targeting Style (see Figure 2-11) page accept defaults. Click Next to go to Optional Settings page.
    8. In Optional Settings (see Figure 2-12) page accept defaults and click Finish. Click Activate the Session.
      9. Figure 2-12 Optional Settings


      Optional Settings

  2. Click Lock and Edit to create a new session. In the Summary of Deployments page locate the client jar you have installed in Deployments table. Click on the radio button associated with the client jar and click Start. Choose Servicing all requests from the drop-down-list (see Figure 2-13).
    3. Figure 2-13 Deployments


    Deployments

  3. In Start Deployments page click Yes (see Figure 2-14).
    4. Figure 2-14 Start Deployments


    Start Deployments

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

You must repeat step 1 to step 3 to deploy largeLoan_jws_basic_ejb, manager_jws_basic_ejb, and normalLoan_jws_basic_ejb in the WLS console.

Log in to ALSB Console

ALSB Console is a web services management dashboard, which 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 ALSB environment by displaying detailed statistics about servers, services, and alerts. The ALSB Console also enables you respond rapidly and effectively to changes in your service-oriented environment.

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

    2. http://host:port/sbconsole

    where host:port represents the name and port number of the machine on which WebLogic Server is running. The default port for WLS is 7001.

    Enter http://localhost:7001/sbconsole URL in your browser to open the ALSB console for the Servicebustutorial domain.

  2. The ALSB Console login page is displayed. Enter the username and password that you specified when you created the ALSB tutorial domain.
Note: You can also open the ALSB Console from the Windows Start menu by selecting the following options:
Note: Start > All Programs > BEA Products > User Projects > Servicebustutorial > AquaLogic Service Bus Admin Console for ALSB 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 AquaLogic Service Bus with the resources required for the loan application routing scenario. Each of the tutorials include instructions to design and configure the ALSB resources, and procedures you can use to test the completed configurations.


  Back to Top       Previous  Next