Oracle BAM 11gR1 Handbook

Table of Contents

Oracle BAM 11gR1 Handbook

Credits

Foreword

About the Author

Acknowledgement

About the Reviewers

www.PacktPub.com

Support files, eBooks, discount offers and more

Why Subscribe?

Free Access for Packt account holders

Instant Updates on New Packt Books

Preface

What this book covers

What you need for this book

Who this book is for

Conventions

Reader feedback

Customer support

Downloading the example code

Errata

Piracy

Questions

1. BAM 11gR1 Architecture

Oracle BAM key concepts

Data Object

ViewSet

View

Snapshot

Active Data

ChangeList

BAM 11gR1 architecture

Architecture overview

BAM server components

Active Data Cache

Persistence

Maintaining BAM artifacts

Managing data models

Processing Active Data

Messaging framework

Enterprise Message Sources

Report Cache

Event Engine

Report Server

BAM web applications

Understanding message flow

Opening a report for the first time

Processing Active Data

Summary

2. Designing Your First Data Objects and Reports

Designing your first Data Objects

Getting started with the BAM Architect web application

Creating subfolders

Data Object design considerations

Understanding the mappings between Data Objects and internal database tables

Creating your first Data Object using BAM Architect

Extending your Data Object with calculated fields

Extending your Data Object with lookup fields

Understanding how lookup works in BAM

Creating a lookup Data Object

Adding lookup fields in Data Objects

Using external Data Objects

Creating external data sources

Creating external Data Objects

Using ICommand to import Data Objects

Configuring ICommand

Setting up environment variables

Running ICommand

Building your first report

Creating your first report using the 3D bar chart View

Editing View properties

Viewing your first report

Summary

3. Populating Data Objects with Real-time Data

Using the Oracle BAM Adapter

Configuring the Oracle BAM Adapter

Using the Oracle BAM Adapter in SOA composites

Creating a BAM Server connection

Using the Oracle BAM Adapter in an SOA composite

Sending data to BAM through the Oracle BAM Adapter

Enabling batching

How to enable batching

Configuring batching properties

Using BPEL sensors

Using a BAM Sensor Action

Using Enterprise Message Sources

Creating an EMS

Configuring JMS Server connection properties

Configuring JMS message consumption properties

Configuring Data Object operation properties

Configuring other properties

A case study

XML formatting

Source value formatting (optional)

Configuring XML to Data Object mapping

Testing EMS

Testing EMS Using WebLogic Server console

Transaction and fault handling

Using Oracle BAM Web services

DataObjectOperationsByName Web service overview

Using the DataObjectOperationsByName web service

Summary

4. Designing BAM Reports

Designing a report that contains a single View

Specifying Data Objects and fields

Performing data manipulation tasks

Adding filters

Creating a filter expression

Defining parameters

Configuring surface prompts

Adding calculated fields

Editing View properties

Extending your report to include multiple Views

Driving from a master view to a detail view

Creating a detail View

Enabling driving

Adding a Gauge View

Adding a Chart View

Enabling BAM alerts

Creating a BAM alert

Configuring User Messaging Service

Summary

5. Testing BAM Applications

Introducing BAM testing methodologies

Developing a test strategy

Developing a test plan

Developing test cases

Testing BAM Data Objects

Preparing test data

Testing data mappings and transformations

Testing XML to Data Object mappings

Testing XML transformations

Testing calculated and lookup fields

Testing calculated fields

Testing lookup fields

Testing BAM report Views

Testing View data

Testing View properties

Performing end-to-end testing

Testing Active Data processing

Performing load testing

Generating a load

Monitoring performance

Analyzing results

Identifying closed connections

Identifying performance bottlenecks for report loading

Identifying Active Data processing issues

Summary

6. Managing BAM Securities

Managing BAM authentication

Managing users and groups

Using an external LDAP server with BAM

Creating a new Authentication provider

Reordering Authentication providers

