Click the Show only recoverable faults checkbox to only display faults from From the Fault Type list, select to display all faults, system faults, business From the View list, select Columns Fault ID to display the fault IDs for each In the Composite col

13-12 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite Part VI Administering Oracle Mediator Service Components and Engines This part describes how to administer Oracle Mediator service components and engines. This part includes the following chapters: ■ Chapter 14, Configuring Oracle Mediator Service Components and Engines ■ Chapter 15, Monitoring Oracle Mediator Service Components and Engines ■ Chapter 16, Managing Oracle Mediator Service Components and Engines ■ Chapter 17, Managing Cross-References 14 Configuring Oracle Mediator Service Components and Engines 14-1 14 Configuring Oracle Mediator Service Components and Engines This chapter describes how to configure Oracle Mediator service components and service engines. This chapter includes the following topics: ■ Section 14.1, Configuring Oracle Mediator Service Engine Properties ■ Section 14.2, Configuring Resequenced Messages

14.1 Configuring Oracle Mediator Service Engine Properties

You can configure Oracle Mediator service engine properties, which are used by the Oracle Mediator service engine during processing of Oracle Mediator service components. To configure Oracle Mediator service engine properties: 1. Access this page through one of the following options: The Mediator Service Engine Properties page displays the following properties: From the SOA Infrastructure Menu... From the SOA Folder in the Navigator... 1. Select SOA Administration Mediator Properties . 1. Right-click soa-infra. 2. Select SOA Administration Mediator Properties . 14-2 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite 2. Make changes to the service engine properties that are appropriate to your environment. Configuring Oracle Mediator Service Components and Engines 14-3 Property Description Audit Level You can configure the Oracle Mediator-specific audit levels. The value of this property overrides the value of the global SOA Infrastructure audit level property. The possible values of this property are: ■ Off : Switches off auditing for Oracle Mediator. Composite instance tracking and payload tracking information are not collected. ■ Inherit : Level of audit is the same as the SOA infrastructure. This setting enables the Oracle Mediator audit level to automatically change, when the global setting is changed. Setting a different audit level tracking, for this page, overrides the tracking set at the SOA Infrastructure level. ■ Production : All events are logged. All audit details, except the details of assign activities, are logged. Instance tracking information is collected, but payload details are not captured and these details are not available in the flow audit trails. This level is optimal for most typical operations and testing. ■ Development : All events and all audit details are logged. In addition, payload details are captured and are available in the flow audit trails. This level is useful for debugging purposes, but may impact performance. The default value of this flag is Inherit. Notes: ■ You do not need to restart the server after changing these properties. ■ Audit levels were known as instance tracking levels in the Oracle Application Server 10g releases. Metrics Level You can set the Oracle Mediator-specific property for configuring the Dynamic Monitoring Service DMS metrics level. DMS metrics are used to measure the performance of application components. The possible values of this property are: ■ Enabled : Enables DMS metrics tracking ■ Disabled : Disables DMS metrics tracking Parallel Worker Threads Specifies the number of parallel dispatchers for message processing. Increase this parameter to increase the number of outbound threads for parallel processing. Parallel Maximum Rows Retrieved Specifies the number of rows retrieved per iteration for parallel processing. You can set the value of this parameter to 50 to 100 times the Parallel Worker Threads property, depending on the memory consumption limit. Note : A large value for this property can result in memory exhaustion. Parallel Locker Thread Sleep sec Specifies the idle time between two successive iterations for retrieving rows, when there is no message for parallel processing. The time is measured in seconds. Error Locker Thread Sleep sec You can configure the errorretry infrastructure by setting this property. This property specifies the idle time between two successive iterations for retrieving errored out messages, when there is no errored out message from parallel processing. The time is measured in seconds. Parameters Specify custom configuration properties. For an example, see Section 14.2, Configuring Resequenced Messages. 14-4 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite 3. If you want to configure advanced Oracle Mediator properties in the System MBean Browser, click More Mediator Configuration Properties. You can also access Oracle Mediator properties in the System MBean Browser through the navigator. To access System MBean Browser properties:

1. From the SOA Infrastructure menu, select Administration System MBean

Browser The System MBean Browser page is displayed.

2. Expand the node oracle.as.soainfra.config in the left pane below the page title.

The Server:soa_server1 node is displayed. 3. Expand the Server:soa_server1 node. The MediatorConfig node is displayed.

4. Expand the MediatorConfig node.

