User Guide

Introduction to AquaLogic Service Bus

Overview of AquaLogic Service Bus

Document Scope and Audience

Document Organization

Modeling Message Flow in AquaLogic Service Bus

About AquaLogic Service Bus Message Flow

Building a Message Flow

Message Execution

Pipelines

Branching in Message Flows

Operational Branching

Conditional Branching

Performing Transformations

Transformations and Publish Actions

Transformations and Route Nodes

Configuring Single and Multiple Stages in Pipelines

Communication

Flow Control

Message Processing

Reporting

Using Multiple Stages

Handling Errors

Generating the Error Message, Reporting, and Replying

Example of Action Configuration in Error Handlers

Selecting a Service Type

Using a WSDL to Define a Service

SOAP Document Wrapped Web Services

SOAP Document Style Web Services

SOAP RPC Web Services

Binding a Service to a WSDL Port Instead of to a Binding

Using Any SOAP or Any XML Service Types

Using the Messaging Service Type

Viewing Resource Details

Using Dynamic Routing

Sample XML File

Creating an XQuery Resource From the Sample XML

Creating and Configuring the Proxy Service to Implement Dynamic Routing

Understanding Message Context

Message Context Components

Guidelines for Viewing and Altering Message Context

Copying JMS Properties From Inbound to Outbound

Working with Variable Structures

Using the Inline XQuery Expression Editor

Using Variable Structures

Creating Variable Structure Mappings

Sample WSDL

Creating the Resources You Need for the Examples

Save the WSDL as a Resource

Create a Proxy Service That Uses the Sample WSDL

Build a Message Flow for the Sample Proxy Service

Create a Business Service That Uses the Sample WSDL

Example 1: Selecting a Predefined Variable Structure

Example 2: Creating a Variable Structure That Maps a Variable to a Type

Example 3: Creating a Variable Structure that Maps a Variable to an Element

Example 4: Creating a Variable Structure That Maps a Variable to a Child Element

Quality of Service

Delivery Guarantees

Overriding the Default Element Attribute

Delivery Guarantee Rules

Threading Model

Splitting Proxy Services

Outbound Message Retries

Content Types, JMS Type, and Encoding

Throttling Pattern

WS-I Compliance

WS-I Compliance Checks

Monitoring

Monitoring Scenarios

Operational Health

Monitoring Alerts

Monitoring Statistics

Verifying Service Level Agreements

Pipeline Alert Action

Alert Destination

AquaLogic Service Bus Console

E-mail Alert Destination

SNMP Traps

Managed Resource

Management Information Base(MIB)

An Illustration of WebLogic Server MIB

SNMP Agent

SNMP Manager

Network Management System (NMS)

JMS

Reporting

About Monitoring

Aggregation Interval

Monitoring Architecture

Monitoring Services

Refresh Rate of Monitored Information

Dashboard

Service Summary

About the Service Summary

Service Monitoring Summary

Service Monitoring Details

Server Summary

About the Server Summary

Log Summary

Server Summary

Server Details

Alert Summary

About the Alert Summary

Pipeline Alerts

Service Level Agreement Alerts (SLA)

System Alerts History

System Alert Details

View Alert Rule Details

Alert Rules

About Alert Rules

Some Uses for Alerts

Understanding Alert Rules

Statistics Associated With Different Resources

SERVICE

FLOW_COMPONENT

WEBSERVICE_OPERATION

Auditing

Configuration Change Auditing

Runtime Auditing of Messages

Security Auditing

Using the Test Console

Features

Prerequisites

Testing Proxy Services

Direct Calls

Indirect Calls

HTTP Requests

Testing Business Services

Transport Security

Recommended Approaches to Testing Proxy and Business Services

Tracing Proxy Services Using the Test Console

Example: Testing and Tracing a Proxy Service

Testing Resources

MFL

XSLT

XQuery

Performing In-line XQuery Testing

Testing Services With Web Service Security

Test Console Transport Settings

Reporting

Reporting Scenarios

Message Tracking

Search for a Particular Message

Logging for Regulatory Auditing

Alert Reporting Provider

Reporting Framework

JMS Reporting Provider

About the JMS Reporting Provider

How to Enable Message Reporting

Using the Reporting Module

Summary of Messages

View Message Details

Purging Messages

Configuring a Database for the JMS Reporting Provider Store

Configuring a Database in a Development Environment

Configuring a Database for Production

Removing, Stopping, or Untargeting a Reporting Provider

Stopping a Reporting Provider when the Server is Running

Untargeting a Reporting Provider when the Server is Running

Untargeting the JMS Reporting Provider—Server Not Running

Tracing

To Enable Tracing

UDDI

Overview of BEA AquaLogic Service Bus and UDDI

Basic Concepts of the UDDI Specification

Benefits of Using a UDDI Registry with AquaLogic Service Bus

Introduction to UDDI Entities

Prerequisites

Certification

Features

What is the BEA AquaLogic Service Registry?

Sample Business Scenario for AquaLogic Service Bus and UDDI

Basic Proxy Service Communication with a UDDI Registry

Cross-Domain Deployment in AquaLogic Service Bus

Using AquaLogic Service Bus and UDDI

UDDI Workflow

Configuring a Registry

Publishing a Proxy Service to a UDDI Registry

Using Auto-Publish

Importing a Service from a Registry

Using Auto-Import

Mapping AquaLogic Service Bus Proxy Services to UDDI Entities

UDDI Mapping Details for an AquaLogic Service Bus Proxy Service

Transport Attributes

Service Type Attributes

Canonical tModels Supporting AquaLogic Service Bus Services

Example

Transports

E-mail

Configuring Proxy Services using E-mail Transport Protocol

Configuring Business Services using E-mail Transport Protocol

EJB

File

Configuring Proxy Services using File Transport Protocol

Configuring Business Services using File Transport Protocol

FTP

Configuring Proxy Services using FTP Transport Protocol

Configuring Business Services using FTP Transport Protocol

HTTP

Configuring Proxy Services using HTTP Transport Protocol

Configuring Business Services using HTTP Transport Protocol

HTTP(S)

Configuring Proxy Services using HTTP(S) Transport Protocol

Configuring Business Services using HTTP(S) Transport Protocol

JMS

Configuring Proxy Services using JMS Transport Protocol

Configuring Business Services using JMS Transport Protocol

Local

Tuxedo

EJB Transport

Introduction

Invoking EJBs from AquaLogic Service Bus

Register a JNDI Provider Resource

Adding a JNDI Provider

Register an EJB Client JAR Resource

Adding a Client JAR

Create a Service Account (Optional)

Locate an EJB in the JNDI Tree

Create an EJB Business Service

General Configuration

EJB Transport-Specific Configuration

EJB Business Service Interface Configuration

Invoking EJB Business Services

Exposing EJBs as Web Services

Advanced Topics

Transaction Processing, Retries, and Errors Handling

Transactions

Retries and Failover

Error Handling

Supported Types and Converter Class

Converter Classes

Troubleshooting

Local Transport

Introduction

Features and Characteristics of Local Transport Proxy Services

Usage of Local Transport Proxy Services

Limitations

Extensibility Using Java Callouts and POJOs

Usage Guidelines

Best Practices

Tuning AquaLogic Service Bus

Debugging AquaLogic Service Bus

XQuery Implementation

Supported Function Extensions from AquaLogic Data Services Platform

Function Extensions from AquaLogic Service Bus