Performing BAM specific configuration

Managing BAM authorization

Managing application roles

Adding a new user or group to an application role

Managing BAM policies

Configuring SSL for BAM

Preparing a server certificate

Configuring SSL for the WebLogic Server

Disabling hostname verification (optional)

Enabling SSL for BAM

Enabling SSL for ICommand

Summary

7. Migrating BAM to a Different Environment

Cloning Oracle BAM

Cloning a Middleware home

Creating an archive of a Middleware home

Copying required files

Extracting the archive in a target system

Cloning a WebLogic Server domain for BAM

Creating an archive of a WebLogic Server domain for BAM

Extracting move plans

Editing move plans

Extracting the archive in a target system

Performing additional configurations and testing

Performing data migration

Migrating BAM data using database commands

Migrating BAM data using ICommand

Using the EXPORT command

Using the IMPORT command

Performing additional configurations

Summary

8. Configuring High Availability for BAM

Preparing your HA environment

Configuring databases

Installing database schemas for SOA/BAM

Setting up database parameters

Granting transactional recovery privileges

Choosing the recommended WebLogic Server topology

Enabling IPs and VIPs

Configuring shared storage and domain structures

Understanding Fusion Middleware home directory structure

Managing the WebLogic Server domain directories

Configuring a shared storage

Creating the oracle user

Creating NFS shares

Mounting shared directories

Verifying NFS mounts

Configuring a WebLogic Server domain for BAM HA

Configuring a WebLogic Server base domain

Creating a WebLogic Server domain

Starting the Administration Server

Propagating domain directories

Disabling hostname verification for the Administration Server and the Managed Servers

Starting the Node Manager

Starting the Managed Servers

Applying the Java Required Files (JRF) template to WSM_Cluster

Performing a backup operation

Extending the base domain to include BAM

Extending the domain to include BAM

Performing additional configurations for the BAM domain

Configuring a JMS persistence store for BAM

Configuring a persistence store for transaction recovery

Untargeting BAM Server components from WLS_BAM2

Propagating domain configurations

Starting WLS_BAM1 and WLS_BAM2

Applying the JRF template to BAM_Cluster

Performing BAM-specific configurations

Configuring a cluster address

Configuring BAM Web Applications

Configuring BAM properties using System MBean Browser

Backing up your HA environment

Configuring server migration

Configuring migration for the Administration Server

Configuring server migration for WLS_BAM1

Setting up a leasing table for server migration

Creating a data source

Editing the Node Manager's properties file

Configuring the wlsifconfig.sh script

Configuring server migration targets

Summary

9. Troubleshooting your BAM Applications

Understanding BAM logging and troubleshooting methodologies

Understanding BAM logging concepts

Enabling logging for BAM

Setting BAM loggers to appropriate values

Introducing the methodologies for troubleshooting BAM

Understanding the key terminologies and the BAM architecture

Identifying the problem

Setting up BAM loggers

Troubleshooting the BAM applications

Troubleshooting the Active Data processing issues

Troubleshooting Report Server issues

Enabling ActiveDataPage

Enabling ActiveDataViewSet

Enabling ActiveDataServlet

Troubleshooting the Active Data Cache and the Report Cache

Troubleshooting the client-side issues

Enabling client-side logging

Case study

Identifying the problem

Diagnosing the problem

Solution

Troubleshooting BAM HA issues

Case study

Identifying the problem

Diagnosing the problem

Solution

Summary

10. Building your Reports Using ADF

ADF — an overview

Designing your BAM report using ADF

Developing your report using ADF

Creating an ADF project in JDeveloper

Configuring your BAM connection

Creating BAM Data Control for a Data Object

Creating a JSF page and data binding

Deploying and testing your ADF project

Summary

Index

Oracle BAM 11gR1 Handbook

Oracle BAM 11gR1 Handbook

Copyright © 2012 Packt Publishing

