Go to main content
1/34
Contents
List of Tables
Title and Copyright Information
Preface
Documentation Accessibility
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
Differences Between Using this Component in the Cloud and On-Premises Environments
Supported System Configurations
Interoperability and Compatibility with Oracle Products
Supported Standards and Implementations
Interoperability and Support Limitations
.NET Interoperability Limitations
Apache Axis Interoperability Limitations
Unresolved References When Importing RPC-Encoded Axis-Generated WSDL Documents
SOAPAction attribute in Axis-generated WSDL files initialized to empty string
HTTP Response and Status Code for One-Way Operations
HTTP Response and Status Code for One-Way Operations Generate a Fault
WebSphere Interoperability Limitations
2
Introduction to Oracle Service Bus Administration
Oracle Fusion Middleware Overview
Oracle Service Bus Overview
Introduction to Service Monitoring and Management
Administration Consoles
Auditing Capabilities
Introduction to the Oracle Service Bus Monitoring Framework
Accessing Statistics Using the JMX API
Accessing Statistics in a Cluster
Oracle Service Bus Runtime Monitoring
Service Health Monitoring
Metric Aggregation
Monitoring a Service that was Renamed or Moved
SLA and Pipeline Alert Monitoring
SLA Alerts Overview
Pipeline Alerts Overview
Resequencing Group Monitoring
Log File Monitoring
Message Reporting
Oracle Service Bus Runtime Management
Environment Customization
Runtime Configuration
Business Service Endpoint Management
Tuning Performance with Endpoint Throttling
Importing and Exporting Resources
Diagnostics
Oracle Service Bus Runtime Security
Working with Security Policies
Defining Security Administration
Introduction to Aggregation Intervals
Refresh Rate of Monitored Data
Sampling Intervals Within Aggregation Intervals
Aggregation Interval Properties
Resetting the Statistics
Server Monitoring and Management
Oracle Service Bus and Oracle Enterprise Scheduler
3
Getting Started with Oracle Service Bus Administration
Introduction to the Management and Monitoring Pages
Service Bus Domain-Level Monitoring Pages
Dashboard (Domain-Level)
Alert History
Service Health
Resequence Messages
Operations
Global Settings
Service Bus Project Monitoring Pages
Service Bus Service Monitoring Pages
Dashboard (Service-Level)
Properties
Policies
Logging in to Oracle Enterprise Manager Fusion Middleware Control
Navigating to Oracle Service Bus Administration Pages
Navigating Through the Service Bus Home Page and Menu
Navigating Through the Service Bus Projects Home Page and Menu
Navigating to Oracle Service Bus Pages from the Home Page
Navigating to the System MBean Browser
Setting Accessibility Options
Logging out of Oracle Enterprise Manager Fusion Middleware Control
Starting Oracle Service Bus Servers
Part II Monitoring Oracle Service Bus
4
Monitoring Oracle Service Bus Alerts
Introduction to Oracle Service Bus Alerts
Alerts on the Service Bus Dashboard
Alerts and Operational Settings
About Service Level Agreement Alerts
SLA Alert Severity Levels
Aggregation Intervals
SLA Alert Frequencies
SLA Alert Statistics
Count Statistic Details
Maximum, Minimum, and Average Statistic Details
Status Statistic Details
About Pipeline Alerts
A Sample Use Case for Pipeline Alerts
Enabling and Disabling Alerts
Creating Service Level Agreement Alert Rules
Before You Begin
Configuring SLA Alert Rule Properties
Defining SLA Alert Rule Conditions
Updating SLA Alert Rules
Editing Alert Rules
Deleting Alert Rules
Monitoring SLA and Pipeline Alerts
Enabling Alert Reporting
Viewing all SLA and Pipeline Alerts in a Domain
Filtering SLA and Pipeline Alerts
Viewing SLA or Pipeline Alert Details
Viewing Alert Details on the Service Bus Dashboard
Viewing Alert Details on the Alert History Page
Viewing the Alert Rule Configuration
Viewing the Alert Rule Configuration on the Service Bus Dashboard
Viewing the Alert Rule Configuration on the Alert History Page
Deleting an SLA or Pipeline Alert
Purging SLA or Pipeline Alerts
5
Monitoring Oracle Service Bus Service Health
About Service Health Metrics
Service Health Metrics for Domains and Projects
Proxy Service Metrics
Business Service Metrics
Pipeline Service Metrics
Split-Join Service Metrics
Monitoring Service Health Statistics
Viewing Statistics for the Services with the Most Errors
Viewing Service Health Statistics for a Domain
Viewing Service Health Statistics for a Project
Viewing All Service Health Statistics for a Service
Resetting Statistics for Service Monitoring
What You Might Need to Know About Resetting the Statistics
6
Monitoring Resequencing Groups
Introduction to Resequencing Groups
Oracle Service Bus Resequencing Message States
Resequencer Error Handling
Resequencer Database
How Deployment Activities Affect Resequencing
How Server Shutdown Affects Resequencing
Server shuts down while a message is being transferred to the resequencer from Service Bus
Server shuts down while a group is locked by the locker thread
Server shuts down while a message is being processed by the resequencer
Configuring Resequencing at Runtime
Monitoring Resequencing Groups and Messages
Monitoring Resequencing Groups and Messages
Viewing Information About a Resequencing Group
Managing Resequencing Groups at Runtime
Skipping Message Sequence IDs
Recovering when a Resequencing Group Times Out
Recovering from Resequencing Faults
7
Configuring and Monitoring Log Files
Introduction to Oracle Service Bus Logging
ODL Log Files
ODL Logging Levels
ODL Message Format
ODL Log Configuration
Oracle Service Bus Loggers
Configuring Diagnostic Logging for Oracle Service Bus
About Service Bus Logging in Fusion Middleware Control
Configuring Log Levels and Log Files for Service Bus
Configuring Oracle Service Bus Logging using WLST Commands
Setting Logging Levels for Debugging in Fusion Middleware Control
Setting the Prefix for Oracle Service Bus Error Messages
Configuring Oracle Service Bus for Offline Logging
Viewing Diagnostic Log Files for Oracle Service Bus
Viewing Oracle Service Bus Log Files in Fusion Middleware Control
Customizing the Log Message View
Viewing Oracle Service Bus Log Files Using WLST Commands
Oracle Service Bus Loggers
Service Bus Standard Loggers
Service Bus Debug Loggers in 11g and 12c
Log Configuration After Upgrading from 11g
Logging Levels
Log Message Formatting
Part III Managing the Oracle Service Bus Runtime
8
Configuring Operational and Global Settings
Introduction to Operational Settings
Available Operational Settings
State
Monitoring
Aggregation Interval
Service-Level Agreement Alerts
Pipeline Alerts
Reporting
Logging
Execution Tracing
Message Tracing
Offline Endpoint URIs
Throttling Settings
Result Caching State
Resequencer Settings
Global and Service-Level Operational Settings
Viewing and Configuring Operational Settings
Configuring Operational Settings at the Global Level
Operational Settings at the Global Level
Searching for Services to Configure Their Operational Settings
Enabling and Disabling Operational Settings for Multiple Services
Enabling and Disabling Operational Settings for a Single Service
Setting the Aggregation Interval for a Service
Configuring the Monitoring Level for a Pipeline or Split-Join
Configuring Message Tracing for a Service
Configuring the SLA Alert Level for a Service
Configuring the Pipeline Alert Level
Configuring the Logging Level for a Service
Configuring Throttling for a Business Service
Configuring Offline Endpoint URI Handling for a Business Service
Making Bulk Updates to Operational Settings
Preserving Operational Settings During Resource Imports
9
Customizing Oracle Service Bus Environments
About Environment Values
Find and Replace
Configuration Files
Schema Files
Operational Settings
Environment Values
Find and Replace
Reference Mapping
Finding and Replacing Environment Values Using the Oracle Service Bus Console
Finding Environment Values
Replacing Environment Values
Using Configuration Files to Update Environment Values and Operational Settings
Creating a Configuration File
Executing a Configuration File
Available Environment Values
Environment Values for Operational Settings
Sample Configuration Files
10
Importing and Exporting Oracle Service Bus Resources
About Importing and Exporting Oracle Service Bus Resources
Exporting Oracle Service Bus Resources in Fusion Middleware Control
Importing Oracle Service Bus Resources in Fusion Middleware Control
11
Defining Access Security for Oracle Service Bus
Understanding Oracle Service Bus Application Security
Users
Groups
Roles
Oracle Service Bus Application Roles
MiddlewareAdministrator
Developer
Composer
Deployer
Tester
MiddlewareOperator
ApplicationOperator
Monitor
WebLogic Server Security Roles
Compatibility with Previous Releases
Access Control Policies
Security Configuration Data and Sessions
Security Configuration During Exports
Configuring Oracle Service Bus Administrative Security
How to Grant Permissions to Individual Users
How to Grant Permissions to Users in User Groups
Creating Oracle Service Bus Groups
Granting Permissions to Groups
Assigning a Group to an Application Role
Granting Individual Permissions to a Group
Creating Oracle Service Bus Users
Granting Access Permissions By Assigning Users to Groups
Granting Permissions to Individual Users
Assigning a User to an Application Role
Granting Individual Permissions to a User
Securing Oracle Service Bus in a Production Environment
Undeploying the Service Bus (SB) Resource
Protection of Temporary Files With Streaming body Content
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
Introduction to the Service Bus Reporting Framework
Message Report Configuration
Default Reporting Provider
Custom Report Providers
Reporting Workflow
About the JMS Reporting Provider
About the Pipeline Report Action
Reporting Actions in Global Transactions
Configuring a Database for the JMS Reporting Provider Store
Configuring the Reporting Data Source for Transactions
Creating a Database for the JMS Reporting Provider Store
Enabling Message Reports
Working With Message Reports
Searching for Message Reports
Viewing Message Report Details
About Purging Message Reports from the Reporting Data Store
Purging Message Reports from the Reporting Data Store
Stopping a Reporting Provider
Starting a Reporting Provider
Untargeting a JMS Reporting Provider
Untargeting the Default JMS Reporting Provider During Domain Creation
Untargeting the JMS Reporting Provider when the Server is Running
Untargeting the JMS Reporting Provider When the Server in Not Running
Using Oracle Advanced Queueing JMS
13
Monitoring and Managing Security Policies
Introduction to Security Policies
Configuring Global Policies
How to Create a Global Policy Set
How to Enable a Service for Global Policies
How to Disable a Service for Global Policies
Monitoring Security Policies
Viewing the Policies Attached to a Service
Monitoring Policy Usage
Viewing Policy Violations
Managing Security Policies
Attaching Security Policies Directly to a Service
Detaching Policies from a Service
Overriding Security Policies
14
Monitoring and Managing Endpoint URIs for Business Services
About Endpoint URI Management
About Endpoint URIs
Offline and Online Endpoint URIs
About Temporarily Offline Endpoint URIs
About Permanently Offline Endpoint URIs
Offline URIs in Clustered Environments
Metrics for Monitoring Endpoint URIs
Endpoint URI State
Endpoint URI Performance Metrics
Configuring Service Bus to Take Unresponsive Endpoint URIs Offline
Marking an Endpoint URI Offline Manually
Marking an Offline URI as Online
Viewing Endpoint URI Metrics for a Business Service
Creating Alerts Based on Endpoint URI Metrics
About Creating an SLA Alert Based on Endpoint URI Status
Creating an SLA Alert Based on Endpoint URI Status
Configuring an Alert Rule Based on Endpoint URI Statistics
15
Configuring Business Services for Message Throttling
Introduction to Throttling
Throttling Concepts
Throttling Properties
Maximum Concurrency
Throttling Queue Length
Message Expiration (TTL)
Throttling Groups
Throttling Group Properties and Business Service Throttling Properties
Throttling for Business Services with Multiple Endpoint URIs
Throttling Retried Messages
Throttling and Work Managers
Throttling in a Cluster
Throttling Metrics
Using Throttling Metrics to Define Alerts
Configuring Throttling for a Single Business Service
Configuring Throttling for a Single Business Service
Disabling Throttling for a Single Business Service
Configuring Throttling for a Group of Business Services
Creating Throttling Groups
Associating Business Services with a Throttling Group
Editing Throttling Groups
Deleting a Throttling Group
16
Managing Resequencer Tables
About the Resequencer Database Tables
Database Table Purge Scripts
Automatic Purging of Completed Resequencer Messages
The Datasource for Resequencing
Purge Scripts and Resequenced Message Purge States
Purging Oracle Service Bus Resequencer Data
Configuring the Resequencer to Automatically Purge Completed Messages
Using SQL Scripts to Purge Resequencer Tables
Setting up the Environment and Scripts
Running the Oracle Service Bus Purge Procedure
Running the Service Bus Purge Scripts
Running the SOA Suite Purge Scripts (In Looped Mode)
Reconfiguring an Active Resequencer is not Supported
Part V Troubleshooting Oracle Service Bus Services
17
Using Execution Tracing to Diagnose Problems
Introduction to Execution Tracing
Enabling and Disabling Execution Tracing
Setting Oracle WebLogic Server Log Levels
Configuring Execution Tracing for a Single Service
Configuring Execution Tracing for Multiple Services
Accessing Execution Tracing Information
18
Using the Diagnostic Frameworks to Diagnose Problems
Understanding Diagnostics for Oracle Service Bus
Oracle WebLogic Diagnostic Framework
Watches and Notifications
Diagnostic Scenarios and MBeans
Oracle Fusion Middleware Diagnostic Framework
Diagnostic Dumps
About the Automatic Diagnostic Repository
Predefined Incident Processing Rules
Dynamic Monitoring Service Metrics
Working with Oracle Service Bus Diagnostic Dumps
Listing the Available Diagnostic Dumps
Derived Resource Caches Diagnostic Dumps (OSB.derived-caches)
Oracle Service Bus Derived Resource Caches
Viewing a description of the derived resource caches dump
Running the derived resource caches dump
Sample Output of the Derived Resource Cache Dump
Running a JMS Correlation Table Diagnostic Dump (OSB.jms-async-table)
Viewing a Description of the JMS Correlation Table Dump
Running the JMS Correlation Table Dump
Sample Output of the JMS Correlation Table Dump
Running an MQ Correlation Table Diagnostic Dump (OSB.mq-async-table)
Viewing a Description of the MQ Correlation Table Dump
Running the MQ Correlation Table Dump
Sample Output of the MQ Correlation Table Dump
Generating Diagnostic Dumps Using RDA
Viewing Incident Packages with ADR Tools
Querying Problems and Incidents
Appendixes
A
JMX Monitoring API
Introduction to the JMX Monitoring API
Using the JMX Monitoring API
Public POJO Objects
ResourceType
ServiceResourceStatistic
ResourceStatistic
StatisticValue
StatisticType
ServiceDomainMBean
MonitoringConfigurationMBean
Statistics Collected for Oracle Service Bus
Statistics Details for Resource Type - SERVICE
Statistics for Resource Type–FLOW_COMPONENT
Statistics details for Resource Type – WEBSERVICE_OPERATION
Statistics details for Resource Type – URI
Caveats
Performance
API Usage Example
Sample Program
B
Using the Oracle Service Bus Deployment APIs
Deployment MBean Overview
Managing Sessions Using Programs and Scripts
Creating, Activating, Discarding, and Locating Sessions
Managing Configuration Tasks Using Programs and Scripts
Importing, Exporting, and Querying Configurations
Updating Environment-Specific Information
C
Auditing Your Oracle Service Bus System
Auditing the Configuration Changes
Creating an Audit Trail for a Message Flow
Auditing Security Violations
D
Interoperability with WSRP
WSRP Producers and Consumers
WSRP Architecture
Enhanced Architecture with Oracle Service Bus
WSRP Design Concepts
WSRP WSDL Documents
WSRP Messages
Configuring Oracle Service Bus for WSRP
Getting the Producer WSDL Document
Using SSL with WSRP Producers
Routing Messages Between Consumer and Producer
Monitoring WSRP Applications
Load Balancing and Failover
WSRP Limitations Without Session Stickiness
Using WSRP with HTTP Session Stickiness
E
Role-Based Access in Oracle Service Bus
Application Security Roles
Application Role-Based Access in Oracle Service Bus Console
Application Role-Based Access to Resource Actions
Application Role-Based Access to Administration Functions
Application Role-Based Access to Session Management
Application Role-Based Access in Fusion Middleware Control
Enterprise Security Roles
Enterprise Role-Based Access in Oracle Service Bus Console
Enterprise Role-Based Access to Resource Actions
Enterprise Role-Based Access to Administration Functions
Enterprise Role-Based Access to Session Management
Enterprise Role-Based Access in Fusion Middleware Control
Role-Based Security Configuration Access
Scripting on this page enhances content navigation, but does not change the content in any way.