Go to main content
1/61
Contents
Title and Copyright Information
Preface
Audience
Related Documents
Conventions
What's New in This Guide
New and Changed Features for 12c (12.1.3)
Other Significant Changes in this Document for 12c (12.1.3)
Part I Introduction to Oracle SOA Suite and Oracle Business Process Management Suite
1
Introduction and Concepts
1.1
What Is Oracle Fusion Middleware?
1.2
What Is Oracle SOA Suite?
1.2.1
Introduction to the SOA Infrastructure Application
1.2.2
Introduction to Partitions
1.2.3
Introduction to SOA Composite Applications
1.2.4
Introduction to Business Flow Instances
1.2.5
Introduction to Service Components
1.2.5.1
Spring Service Component Support
1.2.6
Introduction to Binding Components
1.2.7
Introduction to Service Engines
1.2.8
Introduction to the Service Infrastructure
1.2.9
Introduction to the Contents of SOA Composite Applications
1.2.10
Introduction to Oracle SOA Suite and Oracle Enterprise Scheduler Integration
1.2.10.1
Cross-Component Wiring Between Oracle SOA Suite and Oracle Enterprise Scheduler
1.3
What Is Oracle Business Process Management Suite?
1.4
Administration of Oracle SOA Suite and Oracle BPM Suite
1.4.1
Configuration of Oracle SOA Suite and Oracle BPM Suite
1.4.1.1
Introduction to the Order of Precedence for Audit Level Settings
1.4.2
Monitoring of Oracle SOA Suite and Oracle BPM Suite
1.4.3
Management of Oracle SOA Suite and Oracle BPM Suite
1.4.3.1
Introduction to Fault Recovery in the Error Hospital
1.4.3.2
Introduction to Policies
1.4.3.2.1
Introduction to How Policies are Executed
1.4.3.3
Introduction to the Lifecycle State of SOA Composite Applications
1.4.3.4
Introduction to SOA Composite Application Automated Testing
1.4.4
Performance and Tuning of Oracle SOA Suite and Oracle BPM Suite
1.5
Administration for Application Developers
1.6
Administration with Oracle Enterprise Manager 12c Cloud Control and the Oracle SOA Management Pack
Part II Getting Started with Administration
2
Getting Started with Administering Oracle SOA Suite and Oracle BPM Suite
2.1
Logging In to Oracle Enterprise Manager Fusion Middleware Control
2.2
Navigating to Oracle SOA Suite and Oracle BPM Suite Administration Tasks
2.2.1
Navigating Through the SOA Infrastructure Home Page and Menu
2.2.2
Navigating Through the SOA Composite Application Home Page and Menu
2.2.3
Navigating Through the Partition Home Page and Menu
2.2.4
Navigating to Deployed Java EE Applications
2.2.5
Navigating to the Oracle WebLogic Server Administration Console and Other Pages
2.2.6
Navigating to the SOA Infrastructure or SOA Composite Application Home Page from the WebLogic Domain Home Page
2.3
Accessing Context Sensitive Online Help
2.4
Navigating to the System MBean Browser
2.4.1
Accessing the System MBean Browser from the Main Page
2.4.2
Accessing the System MBean Browser from the Component Property Pages
2.5
Logging Out of Oracle Enterprise Manager Fusion Middleware Control
2.6
Setting Accessibility Options
Part III Administering the SOA Infrastructure
3
Configuring the SOA Infrastructure
3.1
Configuring SOA Infrastructure Properties
3.1.1
To configure SOA Infrastructure properties:
3.1.2
Configuring Oracle SOA Suite and Oracle BPM Suite Profiles
3.1.3
Configuring the Audit Trail, Payload Validation, and Default Query Duration
3.1.4
Configuring UDDI Registry Properties
3.1.5
Configuring Callback Server and Server URLs
3.1.6
Configuring Analytics and Sensors
3.1.7
Configuring Data Sources and Web Service Binding Properties
3.1.8
Configuring SOA Infrastructure Advanced Configuration Properties
3.2
Stopping and Starting the Managed Server and SOA Infrastructure
3.2.1
SOA Composite Application States and SOA Infrastructure Shutdown
3.2.2
Restarting the SOA Infrastructure Does Not Activate Endpoints When a Retired Composite is Activated
3.2.3
SOA Infrastructure Startup Failure When cwallet.sso Includes the SOA Map
3.3
Changing the SOA Infrastructure Server URL Property Port in the System MBean Browser
3.4
Configuring Log Files
3.4.1
Configuring the Logging File Encoding Property
3.4.2
Configuring Logging to Diagnose Performance Issues in Oracle Enterprise Manager Fusion Middleware Control Pages
3.5
Changing the Driver Name to Support Custom XA Drivers
3.6
Specifying a Nondefault XA Transaction Timeout Value for XA Data Sources
3.7
Configuring Database-bound Processing Threads
3.7.1
To change the maximum capacity for the SOADataSource property:
3.7.2
To configure the SOAMaxThreadsConfig property:
3.8
Configuring Local Optimization
3.8.1
Condition Checks for Using Local Optimization
3.8.2
Overriding or Forcing Local Optimization
3.8.3
Local Optimization Logging
3.8.4
Local Optimization Calls Use Case
3.9
Managing Global Token Variables for Multiple SOA Composite Applications
3.9.1
Managing Global Token Variables in the Token Configurations Page
3.9.2
How Global Token Variables are Substituted at Runtime
3.9.3
Using Predefined Global Token Variables
4
Monitoring the SOA Infrastructure
4.1
Monitoring the Overall Status of the SOA Infrastructure or Individual Partition
4.1.1
Viewing Key Configuration Settings
4.1.2
Viewing the Overall Runtime Health of the SOA Infrastructure
4.1.3
Viewing System Backlogs in the SOA Infrastructure
4.1.4
Viewing Business Transaction Faults
4.1.5
Viewing SOA Composite Applications and Adapters Availability
4.1.6
Searching for Instances and Bulk Recovery Jobs
4.1.7
Viewing Error Notification Alerts
4.2
Discovering the Oracle SOA Suite Routing Topology
4.3
Monitoring SOA Infrastructure Performance Summary Metrics
4.4
Monitoring Message Delivery Processing Requests
4.5
Monitoring Service and Reference Binding Components in the SOA Infrastructure
5
Tracking Business Flow Instances
5.1
Tracking Business Flow Instances at the SOA Infrastructure or Partition Level
5.1.1
Specifying and Saving Business Flow Search Criteria
5.1.1.1
Executing Predefined Business Flow Instance Searches
5.1.1.2
Using the Search Options Toolbar
5.1.1.3
Adding and Removing Search Filters
5.1.1.4
Configuring and Saving Business Flow Instance Search Filter Criteria
5.1.2
Deleting or Terminating Business Flow Instances
5.1.3
Viewing the Current State of the Business Flow Instance
5.1.4
Recovering from Faults in a Business Flow Instance
5.1.5
Viewing Composite Sensor Values in a Business Flow Instance
5.1.6
Viewing the Initiating and Participating SOA Composite Applications in a Business Flow Instance
5.1.7
Viewing Resequencing Groups in a Business Flow Instance
5.1.8
Viewing Business Flows that Extend Across Domains
5.1.9
Partition-Level and Composite-Level Search Results for Redeployed Composites with the Same Revision Number
6
Recovering From Faults in the Error Hospital
6.1
Managing Faults in the Error Hospital
6.1.1
Specifying and Saving Fault Search Criteria
6.1.1.1
Executing Predefined Fault Instance and Custom Searches
6.1.1.2
Using the Report Filters Toolbar
6.1.1.3
Configuring and Saving Fault Search Filter Criteria
6.1.2
Viewing Aggregated Fault Statistics to Examine Fault Trends
6.1.2.1
To View Aggregated Fault Statistics to Examine Fault Trends:
6.1.3
Performing Bulk Fault Recoveries and Terminations in a Single Operation
6.1.4
Accessing Faults in the Fault Statistics Table to Perform Single Fault Recovery Operations
6.1.5
Understanding Additional Message and Fault Recovery Behavior Scenarios
6.1.5.1
Recoverable Messages are Displayed as Unrecoverable in the Error Hospital
6.1.5.2
Unrecoverable Binding Component Faults are Displayed as Recoverable
6.1.5.3
BPEL Process Messages Awaiting Recovery with no Associated Instance Faults Do Not Appear on the Error Hospital Page
6.2
Creating Error Notification Rules
6.2.1
To create error notification rules:
6.2.2
Error Notification Rules Associated with an Expired Schedule
7
Managing Partitions and Work Manager Groups
7.1
Managing Partitions
7.1.1
Creating Partitions
7.1.2
Deleting Partitions
7.1.3
Changing the Work Manager Group of a Partition
7.1.4
Performing Bulk Lifecycle Management Tasks on Composites in Partitions
7.2
Managing Work Manager Groups
7.2.1
Viewing and Configuring Work Manager Properties
7.2.1.1
Viewing and Configuring Work Manager Constraints
7.2.2
Viewing Work Manager Pending and Completed Requests
7.2.3
Viewing and Creating Work Manager Groups
7.3
Securing Access to Partitions
7.3.1
Viewing Partition Roles
7.3.2
Viewing the Permissions Assigned to Each Partition Role
7.3.3
Assigning Users to Partition Roles
7.3.4
Understanding Additional Permission and Role Behavior Scenarios
7.3.4.1
Understanding Permissions on Initiating and Participating Composites in Different Partitions
7.3.4.2
Viewing Oracle SOA Composer Permission Actions in a Partition
7.3.4.3
Understanding the MDS Configuration Page and Oracle SOA Suite Permissions
Part IV Administering SOA Composite Applications and Instances
8
Securing SOA Composite Applications
8.1
Introduction to Securing SOA Composite Applications
8.2
Configuring Oracle HTTP Server with Oracle BPM Worklist
8.3
Setting up SAML Message-Protected Policy Configuration for the SOA Infrastructure
8.4
Automatically Authenticating Oracle BPM Worklist and Oracle Business Process Management Users
8.4.1
Automatically Authenticating Oracle BPM Worklist Users in SAML SSO Environments
8.4.2
Automatically Authenticating Oracle BPM Workspace Users in SAML SSO Environments
8.4.3
Automatically Authenticating Oracle Business Process Composer Users in SAML SSO Environments
8.4.4
Automatically Authenticating Oracle BPM Worklist Users in Windows Native Authentication Environments
8.4.5
Automatically Authenticating Oracle Business Process Composer Users in Windows Native Authentication Environments
8.5
Setting the Authentication Provider
8.5.1
Listing Oracle Internet Directory as the First Authentication Provider
8.5.2
Accessing Web-based Applications with the Default Authentication Provider
8.5.3
Enabling Multiple Authentication Providers
8.6
Invoking a Web Service that Requests NTLM Authentication
8.7
Configuring SSL
8.7.1
Using SSL Certificates When the SOA/BPM Server Is Configured with an HTTPS Port
8.7.2
Recommendation to Configure Either All or No Managed Servers with SSL
8.7.3
Switching from Non-SSL to SSL Configurations with Oracle BPM Worklist
8.7.4
Configuring SOA Composite Applications for Two-Way SSL Communication
8.7.4.1
To enable two-way SSL for a SOA composite application to invoke another application:
8.7.5
Invoking References in One-Way SSL Environments in Oracle JDeveloper
8.7.6
Configuring Oracle SOA Suite and Oracle HTTP Server for SSL Communication
8.7.6.1
Configuring Oracle HTTP Server for SSL Communication
8.7.6.2
Configuring Certificates for Oracle Client, Oracle HTTP Server, and Oracle WebLogic Server
8.7.7
Configuring SSL Between Business Flow Instances and Oracle WebCache
8.7.8
Using a Custom Trust Store for One-Way SSL During Design Time
8.7.9
Configuring an Asynchronous Process Deployed to an SSL-Enabled Managed Server to Invoke Another Asynchronous Process Over HTTP
8.8
Configuring Security for Human Workflow WSDL Files
9
Monitoring SOA Composite Applications
9.1
Monitoring SOA Composite Application Performance Summary Metrics
9.2
Viewing the SOA Composite Application Diagram
9.3
Monitoring the Service Components and Binding Components of a SOA Composite Application
10
Deploying and Managing SOA Composite Applications
10.1
Deploying SOA Composite Applications
10.1.1
To Deploy SOA Composite Applications:
10.1.2
Understanding Additional Deployment Behavior Scenarios
10.1.2.1
PermGen Memory Requirements for Multiple ADF Task Form Deployments
10.1.2.2
Deploying SOA Composite Applications with Task Flows
10.1.2.3
Deploying SOA Composite Applications with ant Scripts and the WLST Command Line Tool
10.2
Updating Instance, Fault, and Rejected Message States to Aborted During Undeployment or Redeployment
10.3
Redeploying SOA Composite Applications
10.3.1
Redeploying SOA Composite Applications with the Same Revision ID Without Changing the Initial Running Instance to Aborted
10.3.1.1
Examples of Redeployment Behavior for Synchronous and Asynchronous BPEL Processes
10.4
Undeploying SOA Composite Applications
10.5
Managing the State of Deployed SOA Composite Applications
10.5.1
Managing the State of All Applications at the SOA Infrastructure Level
10.5.2
Managing the State of an Application from the SOA Composite Application Home Page
10.5.3
Understanding Additional Lifecycle State Behavior Scenarios
10.5.3.1
Starting and Stopping a Managed Oracle WebLogic Server on Which the SOA Infrastructure is Deployed in the Middle of BPEL Processing
10.5.3.2
Setting the Business Flow Instance Name
10.6
Automating the Testing of SOA Composite Applications
10.6.1
Increasing Response Message Size When Executing Test Suites in Bulk
10.7
Managing SOA Composite Application Policies
10.7.1
Policy Subject of a Local Policy Can Become Invalid After a Server Restart
10.7.2
Policy Attachments and Local Optimization in Composite-to-Composite Invocations
10.7.3
WS-RM Sessions
10.8
Exporting a Deployed SOA Composite Application
10.9
Disabling and Enabling the Collection of Analytic, BPEL Sensor, and Composite Sensor Data
10.9.1
Disabling Analytics and Sensors for a Specific SOA Composite Application
10.9.2
Disabling Analytics and Sensors for All SOA Composite Applications
10.9.3
Selectively Disabling Specific Analytic and Sensor Settings for All SOA Composite Applications
10.10
Linking to Runtime Applications
11
Managing SOA Composite Application Business Flow Instances
11.1
Initiating a Test Instance of a Business Flow
11.1.1
Specifying RPC/Literal-Style WSDL Files on the Test Web Service Page
11.2
Tracking Business Flow Instances at the SOA Composite Application Level
12
Developing a Database Growth Management Strategy
12.1
Introduction to Planning for Database Growth
12.2
Identifying the Profile or Size of the Database
12.2.1
Identifying the Inflow of Data
12.2.1.1
Identifying the Number of Instances Produced Daily
12.2.1.2
Identifying the Disk Space Used by Each Instance
12.2.1.3
Identifying the Composite Space Persisted Daily
12.2.1.4
Analyzing Space Distribution of Oracle SOA Suite Segments
12.2.2
Developing a Retention Policy
12.2.2.1
Determining the Minimum Retained Disk Space
12.2.2.2
Determining the Minimum Number of Retained Composites
12.2.3
Identifying the Outflow of Data
12.2.4
Identifying Long Running Composites and Table Partitioning
12.2.4.1
Recommendations for Each Table to Partition
12.3
Monitoring Space Usage, Hardware Resources, and Database Performance
12.3.1
Monitoring Space Usage
12.3.1.1
Determining the Growth Trend of Components
12.3.1.2
Determining the Growth Trend of the Oracle SOA Suite Schema
12.3.1.3
Determining the Largest Segments
12.3.1.4
Determining the Growth Trend of Tables and Indexes
12.3.1.5
Estimating Table Size
12.3.1.6
Estimating Index Size
12.3.1.7
Monitoring Unused Indexes
12.3.2
Monitoring the Hardware Resources and Database
12.3.2.1
Hardware - OSWatcher Black Box
12.3.2.2
Database – AWR / ADDM
12.3.2.3
Disk I/O - Oracle Orion
12.4
Understanding Growth Management Challenges and Testing Strategies
12.4.1
Database Growth Management Challenges
12.4.1.1
Excessive Growth of Oracle SOA Suite Tables Due to an Ineffective Growth Management Strategy
12.4.1.2
Tuned Parallel Purge Script Cannot Handle the Inflow
12.4.2
Quality Assurance Testing
12.4.2.1
Reviewing Metalink Support Note 1384379.1
12.4.2.2
Configuring the Production Audit Level Setting
12.4.2.3
Creating an Oracle SOA Suite Schema - Test Environment
12.4.2.3.1
Measure Inflow and Space Estimations
12.4.2.3.2
Base Point Backup of Test Environment
12.4.2.4
Executing the Parallel or Single Threaded Script and Reclaiming Space
12.4.2.5
Reviewing the Testing Results
12.4.2.6
Partitioning the Tables Causing a Bottleneck
12.4.2.6.1
Base Point Backup with Partitioned Table
12.4.2.7
Repeating Purge Testing and Review and Excluding the Partitioned Table
12.4.3
Recommended Growth Management Strategies
12.4.3.1
Recommendations for Large Database Profiles
12.4.3.2
Recommendations for Small Database Profiles
12.5
Understanding Space Management
12.5.1
Introduction to the Components of a Data File
12.5.1.1
Segment High Water Mark
12.5.2
Reclaiming Segment and Data File Space
12.5.2.1
Performing an Online Segment Shrink
12.5.2.2
Deallocating Unused Space
12.5.2.3
Coalescing or Rebuilding indexes
12.5.2.4
Dropping Table Partitions
12.5.2.4.1
Dropping a Partition
12.5.2.5
Configuring Secure File LOBs
12.5.2.5.1
Secure File Requirements
12.5.2.5.2
Converting Secure Files
12.5.2.5.3
Migrating Secure Files
12.5.2.6
Additional Database Management Methods
12.5.2.6.1
TRUNCATE Statement
12.5.3
Resizing Data Files
13
Managing Database Growth
13.1
Introduction to Managing Database Growth
13.2
Developing a Purging and Partitioning Methodology
13.3
Deleting Large Numbers of Flow Instances, Adapter Reports, and Fault Alerts
13.3.1
Purge States
13.3.2
Deleting Large Numbers of Instances with Oracle Enterprise Manager Fusion Middleware Control
13.3.3
Deleting Large Numbers of Instances with SQL*Plus
13.3.3.1
Looped Purge Script
13.3.3.1.1
delete_instances Procedure
13.3.3.2
Looped Purge in Parallel Script with dbms_scheduler
13.3.3.2.1
delete_instances Procedure in Parallel
13.3.3.3
Running the Purge Scripts
13.3.3.4
Resolving Dead Locks After Running the Looped Purge in Parallel Script
13.3.3.5
Purging the Instances of a Specific SOA Composite Application
13.3.3.6
Resequenced Message Purge States for Oracle Mediator
13.3.4
Monitoring the Status of Purging
13.3.5
Generating a Database SQL Trace
13.4
Partitioning Component Tables
13.4.1
Partitioning the Database with the Repository Creation Utility
13.4.2
Partitioning the Component Database Tables
13.4.2.1
Referential Integrity and Equipartioning
13.4.3
Range Interval Partitioning
13.4.4
Equipartitioning and Range Interval Partitioning
13.4.5
Range Interval Partitioning Example
13.4.6
Introduction to Partition Key Selection
13.4.7
Configuring Partitions
13.4.8
Introduction to the Verification Script
13.4.8.1
Component Tables
13.4.8.1.1
Partitioning Constraints
13.4.8.1.2
Component Tables, Range Partition Keys, and Groups
13.4.8.2
Equipartitioning and Interval Partitioning Verification Script Checks
13.4.9
Running the Verification Script
13.4.10
Moving Active, Long Running Instances to a Different Partition
13.4.11
Routines to Assist with Partition Maintenance
13.4.12
Partial Partitioning of Components
13.5
Removing Records from the Runtime Tables Without Dropping the Tables
14
Diagnosing Problems with SOA Composite Applications
14.1
Introduction to the Diagnostic Frameworks
14.1.1
Introduction to WLDF
14.1.1.1
Introduction to Watches and Notifications
14.1.1.2
Introduction to Diagnostic Scenarios and MBeans
14.1.2
Introduction to the Diagnostic Framework
14.1.2.1
Controlling the Number of Incident Packages
14.1.3
Predefined Incident Processing Rules
14.2
Executing Oracle SOA Suite Diagnostic Dumps
14.2.1
To List the Dumps:
14.2.2
Runtime Environment Diagnostic Dumps (soa.env)
14.2.2.1
WLST Command Dump Description and Execution
14.2.3
Runtime Platform Configuration Diagnostic Dumps (soa.config)
14.2.3.1
WLST Command Dump Description and Execution
14.2.4
Database Diagnostic Dumps (soa.db)
14.2.4.1
WLST Command Dump Description and Execution
14.2.5
Deployed Composite Metadata Diagnostic Dumps (soa.composite)
14.2.5.1
WLST Command Dump Description and Execution
14.2.6
Instance Audit Trail Diagnostic Dumps (soa.composite.trail)
14.2.6.1
WLST Command Dump Description and Execution
14.2.7
Event Diagnostic Dumps (soa.edn)
14.2.7.1
WLST Command Dump Description and Execution
14.2.8
Deployed Composite WSDL/Schema Cache Diagnostic Dumps (soa.wsdl)
14.2.8.1
WLST Command Dump Description and Execution
14.2.9
Dispatcher Static Configuration Diagnostic Dumps (bpel.dispatcher)
14.2.9.1
WLST Command Dump Description and Execution
14.2.9.2
Obtaining Dispatcher Static Configuration Diagnostic Dumps with the System MBean Browser
14.2.10
Average Instance Processing Time Diagnostic Dumps (bpel.apt)
14.2.10.1
WLST Command Dump Description and Execution
14.2.11
Average Instance Processing Delay Diagnostic Dumps (bpel.apd)
14.2.11.1
WLST Command Dump Description and Execution
14.2.12
Synchronous Process Statistics Diagnostic Dumps (bpel.sps)
14.2.12.1
WLST Command Dump Description and Execution
14.2.13
Asynchronous Process Statistics Diagnostic Dumps (bpel.aps)
14.2.13.1
WLST Command Dump Description and Execution
14.2.14
Request Statistics Diagnostic Dumps (bpel.rs)
14.2.14.1
WLST Command Dump Description and Execution
14.2.15
Resequencer Group Processing Delay Diagnostic Dumps (mediator.resequencer)
14.2.15.1
WLST Command Dump Description and Execution
14.2.16
Adapter Diagnostic Dumps (soa.adapter.ra)
14.2.16.1
WLST Command Dump Description and Execution
14.2.17
Adapter Diagnostic Dumps (soa.adapter.connpool)
14.2.17.1
WLST Command Dump Description and Execution
14.2.18
Adapter Diagnostic Dumps (soa.adapter.stats)
14.2.18.1
WLST Command Dump Description and Execution
14.3
Executing Diagnostic Framework Thread Dumps for SOA Composite Applications
14.3.1
WLST Command Dump Description and Execution
14.4
Supported DMS Metrics
14.5
Creating Watches and Notifications
14.5.1
Enabling Preconfigured Rules and Watches
14.5.2
Manually Creating Oracle SOA Suite Watches and Notifications
14.5.3
Creating a Watch to Identify the Elapsed Time of Web Service Binding Calls
14.5.4
Creating a Watch to Identify if Processing Delays Exceed a Specified Time Limit
14.5.5
Creating Resequencer Watches and Notifications
14.6
Manually Triggering and Executing Dumps
14.7
Viewing Incident Packages with ADR Tools
14.8
Querying Problems and Incidents
Part V Administering BPEL Process Service Components and Engines
15
Configuring BPEL Process Service Components and Engines
15.1
Configuring BPEL Process Service Engine Properties
15.2
Configuring Automatic Recovery for Oracle BPEL Process Manager
15.3
Configuring Master Node Recovery Scheduling
15.4
Configuring Automatic Recovery Attempts for Invoke and Callback Messages
15.5
Preserving the Order of Callback Messages
15.6
Setting the Audit Level at the BPEL Process Service Component Level
16
Monitoring BPEL Process Service Components and Engines
16.1
Monitoring the Flow Trace of a Business Flow Instance
16.1.1
Recovering from Faults in the Flow Trace
16.1.2
Viewing Composite Sensor Values in the Flow Trace
16.1.3
Viewing the SOA Composite Application in the Flow Trace
16.1.4
Viewing the Audit Trail and Process Flow in the Flow Trace
16.1.5
Monitoring Fault, Activity, and Variable Sensors in the Flow Trace
16.1.6
Understanding Additional Flow Trace Behavior Scenarios
16.1.6.1
Behavior of Activity Sensors in Compensate and CompensateScope Activities in BPEL 2.0
16.2
Monitoring the Time Distribution of BPEL Process Activities and Instance and Fault Throughput Metrics
16.3
Monitoring BPEL Process Service Engine Request and Thread Performance Statistics
16.3.1
Viewing Low Level Request Breakdown Table Details
16.4
Monitoring Deployed BPEL Process Service Components in the Service Engine
16.5
Viewing Statistics About the Time a Request Spends in the BPEL Process Service Engine
17
Managing BPEL Process Service Components and Engines
17.1
Managing BPEL Process Service Component Policies
17.2
Performing BPEL Process Service Engine Message Recovery
17.3
Storing Instance and Message Data in Oracle Coherence Distributed Cache on Oracle Exalogic Platforms
17.3.1
Introduction to the Oracle Coherence Caching Architecture
17.3.2
Running with Default SOA Cluster Nodes and Coherence Cache Grid Nodes
17.3.3
Configuring Oracle Coherence Caching
17.3.4
Configuring the Storage of Multiple Audit Trail Messages in One Transaction
17.3.5
Configuring the Storage of the Audit Trail to Oracle Coherence Cache
17.3.6
Configuring the Storage of Invocation Messages to Oracle Coherence Cache
17.3.7
Starting the BPEL Process Cache Servers
Part VI Administering Oracle Mediator Service Components and Engines
18
Configuring Oracle Mediator Service Components and Engines
18.1
Configuring Oracle Mediator Service Engine Properties
18.1.1
To Access System MBean Browser Properties:
18.2
Configuring Resequenced Messages
19
Monitoring and Managing Oracle Mediator Service Components and Engines
19.1
Introduction to the Oracle Mediator Component Dashboard Page
19.1.1
Routing Statistics Section
19.1.2
Instance Rate Per Min Section
19.2
Monitoring and Managing an Oracle Mediator Service Component
19.2.1
Monitoring Oracle Mediator Service Component Routing Statistics and Instances
19.2.2
Managing Oracle Mediator Policies
19.3
Monitoring an Oracle Mediator Service Engine
19.3.1
Monitoring Request Breakdown Statistics
19.3.2
Monitoring Deployed Oracle Mediator Service Components in the Service Engine
19.4
Monitoring Resequencing Groups
20
Managing Cross-References
20.1
Deleting Cross-Reference Values
Part VII Administering Decision Service Components and Business Rules Service Engines
21
Monitoring Decision Service Service Components and Engine
21.1
Monitoring Business Rules Service Engine Performance Statistics
21.2
Monitoring Business Rules Service Engine Deployed Components
21.3
Monitoring Business Rule Tracing
21.3.1
Tracing Rule Execution at the Development Audit Level
21.3.2
Tracing Rule Execution at the Production Audit Level
21.4
Monitoring Decision Service Service Component Logs
21.4.1
Viewing Decision Service Service Component Logs
21.4.2
Setting the Diagnostic Logging Level with a Log Configuration
Part VIII Administering Human Task Service Components and Human Workflow Service Engines
22
Configuring Human Workflow Service Components and Engines
22.1
Configuring Human Workflow Notification Properties
22.2
Configuring the Notification Service to Send Notifications to a Test Address
22.2.1
How to Remove a Test Address
22.3
Configuring Human Workflow Task Service Properties
22.4
Configuring Oracle HTTP Server for Task Form Attachments
22.5
Configuring Oracle Advanced Queuing for Oracle Human Workflow Notifications
22.6
Configuring the Pluggable Notification Service
22.6.1
Pluggable Notification Service Implementation
22.6.2
Pluggable Notification Service Registration
22.7
Globally Disabling the Automatic Release Timers for Oracle BPM Worklist Tasks
22.8
Configuring the Number of Email Notification Messages
22.9
Configuring Multiple Send Addresses
22.10
Configuring Notification Retries
22.11
Configuring the Identity Service
22.11.1
Adding an Authentication Provider
22.11.1.1
Updating the User Attribute
22.11.1.2
Configuring Multiple Authentication Providers
22.11.2
Creating Users and Groups in the Authentication Provider
22.11.2.1
Creating Users Using WebLogic Console
22.11.2.2
Creating Groups Using WebLogic Console
22.11.2.3
Creating Users and Groups Using Oracle Internet Directory
22.11.2.3.1
How to Create a Domain
22.11.2.3.2
How to Create a User
22.11.2.3.3
How to Create a Group
22.11.2.3.4
How to Delete an Entry
22.11.3
Configuring the Directory Service
22.11.4
Customizing the Identity Provider
22.12
Seeding Users, Groups, and Application Roles using LDAP Tools
22.12.1
Changing the Default Password in the Embedded LDAP Server
22.12.2
Seeding Users or Groups through the LDAP Browser
22.12.3
Seeding Application Roles using WLST Scripts
22.12.4
Managing Application Roles in Oracle Enterprise Manager Fusion Middleware Control
22.13
Enabling Case Agnostic Group Names in Human Tasks
22.14
Configuring Security Policies for Human Workflow Web Services
23
Monitoring Human Workflow Service Components and Engines
23.1
Monitoring Human Workflow Service Engine Active Requests and Operation Performance Statistics
23.2
Monitoring Deployed Human Workflows in the Service Engine
24
Managing Human Workflow Service Components and Engines
24.1
Managing Human Workflow Service Component Policies
24.2
Managing the URI of the Human Workflow Service Component Task Details Application
24.3
Managing Outgoing Notifications and Incoming Email Notifications
24.4
Moving Human Workflow Data from a Test to a Production Environment
24.4.1
Moving Human Workflow Data from Test to Production Environments
24.4.2
migration.properties File Syntax
24.4.2.1
Migration Property File Examples
24.4.2.1.1
Exporting All Attribute Labels
24.4.2.1.2
Importing All Attribute Labels
24.4.2.1.3
Exporting Specific Attribute Labels
24.4.2.1.4
Importing Specific Attribute Labels
24.4.2.1.5
Exporting Task Payload Mapped Attribute Mappings for All Task Definition IDs
24.4.2.1.6
Importing Task Payload Mapped Attribute Mappings for All Task Definition IDs
24.4.2.1.7
Exporting Task Payload Mapped Attribute Mappings for a Specific Task Definition ID
24.4.2.1.8
Importing Task Payload Mapped Attribute Mappings for a Specific Task Definition ID
24.4.2.1.9
Exporting All Rules for a Specific User
24.4.2.1.10
Importing All Rules for a Specific User
24.4.2.1.11
Exporting All Rules for a Specific Group
24.4.2.1.12
Importing All Rules for a Specific Group
24.4.2.1.13
Exporting All User Views
24.4.2.1.14
Importing All User Views
24.4.2.1.15
Exporting a Specific User View
24.4.2.1.16
Importing a Specific User View
24.4.2.1.17
Export All Standard Views
24.4.2.1.18
Importing All Standard Views
24.4.2.1.19
Exporting a Specific Standard View
24.4.2.1.20
Importing a Specific Standard View
24.4.3
ant Script Data Migration Syntax
Part IX Administering Oracle JCA Adapters
25
Configuring Oracle JCA Adapters
25.1
Configuring the Endpoint Properties for an Inbound Adapter
25.1.1
Editing a Predefined Property for an Inbound Adapter
25.1.1.1
Edit a Predefined Property:
25.1.2
Adding Predefined Properties for an Inbound Adapter
25.1.3
Creating a New Property for an Inbound Adapter
25.1.4
Deleting a Property for an Inbound Adapter
25.1.5
Reverting a Property Value for an Inbound Adapter
25.2
Configuring the Endpoint Properties for an Outbound Adapter
25.2.1
Editing a Predefined Property for an Outbound Adapter
25.2.2
Adding a Predefined Property for an Outbound Adapter
25.2.3
Creating a New Property for an Outbound Adapter
25.2.4
Deleting a Property for an Outbound Adapter
25.2.5
Reverting a Property Value for an Outbound Adapter
26
Monitoring Oracle JCA Adapters
26.1
Monitoring Instances and Faults for an Inbound Adapter
26.2
Monitoring Recent Faults and Rejected Messages for an Inbound Adapter
26.3
Monitoring Faults for an Inbound Adapter
26.3.1
Searching for Rejected Messages for an Inbound Adapter
26.3.2
Deleting Rejected Messages for an Inbound Adapter
26.4
Monitoring Properties for an Inbound Adapter
26.5
Monitoring Instances and Faults for an Outbound Adapter
26.6
Monitoring Faults for an Outbound Adapter
26.6.1
Searching for Faults for an Outbound Adapter
26.7
Monitoring Properties for an Outbound Adapter
26.8
Monitoring Adapter Logs
26.9
Adapter Configuration Reports
26.9.1
Enabling Display of Adapter Reports
26.9.1.1
Monitoring Report
26.9.1.2
Configuration Reports
26.9.1.3
Snapshot Reports
26.9.1.3.1
Snapshot Reporting Persistence and Intervals
26.9.2
Configuration Report Categories and Adapter Properties Reported
26.10
Scheduling JCA Adapter Endpoint Activation and Deactivation using Oracle Enterprise Scheduler
26.10.1
Create the Schedule Metadata
26.10.2
Use the Created Schedule Metadata to Schedule the Deactivation and Activation of a SOA Composite JCA Adapter
26.10.3
Editing Oracle Enterprise Scheduler Schedule Metadata
26.10.4
Removing Schedules from an Adapter Endpoint
Part X Administering Oracle B2B and Oracle Healthcare
27
Configuring Oracle B2B
27.1
Configuring Oracle B2B Server Properties
27.2
Configuring Oracle B2B Operations
27.3
Configuring Oracle B2B Attributes
27.4
Configuring Oracle B2B Logging Mode
28
Monitoring Oracle B2B
28.1
Monitoring the Oracle B2B Infrastructure
28.2
Accessing Oracle B2B from the B2B Infrastructure Page
28.3
Viewing the Message Flow of an Oracle B2B Binding Component
28.4
Viewing Services and References
28.5
Accessing Oracle B2B Reports from the Oracle B2B Composite Flow Trace Page
29
Monitoring Oracle Healthcare
29.1
Introduction to the Audit Trail
29.1.1
Oracle SOA Suite for Healthcare Integration Auditing Options
29.1.2
Oracle B2B Auditing Options
29.1.3
Using Filter Conditions for Auditing
29.2
Configuring the Healthcare Integration Audit Trail
29.3
Viewing User Audit Logs
Part XI Administering Binding Components
30
Configuring Service and Reference Binding Components
30.1
Configuring Service and Reference Binding Component Properties
30.1.1
Configuring Properties for Web Services
30.1.2
Configuring Properties for REST Adapters
30.1.3
Configuring Properties for Oracle JCA Adapters
31
Monitoring Service and Reference Binding Components
31.1
Monitoring Binding Component Messages and Faults
32
Managing Service and Reference Binding Components
32.1
Managing Binding Component Policies
32.1.1
Override Policy Configuration Property Values
32.2
Publishing Web Services to the UDDI Registry
32.2.1
Publishing a Web Service to the UDDI Registry
32.3
Changing the Endpoint Reference and Service Key for Oracle Service Registry Integration
32.3.1
Configuring Caching of WSDL URLs
32.4
Publishing and Browsing the Oracle Service Registry
32.4.1
Publishing a Business Service
32.4.2
Creating a Connection to the Registry
32.4.3
Configuring a SOA Project to Invoke a Service from the Registry
32.4.3.1
Dynamically Resolving the SOAP Endpoint Location
32.4.3.2
Dynamically Resolving the WSDL Endpoint Location
32.4.3.3
Resolving Endpoints
32.4.4
Configuring the Inquiry URL, UDDI Service Key, and Endpoint Address for Runtime
32.4.4.1
Changing Endpoint Locations in the Registry Control
32.4.4.1.1
To Update WSDL Binding Overview Documentation:
32.4.4.2
Publishing WSDLs from Multiple SOA Partitions
32.4.5
How to Publish WSDLs to UDDI for Multiple Partitions
Part XII Administering Business Events
33
Managing Business Events
33.1
Introduction to the Event Delivery Network and JMS Provider Types
33.2
Mapping Business Events to JMS Topic Destinations
33.2.1
Creating an Oracle WebLogic Server JMS Topic
33.2.2
Optionally Creating JMS Adapter Connection Factories for Oracle WebLogic Server JMS
33.2.3
Creating an AQ JMS Topic
33.2.4
Exposing an AQ JMS Topic
33.2.5
Optionally Creating JMS Adapter Connection Factories for AQ JMS
33.2.6
Enabling a Remote Client to Interact with an AQ JMS-Based Topic
33.2.7
Mapping Business Events to JMS Topic Destinations on the Business Events Page
33.3
Testing the Publishing of Business Events and Viewing the EDL File
33.4
Viewing Business Event Subscribers
33.5
Resolving Duplicate Messages for Subscribers in Clustered Environments
33.6
Changing the JMS Type
33.7
Configuring the Inbound Poller Thread Number
33.7.1
Updating the Global Inbound Poller Thread Number in the System MBean Browser
33.7.2
Updating the Local Inbound Poller Thread Number Value at the Service Component Level
Part XIII Administering Oracle BPMN Process Service Components and Engines
34
Configuring Oracle BPMN Process Service Components and Engines
34.1
Configuring BPMN Process Service Engine Properties
34.1.1
Configuring the BPMN Service Engine for Process Monitoring
34.2
Integrating Oracle BPM with Oracle BAM 12c
34.2.1
Physical Data Objects
34.2.2
Logical Data Objects
34.2.3
Process Star Schema Database Views
34.2.4
Task 1: Enable Oracle BPM Data Publish to Oracle BAM 12c
34.3
Integrating Oracle BPM with Oracle BAM 11g
34.3.1
Task 1: Configure the Oracle BAM Adapter on Oracle BPM Server
34.3.2
Task 2: Enable Oracle BPM Data Publish to Oracle BAM 11g Monitor Express
35
Monitoring BPMN Process Service Components and Engines
35.1
Viewing the Audit Trail and Process Flow of a BPMN Process Service Component
35.2
Monitoring BPMN Process Service Engine Performance Statistics
35.3
Monitoring Deployed BPMN Processes in the Service Engine
36
Managing Oracle BPMN Service Components and Engines
36.1
Managing BPMN Process Service Component Policies
36.2
Performing BPMN Process Service Engine Message Recovery
36.3
Migrating Instances Between Different Composite Application Revisions
36.3.1
Migration Compatibility
36.3.2
Migrating Instances with the ant Script
36.3.3
Example of Migrating a Revision Instance for Oracle BPM
36.3.3.1
Migrating a Revision Instance
Part XIV Appendixes
A
Installing the Demo User Community in the Database
A.1
Installing the Demo User Community
A.2
Demo Community Users
A.3
Demo Community Groups
A.4
soa-infra Application Roles
A.5
SOATestDemoApp Application Roles
A.6
Roles Granted to and Owned by Users
A.7
WorkflowPermission Class
B
Troubleshooting Oracle SOA Suite and Oracle BPM Suite
B.1
Setting Logging Levels for Troubleshooting
B.1.1
Log Files and Thread Dumps from All Managed Servers
B.2
Parallel Purging and Table Partitioning Issues
B.2.1
Executing the Parallel Purge Script
B.2.1.1
Specifying the Degree of Parallel Value
B.2.1.2
Parsing SOA Composite Applications to Delete
B.2.1.3
Using Parallel Query Slaves
B.2.1.4
Debugging and Tracing Purging Operations
B.2.1.4.1
Debugging Purging Operations
B.2.1.4.2
Tracing Purging Operations
B.2.2
Oracle SOA Suite Table Partitioning
B.2.2.1
Referential Integrity and Equipartitioning
B.2.2.2
SOA Composite Application Range-Hash Partitions
B.2.2.3
Interval Partitioning
B.2.2.4
Global Hash Indexes
B.2.2.5
Partition Pruning
B.2.2.6
Purging Partitions
B.2.3
Reducing Audit Levels
B.2.3.1
Setting the Audit Level for Production Environments
B.3
Connection and Transaction Timeout Troubleshooting
B.3.1
Resolving Connection Timeouts
B.3.2
Resolving Email Notification Timeouts
B.3.3
Increasing Database Connection Values
B.3.4
Updating the EJB Transaction Timeout Value in the Deployment Archive After SOA Infrastructure Failure
B.3.5
Long Running, Synchronous Calls To Remote Web Services Error Out or Asynchronous Transactions Return with an Error after a Long Time
B.3.6
Increasing the HTTP POST Timeout Value to Resolve Broken Pipe Errors
B.3.7
Resolving Exception Errors When Processing Large Documents
B.4
Runtime Diagnostics Troubleshooting
B.4.1
Unavailability of Work Manager Threads for Incoming Processing
B.4.2
Oracle SOA Suite Runtime Failure with a "Cannot read WSDL" Error
B.4.3
Automatic Recovery of BPEL Instances is Not Recovering a Specific Instance
B.4.4
Some Composites Are Retried Multiple Times on Failure
B.4.5
Application Transaction Does Not Complete and the Underlying Composite is Stuck in a Running State
B.4.6
Errors During Analytics Measurement Event Processing
B.5
Human Workflow Troubleshooting
B.5.1
Unavailability of Human Workflow Service Engine
B.5.2
Task Assignment/Routing/Escalation Issues
B.5.3
Task Action Issues
B.5.4
Notification Issues
B.5.5
Task View Issues
B.5.6
Task Attribute Mapping Issues
B.5.7
Task Report Issues
B.5.8
Task History Issues
B.5.9
Task Form/Action Issues
B.5.10
Task Comments/Attachment Issues
B.5.11
Design Time at Runtime Issues
B.5.12
Human Workflow API (Including SOAP/EJB) Usage Issues
B.5.13
Oracle JDeveloper Data Control / Form Generation Issues
B.5.14
Human Workflow Service/ System MBean Browser Issues
B.5.15
AMX Extension Issues
B.5.16
Oracle BPM Worklist/Task Region Issues
B.5.17
Test-to-Production Issues
B.5.18
Identity Service Issues
B.6
Business Events and Event Delivery Network Troubleshooting
B.6.1
Increasing the JMS Adapter Connection Pool Size
B.6.2
Tuning Recommendations For Publishing Many BPEL Process Events with Oracle WebLogic Server JMS
B.6.3
Tuning EDN Event Bus and Delivery
B.6.4
Events Are Consumed by Multiple Revisions of the Same Composites
B.6.5
Business Event Is Picked Up Twice (Or More) By SOA Server
B.6.6
Some Messages Are Lost Between EDN and Composites or Composites Across Clusters
B.7
Performance Troubleshooting
B.7.1
Resolving Issue Where BPEL Compiler Does Not Terminate or Report Exceptions
B.7.2
Resolving Message Failure Caused by Too Many Open Files
B.7.3
Resolving MaxMessageSizeExceededException Errors Caused By Large Payloads
B.7.4
Extending Tablespaces to Avoid Problems at Runtime
B.7.5
Resolving Database Growth Issues Caused by a High Volume of Transactions
B.7.6
Observing Slow Application Performance Such as Longer Time to Serve Pages or Finish Transactions
B.7.7
Observing Incoming Message Rates Exceeding Outgoing Message Rates
B.8
Server Troubleshooting
B.8.1
Best Practices for Starting and Stopping a Managed Server
B.8.2
Diagnosing SOA Server Startup Problems
B.8.3
Specifying the Proxy Server
B.8.4
Flow Diagram Does Not Display The First Time on Some Lower End Hosts
B.8.5
Accessing Oracle Enterprise Manager Fusion Middleware Control on Dual Stack Hosts that Support IPv4 and IPv6
B.9
Browser Troubleshooting
B.9.1
Limitation on Using the Safari Browser to View WSDL File Content
B.10
Additional Troubleshooting Documentation
Scripting on this page enhances content navigation, but does not change the content in any way.