All rights reserved. No part of this book may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, without the prior written permission of the publisher, except in the case of brief quotations embedded in critical articles or reviews.

Every effort has been made in the preparation of this book to ensure the accuracy of the information presented. However, the information contained in this book is sold without warranty, either express or implied. Neither the author, nor Packt Publishing, and its dealers and distributors will be held liable for any damages caused or alleged to be caused directly or indirectly by this book.

Packt Publishing has endeavored to provide trademark information about all of the companies and products mentioned in this book by the appropriate use of capitals. However, Packt Publishing cannot guarantee the accuracy of this information.

First published: April 2012

Production Reference: 1280312

Published by Packt Publishing Ltd. Livery Place 35 Livery Street Birmingham B3 2PB, UK.

ISBN 978-1-84968-544-3

www.packtpub.com

Cover Image by Sandeep Babu (<sandyjb@gmail.com> )

Credits

Author

Pete Wang

Reviewers

Vaibhav Shankar Ambavale

Martijn van der Kamp

Arun Pareek

Jan-Willem Pas

Acquisition Editor

Stephanie Moss

Lead Technical Editor

Shreerang Deshpande

Technical Editor

Lubna Shaikh

Project Coordinator

Joel Goveya

Proofreader

Aaron Nash

Indexer

Hemangini Bari

Graphics

Manu Joseph

Valentina D'souza

Production Coordinator

Aparna Bhagat

Prachali Bhiwandkar

Cover Work

Aparna Bhagat

Foreword

As businesses are increasing their use of Service Oriented Architecture (SOA) to build their core business systems, the need for real-time visibility into their business processes is becoming critical. At the same time, IT budgets are shrinking, and businesses are under constant pressure to cut costs and optimize their investments. Oracle Business Activity Monitoring (Oracle BAM) provides a comprehensive solution for building real-time dashboards and alerts for monitoring Service Level Agreements (SLAs) and other Key Performance Indicators (KPIs).

Like Oracle SOA Suite and Oracle BPM Suite, Oracle BAM 11g leverages the best-of-breed WebLogic Server platform to achieve a high quality of service. As a completely new release, Oracle BAM 11g offers many new features and enhancements in the areas of usability, performance, scalability, and interoperability.

The book is a comprehensive handbook that focuses on providing guidance and best practices for building BAM applications including designing, developing, and troubleshooting. The key topics covered in the book are:

Oracle BAM 11g concepts and architecture

Developing and load testing BAM applications

Configuring an LDAP server and SSL for BAM

Migrating BAM applications from one environment to another

Troubleshooting and tuning BAM applications

Configuring BAM High Availability

This book provides an in-depth coverage of Oracle BAM 11g, as well as troubleshooting methodologies that can be used for advanced problem resolution. The BAM samples for this book help solidify the readers' understanding of the concepts through hands-on experience.

All the instructions, guidelines, tips, best practices, and cases studies are based on real-world problems and solutions. By following these best practices, SOA developers can significantly increase their productivity, avoid common pitfalls, and create more agile, scalable, and reusable BAM applications.

As the global technical lead for BAM and a member of the A-Team, Pete's real-world experience with SOA and BAM-based solutions helps keep the book grounded in practical solutions to real-world challenges that companies face.

Focusing on accurate, pragmatic instructions, and best practices, this book should be a perfect guide for SOA architects and developers, in developing and administrating BAM applications.

Robert Patrick

Vice President, Oracle Fusion Middleware Architects Team: The A-Team

About the Author

Pete Wang is a member of the Oracle Fusion Middleware Architects team: the A-Team that focuses on managing all aspects of the SOA/AIA engagements, including proof of concepts, support escalations, sales engagement, user conferences, seminars, workshops, and so on. With a well-established credibility and influence in the area of SOA/BAM, Pete is a trusted advisor, and plays a key technical role in guiding customers, consultants, support analysts, and engineers in resolving critical customer and product issues. Prior to the A-Team role, Pete took on various roles in Customer Support and Sales Consulting at both Oracle and BEA Systems.