Container ID Refresh Time sec Container ID Lease Timeout sec The heartbeat infrastructure is a part of the Oracle Mediator service engine and detects the absence of an Oracle Mediator service engine instance due to failure or shutdown of a node. The heartbeat infrastructure creates a unique identifier for each instance of the Oracle Mediator service engine and performs the necessary housekeeping tasks, if an Oracle Mediator service engine fails. The heartbeat infrastructure consists of a heartbeat thread. The heartbeat thread periodically updates the time stamp associated with each Oracle Mediator service engines unique identifier. By updating the time stamp associated with it, an Oracle Mediator service engine announces its presence to the other Oracle Mediator service engines. The heartbeat thread also checks if there are unique identifiers that have not been updated for a particular period of time. You can configure the heartbeat framework by setting the following parameters: ■ Container ID Refresh Time sec : Specifies the time interval at which the heartbeat thread periodically updates the time stamp associated with each Oracle Mediator service engines unique identifier. Notes: The default value is 60 seconds. In case of unplanned outages, you must wait as much time as specified with the Container ID Refresh Time interval, after restarting the server. The server requires this much time to complete the instances still in the running state. ■ Container ID Lease Timeout sec : Specifies the time interval at which the heartbeat thread periodically checks if there are unique identifiers that have not been updated for a particular period of time. By configuring these parameters, you can specify the period used by the heartbeat thread to detect the failure of an Oracle Mediator service engine. Resequencer Locker Thread Sleep sec Specifies the sleep time in seconds for a deferred locker when there is no message in the database. Resequencer Maximum Groups Locked Specifies the maximum number of groups locked. Resequencer Worker Threads Specifies the number of resequencers. Property Description Configuring Oracle Mediator Service Components and Engines 14-5 The mediator MBean is displayed. 5. Click the mediator MBean. The properties of the MBean are displayed on the right pane.

6. Change the value of the properties and click Apply.

14.2 Configuring Resequenced Messages

For Oracle Mediator service components to resequence messages, you must configure the following: ■ The worker thread count ■ The maximum number of groups that can be locked by a thread ■ The sleep interval If the Oracle Mediator service component is configured to use best effort resequencing and the messages to process in each batch are based on a time window rather than a maximum number of rows, you can also configure the buffer window. To configure resequenced messages: 1. Access the Oracle Mediator Service Engine Properties page or the System MBean Browser using one of the methods described in Section 14.1, Configuring Oracle Mediator Service Engine Properties. 2. Enter a value for the following Oracle Mediator properties: ■ Resequencer Worker Threads : The number of threads used by resequencers. ■ Resequencer Maximum Groups Locked : The maximum number of group rows retrieved for each locking cycle. ■ Resequencer Locker Thread Sleep : The length of time in seconds for the deferred locker to sleep when there are no messages in the database. 3. To configure the buffer window for the time window in best effort resequencing, enter the following for the Parameters property value: buffer.window=x Where x is the percentage of the configured time window to add to the buffer. For example, buffer.window=20 means that 20 of the length of the time window is added as a buffer.

4. Click Apply.

14-6 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite 15 Monitoring Oracle Mediator Service Components and Engines 15-1 15 Monitoring Oracle Mediator Service Components and Engines This chapter describes how to monitor Oracle Mediator service components and engines. This chapter includes the following topics: ■ Section 15.1, Monitoring Oracle Mediator Service Component Instances and Faults ■ Section 15.2, Monitoring Oracle Mediator Service Engine Instances and Faults ■ Section 15.3, Monitoring Resequenced Messages For more information, see the following sections: ■ Section 1.2.4, Introduction to Service Components and Service Component Instances ■ Section 1.2.6, Introduction to Service Engines

15.1 Monitoring Oracle Mediator Service Component Instances and Faults

You can monitor Oracle Mediator service component recent instances and faults. Each service component in a SOA composite application has its own instance ID. These IDs are different from the overall instance ID of the SOA composite application of which each service component is a part. To monitor Oracle Mediator service component instances and faults: 1. Access this page through one of the following options:

2. In the Component Metrics section, select the Oracle Mediator service component.

3. Click Dashboard.

From the SOA Infrastructure Menu... From the SOA Folder in the Navigator... 1. Select Home. 2. Select the Deployed Composites tab. 3. In the Composite section, select a specific SOA composite application. 1. Expand soa-infra, and then select a specific SOA composite application.