Go to main content
1/34
Contents
List of Tables
Title and Copyright Information
Preface
Conventions
What's New in This Guide
Significant Documentation Changes for 12c (12.1.3)
New and Changed Features for 12c (12.1.3)
Part I Learning about Oracle Service Bus Administration
1
Interoperability, Compatibility, and System Support
1.1
Supported System Configurations
1.2
Interoperability and Compatibility with Oracle Products
1.3
Supported Standards and Implementations
1.4
Interoperability and Support Limitations
1.4.1
.NET Interoperability Limitations
1.4.2
Apache Axis Interoperability Limitations
1.4.2.1
Unresolved References When Importing RPC-Encoded Axis-Generated WSDL Documents
1.4.2.2
SOAPAction attribute in Axis-generated WSDL files initialized to empty string
1.4.2.3
HTTP Response and Status Code for One-Way Operations
1.4.2.4
HTTP Response and Status Code for One-Way Operations Generate a Fault
1.4.3
WebSphere Interoperability Limitations
2
Introduction to Oracle Service Bus Administration
2.1
Oracle Fusion Middleware Overview
2.2
Oracle Service Bus Overview
2.2.1
Introduction to Service Monitoring and Management
2.2.1.1
Administration Consoles
2.2.1.2
Auditing Capabilities
2.2.2
Introduction to the Oracle Service Bus Monitoring Framework
2.2.3
Accessing Statistics Using the JMX API
2.2.4
Accessing Statistics in a Cluster
2.3
Oracle Service Bus Runtime Monitoring
2.3.1
Service Health Monitoring
2.3.1.1
Metric Aggregation
2.3.1.2
Monitoring a Service that was Renamed or Moved
2.3.2
SLA and Pipeline Alert Monitoring
2.3.2.1
SLA Alerts Overview
2.3.2.2
Pipeline Alerts Overview
2.3.3
Resequencing Group Monitoring
2.3.4
Log File Monitoring
2.3.5
Message Reporting
2.4
Oracle Service Bus Runtime Management
2.4.1
Environment Customization
2.4.2
Runtime Configuration
2.4.3
Business Service Endpoint Management
2.4.4
Tuning Performance with Endpoint Throttling
2.4.5
Importing and Exporting Resources
2.4.6
Diagnostics
2.5
Oracle Service Bus Runtime Security
2.5.1
Working with Security Policies
2.5.2
Defining Security Administration
2.6
Introduction to Aggregation Intervals
2.6.1
Refresh Rate of Monitored Data
2.6.2
Sampling Intervals Within Aggregation Intervals
2.6.3
Aggregation Interval Properties
2.6.4
Resetting the Statistics
2.7
Server Monitoring and Management
2.8
Oracle Service Bus and Oracle Enterprise Scheduler
3
Getting Started with Oracle Service Bus Administration
3.1
Introduction to the Management and Monitoring Pages
3.1.1
Service Bus Domain-Level Monitoring Pages
3.1.1.1
Dashboard (Domain-Level)
3.1.1.2
Alert History
3.1.1.3
Service Health
3.1.1.4
Resequence Messages
3.1.1.5
Operations
3.1.1.6
Global Settings
3.1.2
Service Bus Project Monitoring Pages
3.1.3
Service Bus Service Monitoring Pages
3.1.3.1
Dashboard (Service-Level)
3.1.3.2
Properties
3.1.3.3
Policies
3.2
Logging in to Oracle Enterprise Manager Fusion Middleware Control
3.3
Navigating to Oracle Service Bus Administration Pages
3.3.1
Navigating Through the Service Bus Home Page and Menu
3.3.2
Navigating Through the Service Bus Projects Home Page and Menu
3.3.3
Navigating to Oracle Service Bus Pages from the Home Page
3.4
Navigating to the System MBean Browser
3.5
Setting Accessibility Options
3.6
Logging out of Oracle Enterprise Manager Fusion Middleware Control
3.7
Starting Oracle Service Bus Servers
Part II Monitoring Oracle Service Bus
4
Monitoring Oracle Service Bus Alerts
4.1
Introduction to Oracle Service Bus Alerts
4.1.1
Alerts on the Service Bus Dashboard
4.1.2
Alerts and Operational Settings
4.2
About Service Level Agreement Alerts
4.2.1
SLA Alert Severity Levels
4.2.2
Aggregation Intervals
4.2.3
SLA Alert Frequencies
4.2.4
SLA Alert Statistics
4.2.4.1
Count Statistic Details
4.2.4.2
Maximum, Minimum, and Average Statistic Details
4.2.4.3
Status Statistic Details
4.3
About Pipeline Alerts
4.3.1
A Sample Use Case for Pipeline Alerts
4.4
Enabling and Disabling Alerts
4.5
Creating Service Level Agreement Alert Rules
4.5.1
Before You Begin
4.5.2
Configuring SLA Alert Rule Properties
4.5.3
Defining SLA Alert Rule Conditions
4.6
Updating SLA Alert Rules
4.6.1
Editing Alert Rules
4.6.2
Deleting Alert Rules
4.7
Monitoring SLA and Pipeline Alerts
4.7.1
Enabling Alert Reporting
4.7.2
Viewing all SLA and Pipeline Alerts in a Domain
4.7.3
Filtering SLA and Pipeline Alerts
4.7.4
Viewing SLA or Pipeline Alert Details
4.7.4.1
Viewing Alert Details on the Service Bus Dashboard
4.7.4.2
Viewing Alert Details on the Alert History Page
4.7.5
Viewing the Alert Rule Configuration
4.7.5.1
Viewing the Alert Rule Configuration on the Service Bus Dashboard
4.7.5.2
Viewing the Alert Rule Configuration on the Alert History Page
4.7.6
Deleting an SLA or Pipeline Alert
4.7.7
Purging SLA or Pipeline Alerts
5
Monitoring Oracle Service Bus Service Health
5.1
About Service Health Metrics
5.1.1
Service Health Metrics for Domains and Projects
5.1.2
Proxy Service Metrics
5.1.3
Business Service Metrics
5.1.4
Pipeline Service Metrics
5.1.5
Split-Join Service Metrics
5.2
Monitoring Service Health Statistics
5.2.1
Viewing Statistics for the Services with the Most Errors
5.2.2
Viewing Service Health Statistics for a Domain
5.2.3
Viewing Service Health Statistics for a Project
5.2.4
Viewing All Service Health Statistics for a Service
5.3
Resetting Statistics for Service Monitoring
5.3.1
What You Might Need to Know About Resetting the Statistics
6
Monitoring Resequencing Groups
6.1
Introduction to Resequencing Groups
6.1.1
Oracle Service Bus Resequencing Message States
6.1.2
Resequencer Error Handling
6.1.3
Resequencer Database
6.1.4
How Deployment Activities Affect Resequencing
6.1.5
How Server Shutdown Affects Resequencing
6.1.5.1
Server shuts down while a message is being transferred to the resequencer from Service Bus
6.1.5.2
Server shuts down while a group is locked by the locker thread
6.1.5.3
Server shuts down while a message is being processed by the resequencer
6.2
Configuring Resequencing at Runtime
6.3
Monitoring Resequencing Groups and Messages
6.3.1
Monitoring Resequencing Groups and Messages
6.3.2
Viewing Information About a Resequencing Group
6.4
Managing Resequencing Groups at Runtime
6.4.1
Skipping Message Sequence IDs
6.4.2
Recovering when a Resequencing Group Times Out
6.4.3
Recovering from Resequencing Faults
7
Configuring and Monitoring Log Files
7.1
Introduction to Oracle Service Bus Logging
7.1.1
ODL Log Files
7.1.2
ODL Logging Levels
7.1.3
ODL Message Format
7.1.4
ODL Log Configuration
7.1.5
Oracle Service Bus Loggers
7.2
Configuring Diagnostic Logging for Oracle Service Bus
7.2.1
About Service Bus Logging in Fusion Middleware Control
7.2.2
Configuring Log Levels and Log Files for Service Bus
7.2.3
Configuring Oracle Service Bus Logging using WLST Commands
7.2.4
Setting Logging Levels for Debugging in Fusion Middleware Control
7.2.5
Setting the Prefix for Oracle Service Bus Error Messages
7.2.6
Configuring Oracle Service Bus for Offline Logging
7.3
Viewing Diagnostic Log Files for Oracle Service Bus
7.3.1
Viewing Oracle Service Bus Log Files in Fusion Middleware Control
7.3.2
Customizing the Log Message View
7.3.3
Viewing Oracle Service Bus Log Files Using WLST Commands
7.4
Oracle Service Bus Loggers
7.4.1
Service Bus Standard Loggers
7.4.2
Service Bus Debug Loggers in 11g and 12c
7.5
Log Configuration After Upgrading from 11g
7.5.1
Logging Levels
7.5.2
Log Message Formatting
Part III Managing the Oracle Service Bus Runtime
8
Configuring Operational and Global Settings
8.1
Introduction to Operational Settings
8.1.1
Available Operational Settings
8.1.1.1
State
8.1.1.2
Monitoring
8.1.1.3
Aggregation Interval
8.1.1.4
Service-Level Agreement Alerts
8.1.1.5
Pipeline Alerts
8.1.1.6
Reporting
8.1.1.7
Logging
8.1.1.8
Execution Tracing
8.1.1.9
Message Tracing
8.1.1.10
Offline Endpoint URIs
8.1.1.11
Throttling Settings
8.1.1.12
Result Caching State
8.1.1.13
Resequencer Settings
8.1.2
Global and Service-Level Operational Settings
8.2
Viewing and Configuring Operational Settings
8.2.1
Configuring Operational Settings at the Global Level
8.2.2
Operational Settings at the Global Level
8.2.3
Searching for Services to Configure Their Operational Settings
8.2.4
Enabling and Disabling Operational Settings for Multiple Services
8.2.5
Enabling and Disabling Operational Settings for a Single Service
8.2.6
Setting the Aggregation Interval for a Service
8.2.7
Configuring the Monitoring Level for a Pipeline or Split-Join
8.2.8
Configuring Message Tracing for a Service
8.2.9
Configuring the SLA Alert Level for a Service
8.2.10
Configuring the Pipeline Alert Level
8.2.11
Configuring the Logging Level for a Service
8.2.12
Configuring Throttling for a Business Service
8.2.13
Configuring Offline Endpoint URI Handling for a Business Service
8.3
Making Bulk Updates to Operational Settings
8.4
Preserving Operational Settings During Resource Imports
9
Customizing Oracle Service Bus Environments
9.1
About Environment Values
9.1.1
Find and Replace
9.1.2
Configuration Files
9.1.2.1
Schema Files
9.1.2.2
Operational Settings
9.1.2.3
Environment Values
9.1.2.4
Find and Replace
9.1.2.5
Reference Mapping
9.2
Finding and Replacing Environment Values Using the Oracle Service Bus Console
9.2.1
Finding Environment Values
9.2.2
Replacing Environment Values
9.3
Using Configuration Files to Update Environment Values and Operational Settings
9.3.1
Creating a Configuration File
9.3.2
Executing a Configuration File
9.4
Available Environment Values
9.5
Environment Values for Operational Settings
9.6
Sample Configuration Files
10
Importing and Exporting Oracle Service Bus Resources
10.1
About Importing and Exporting Oracle Service Bus Resources
10.2
Exporting Oracle Service Bus Resources in Fusion Middleware Control
10.3
Importing Oracle Service Bus Resources in Fusion Middleware Control
11
Defining Access Security for Oracle Service Bus
11.1
Understanding Oracle Service Bus Application Security
11.1.1
Users
11.1.2
Groups
11.1.3
Roles
11.1.3.1
Oracle Service Bus Application Roles
11.1.3.1.1
MiddlewareAdministrator
11.1.3.1.2
Developer
11.1.3.1.3
Composer
11.1.3.1.4
Deployer
11.1.3.1.5
Tester
11.1.3.1.6
MiddlewareOperator
11.1.3.1.7
ApplicationOperator
11.1.3.1.8
Monitor
11.1.3.2
WebLogic Server Security Roles
11.1.3.3
Compatibility with Previous Releases
11.1.4
Access Control Policies
11.1.5
Security Configuration Data and Sessions
11.2
Security Configuration During Exports
11.3
Configuring Oracle Service Bus Administrative Security
11.3.1
How to Grant Permissions to Individual Users
11.3.2
How to Grant Permissions to Users in User Groups
11.3.3
Creating Oracle Service Bus Groups
11.3.4
Granting Permissions to Groups
11.3.4.1
Assigning a Group to an Application Role
11.3.4.2
Granting Individual Permissions to a Group
11.3.5
Creating Oracle Service Bus Users
11.3.6
Granting Access Permissions By Assigning Users to Groups
11.3.7
Granting Permissions to Individual Users
11.3.7.1
Assigning a User to an Application Role
11.3.7.2
Granting Individual Permissions to a User
11.4
Securing Oracle Service Bus in a Production Environment
11.4.1
Undeploying the Service Bus (SB) Resource
11.4.2
Protection of Temporary Files With Streaming body Content
11.4.3
Protecting Against Denial of Service Attacks on the Oracle Service Bus Console
Part IV Performing Advanced Administration Tasks
12
Configuring Reporting for Messages and Alerts
12.1
Introduction to the Service Bus Reporting Framework
12.1.1
Message Report Configuration
12.1.2
Default Reporting Provider
12.1.3
Custom Report Providers
12.1.4
Reporting Workflow
12.2
About the JMS Reporting Provider
12.2.1
About the Pipeline Report Action
12.2.2
Reporting Actions in Global Transactions
12.3
Configuring a Database for the JMS Reporting Provider Store
12.3.1
Configuring the Reporting Data Source for Transactions
12.3.2
Creating a Database for the JMS Reporting Provider Store
12.4
Enabling Message Reports
12.5
Working With Message Reports
12.5.1
Searching for Message Reports
12.5.2
Viewing Message Report Details
12.5.3
About Purging Message Reports from the Reporting Data Store
12.5.4
Purging Message Reports from the Reporting Data Store
12.6
Stopping a Reporting Provider
12.7
Starting a Reporting Provider
12.8
Untargeting a JMS Reporting Provider
12.8.1
Untargeting the Default JMS Reporting Provider During Domain Creation
12.8.2
Untargeting the JMS Reporting Provider when the Server is Running
12.8.3
Untargeting the JMS Reporting Provider When the Server in Not Running
12.9
Using Oracle Advanced Queueing JMS
13
Monitoring and Managing Security Policies
13.1
Introduction to Security Policies
13.2
Configuring Global Policies
13.2.1
How to Create a Global Policy Set
13.2.2
How to Enable a Service for Global Policies
13.2.3
How to Disable a Service for Global Policies
13.3
Monitoring Security Policies
13.3.1
Viewing the Policies Attached to a Service
13.3.2
Monitoring Policy Usage
13.3.3
Viewing Policy Violations
13.4
Managing Security Policies
13.4.1
Attaching Security Policies Directly to a Service
13.4.2
Detaching Policies from a Service
13.4.3
Overriding Security Policies
14
Monitoring and Managing Endpoint URIs for Business Services
14.1
About Endpoint URI Management
14.1.1
About Endpoint URIs
14.1.2
Offline and Online Endpoint URIs
14.1.2.1
About Temporarily Offline Endpoint URIs
14.1.2.2
About Permanently Offline Endpoint URIs
14.1.2.3
Offline URIs in Clustered Environments
14.1.3
Metrics for Monitoring Endpoint URIs
14.1.3.1
Endpoint URI State
14.1.3.2
Endpoint URI Performance Metrics
14.2
Configuring Service Bus to Take Unresponsive Endpoint URIs Offline
14.3
Marking an Endpoint URI Offline Manually
14.4
Marking an Offline URI as Online
14.5
Viewing Endpoint URI Metrics for a Business Service
14.6
Creating Alerts Based on Endpoint URI Metrics
14.6.1
About Creating an SLA Alert Based on Endpoint URI Status
14.6.2
Creating an SLA Alert Based on Endpoint URI Status
14.6.3
Configuring an Alert Rule Based on Endpoint URI Statistics
15
Configuring Business Services for Message Throttling
15.1
Introduction to Throttling
15.1.1
Throttling Concepts
15.1.2
Throttling Properties
15.1.2.1
Maximum Concurrency
15.1.2.2
Throttling Queue Length
15.1.2.3
Message Expiration (TTL)
15.1.3
Throttling Groups
15.1.4
Throttling Group Properties and Business Service Throttling Properties
15.1.5
Throttling for Business Services with Multiple Endpoint URIs
15.1.6
Throttling Retried Messages
15.1.7
Throttling and Work Managers
15.2
Throttling in a Cluster
15.3
Throttling Metrics
15.3.1
Using Throttling Metrics to Define Alerts
15.4
Configuring Throttling for a Single Business Service
15.4.1
Configuring Throttling for a Single Business Service
15.4.2
Disabling Throttling for a Single Business Service
15.5
Configuring Throttling for a Group of Business Services
15.5.1
Creating Throttling Groups
15.5.2
Associating Business Services with a Throttling Group
15.5.3
Editing Throttling Groups
15.5.4
Deleting a Throttling Group
16
Managing Resequencer Tables
16.1
About the Resequencer Database Tables
16.1.1
Database Table Purge Scripts
16.1.2
Automatic Purging of Completed Resequencer Messages
16.1.3
The Datasource for Resequencing
16.1.4
Purge Scripts and Resequenced Message Purge States
16.2
Purging Oracle Service Bus Resequencer Data
16.2.1
Configuring the Resequencer to Automatically Purge Completed Messages
16.2.2
Using SQL Scripts to Purge Resequencer Tables
16.2.2.1
Setting up the Environment and Scripts
16.2.2.2
Running the Oracle Service Bus Purge Procedure
16.2.2.3
Running the Service Bus Purge Scripts
16.2.2.4
Running the SOA Suite Purge Scripts (In Looped Mode)
16.3
Reconfiguring an Active Resequencer is not Supported
Part V Troubleshooting Oracle Service Bus Services
17
Using Execution Tracing to Diagnose Problems
17.1
Introduction to Execution Tracing
17.2
Enabling and Disabling Execution Tracing
17.2.1
Setting Oracle WebLogic Server Log Levels
17.2.2
Configuring Execution Tracing for a Single Service
17.2.3
Configuring Execution Tracing for Multiple Services
17.3
Accessing Execution Tracing Information
18
Using the Diagnostic Frameworks to Diagnose Problems
18.1
Understanding Diagnostics for Oracle Service Bus
18.1.1
Oracle WebLogic Diagnostic Framework
18.1.1.1
Watches and Notifications
18.1.1.2
Diagnostic Scenarios and MBeans
18.1.2
Oracle Fusion Middleware Diagnostic Framework
18.1.2.1
Diagnostic Dumps
18.1.3
About the Automatic Diagnostic Repository
18.1.4
Predefined Incident Processing Rules
18.1.5
Dynamic Monitoring Service Metrics
18.2
Working with Oracle Service Bus Diagnostic Dumps
18.2.1
Listing the Available Diagnostic Dumps
18.2.2
Derived Resource Caches Diagnostic Dumps (OSB.derived-caches)
18.2.2.1
Oracle Service Bus Derived Resource Caches
18.2.2.2
Viewing a description of the derived resource caches dump
18.2.2.3
Running the derived resource caches dump
18.2.2.4
Sample Output of the Derived Resource Cache Dump
18.2.3
Running a JMS Correlation Table Diagnostic Dump (OSB.jms-async-table)
18.2.3.1
Viewing a Description of the JMS Correlation Table Dump
18.2.3.2
Running the JMS Correlation Table Dump
18.2.3.3
Sample Output of the JMS Correlation Table Dump
18.2.4
Running an MQ Correlation Table Diagnostic Dump (OSB.mq-async-table)
18.2.4.1
Viewing a Description of the MQ Correlation Table Dump
18.2.4.2
Running the MQ Correlation Table Dump
18.2.4.3
Sample Output of the MQ Correlation Table Dump
18.3
Generating Diagnostic Dumps Using RDA
18.4
Viewing Incident Packages with ADR Tools
18.5
Querying Problems and Incidents
Appendixes
A
JMX Monitoring API
A.1
Introduction to the JMX Monitoring API
A.2
Using the JMX Monitoring API
A.2.1
Public POJO Objects
A.2.1.1
ResourceType
A.2.1.2
ServiceResourceStatistic
A.2.1.3
ResourceStatistic
A.2.1.4
StatisticValue
A.2.1.5
StatisticType
A.2.2
ServiceDomainMBean
A.2.3
MonitoringConfigurationMBean
A.2.4
Statistics Collected for Oracle Service Bus
A.2.4.1
Statistics Details for Resource Type - SERVICE
A.2.4.2
Statistics for Resource Type–FLOW_COMPONENT
A.2.4.3
Statistics details for Resource Type – WEBSERVICE_OPERATION
A.2.4.4
Statistics details for Resource Type – URI
A.2.5
Caveats
A.2.6
Performance
A.3
API Usage Example
A.3.1
Sample Program
B
Using the Oracle Service Bus Deployment APIs
B.1
Deployment MBean Overview
B.2
Managing Sessions Using Programs and Scripts
B.2.1
Creating, Activating, Discarding, and Locating Sessions
B.3
Managing Configuration Tasks Using Programs and Scripts
B.3.1
Importing, Exporting, and Querying Configurations
B.3.2
Updating Environment-Specific Information
C
Auditing Your Oracle Service Bus System
C.1
Auditing the Configuration Changes
C.2
Creating an Audit Trail for a Message Flow
C.3
Auditing Security Violations
D
Interoperability with WSRP
D.1
WSRP Producers and Consumers
D.2
WSRP Architecture
D.2.1
Enhanced Architecture with Oracle Service Bus
D.3
WSRP Design Concepts
D.3.1
WSRP WSDL Documents
D.3.2
WSRP Messages
D.4
Configuring Oracle Service Bus for WSRP
D.4.1
Getting the Producer WSDL Document
D.4.2
Using SSL with WSRP Producers
D.4.3
Routing Messages Between Consumer and Producer
D.4.4
Monitoring WSRP Applications
D.4.5
Load Balancing and Failover
D.4.5.1
WSRP Limitations Without Session Stickiness
D.4.5.2
Using WSRP with HTTP Session Stickiness
E
Role-Based Access in Oracle Service Bus
E.1
Application Security Roles
E.1.1
Application Role-Based Access in Oracle Service Bus Console
E.1.1.1
Application Role-Based Access to Resource Actions
E.1.1.2
Application Role-Based Access to Administration Functions
E.1.1.3
Application Role-Based Access to Session Management
E.1.2
Application Role-Based Access in Fusion Middleware Control
E.2
Enterprise Security Roles
E.2.1
Enterprise Role-Based Access in Oracle Service Bus Console
E.2.1.1
Enterprise Role-Based Access to Resource Actions
E.2.1.2
Enterprise Role-Based Access to Administration Functions
E.2.1.3
Enterprise Role-Based Access to Session Management
E.2.2
Enterprise Role-Based Access in Fusion Middleware Control
E.3
Role-Based Security Configuration Access
Scripting on this page enhances content navigation, but does not change the content in any way.