Pete has over 12 years of experience in the design and the development of SOA/BAM/JavaEE applications, and he specializes in designing and troubleshooting large-scale and mission-critical systems built with various middleware technologies. As the Global Technical Lead (GTL) for BAM in Support, Pete has been actively engaged in delivering BAM solutions, publishing articles, support escalations, and advanced resolutions, to ensure the success of customers.

Pete is currently living in Melbourne, Australia, but will move to Boston, MA, USA, with his family soon. Pete holds a Master's Degree in Information Science from the University of New South Wales, Australia, and he likes to play tennis and soccer in his spare time.

Acknowledgement

First of all, I would like to take this opportunity to express my sincere gratitude to all the members of the BAM Development team and the Oracle management team, especially to Robert Patrick, Jeff McDaniel, Payal Srivastava, Stephen Sherman, Hani Isac, and Odin Grupe for their support, encouragement, and guidance throughout the development of this book.

I would also like to express my deep gratitude to all the contributors and the reviewers, who truly play a key part in improving the contents and making this book complete. Their hard work, great ideas, and precious comments really make a difference. Special thanks to Michael Zhao who has spent a lot of his spare time in building and testing the samples, thus ensuring the high quality of the code and instructions. Without their contributions, this book wouldn't have been as good as it is now.

I would like to say a big thank you to the team at Packt Publishing, who are always willing to help with their professionalism, enthusiasm, and dedication. Special thanks go to Stephanie Moss, who provided a lot of invaluable feedback and comments in the early stage of writing, which really made my job easier as an author.

Finally, I would like to dedicate this book to my lovely wife, Daisy, who has been supporting and encouraging me throughout the course of the book's development. Without her continued support, patience, and care, I would not have pursued and completed this work in such a short amount of time.

About the Reviewers

Vaibhav Shankar Ambavale is a solution architect, and has extensive experience in Middleware technologies. He is passionate about designing and developing applications. He is an Oracle certified Expert on Oracle SOA suite 11g. He has expertise in Oracle Fusion middleware — SOA, BPM, BAM, mediator, B2B, AIA, and WebLogic. He has extensive experience in the B2B domain, where he worked on various B2B products and protocols.

Besides work, he enjoys traveling, trekking, and photography. Vaibhav holds a Bachelor's degree in engineering from V.J.T.I., Mumbai, India.

Martijn van der Kamp is an enthusiastic Oracle specialist from the Netherlands. His focus is on the Fusion Middleware stack. When he started working for Capgemini, he got in touch with Oracle BPM. Quickly, his interest transformed to passion.

Martijn has worked on several (international) projects in the Oracle BPM domain, where he gained expertise and knowledge of implementing BAM.

I would like to thank Léon Smiers for getting me acquainted with, and coaching me on, Oracle BPM and BAM.

Arun Pareek is a SOA practitioner, working on SOA-based implementation projects in the capacity of a consultant and architect for over five years now. He is also an IASA certified software architect, and is currently co-authoring a book on Oracle SOA Suite Administration for Packt Publishing. He has been actively working on the SOA Suite of products of both BEA and Oracle, including technologies such as Service Bus, AIA, BPEL, BAM, BPA, and BPMN. He has a knack for designing systems that are scalable, performant, and fault-tolerant, and is an enthusiast for automated continuous integration techniques. He is also an active blogger on these technologies, and runs a popular blog at http://beatechnologies.wordpress.com.

I would like to appreciate the encouragement I received from my parents for helping me achieve many things in my life. A special note of thanks goes to my wonderful wife Karuna for her constant support, cooperation, and patience, without which, it wouldn't have been possible for me to manage my work and life together.

Jan-Willem Pas is a Database and Integration specialist working at Capgemini, Netherlands.

After completing his Bachelor's degrees in Technical IT and Commercial Engineering and Management, Mr. Pas started