Skip Headers
Oracle® Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle Business Process Management Suite
11g Release 1 (11.1.1.6.1)

Part Number E10226-12
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

15 Configuring Oracle Mediator Service Components and Engines

This chapter describes how to configure runtime properties for Oracle Mediator service components and service engines using Oracle Enterprise Manager Fusion Middleware Control. You can also configure advanced and custom properties for Mediator.

This chapter includes the following topics:

15.1 Configuring Oracle Mediator Service Engine Properties

Mediator service engine properties are used by the Mediator service engine during processing of Mediator service components.

To configure Mediator service engine properties:

  1. Access the Mediator Service Engine Properties page using one of the following methods:

    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.


    The Mediator Service Engine Properties page displays a list of Mediator properties, as shown in the following figure.

    Description of med_prop_n.gif follows
    Description of the illustration med_prop_n.gif

  2. Make changes to the service engine properties that are appropriate to your environment.

    The properties are described in Table 15-1 below.

    Table 15-1 Mediator Service Engine Properties

    Property Description

    Audit Level

    The Mediator-specific audit level. 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 Mediator. Composite instance tracking and payload tracking information are not collected.

    • Inherit: The level of audit is the same as the SOA infrastructure. This setting enables the 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

    The 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

    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

    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)

    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)

    The idle time between two successive iterations for retrieving errored messages when there is no errored message from parallel processing. The time is measured in seconds.You can configure the error/retry infrastructure by setting this property.

    Parameters

    Custom configuration properties. For an example, see Section 15.2, "Configuring Resequenced Messages."

    Container ID Refresh Time (sec)

    Container ID Lease Timeout (sec)

    Heartbeat infrastructure properties. The heartbeat infrastructure is a part of the Mediator service engine and detects the absence of a Mediator service engine instance due to failure or shutdown of a node. The heartbeat infrastructure creates a unique identifier for each instance of the Mediator service engine and performs the necessary housekeeping tasks, if a Mediator service engine fails. The heartbeat infrastructure consists of a heartbeat thread. The heartbeat thread periodically updates the time stamp associated with each Mediator service engine's unique identifier. By updating the time stamp associated with it, a Mediator service engine announces its presence to the other 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): The time interval at which the heartbeat thread periodically updates the time stamp associated with each Mediator service engine's unique identifier.

      Notes: The default value is 60 seconds. In case of unplanned outages, you must wait the amount of time specified for this property after restarting the server.

    • Container ID Lease Timeout (sec): 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. A node is considered to be timed out if it has not refreshed itself for a duration longer than the amount of time specified here.

    By configuring these parameters, you can specify the period used by the heartbeat thread to detect the failure of a Mediator service engine.

    Resequencer Locker Thread Sleep (sec)

    The sleep interval for the locker threads in seconds. When the resequencer is unable to find a group with messages that can be processed, the locker thread sleeps for the specified duration. The locker thread does not sleep between each iteration of a database seek, as long as it finds groups with messages that can be processed. The default value is 10.

    Resequencer Maximum Groups Locked

    The number of groups to be retrieved for processing in a single iteration of a database seek. Once retrieved, the groups are assigned to worker threads for processing. The default value is 4.

    Resequencer Worker Threads

    The number of worker threads (dispatchers) for processing resequencing groups in parallel. Each worker thread is assigned a group, and then processes messages for the group in sequence. When there are a large number of groups waiting for messages to be processed, increasing this parameter can improve performance.The default value is 4.


  3. To configure advanced Mediator properties in the System MBean Browser, click More Mediator Configuration Properties.

You can also access Mediator properties in the System MBean Browser through the navigator, as described below.

To access System MBean Browser properties:

  1. From the SOA Infrastructure menu, point to Administration and then select System MBean Browser.

    The System MBean Browser page appears.

  2. In the System MBean Browser navigation pane on the left, expand oracle.as.soainfra.config, expand Server: server_name, expand MediatorConfig, and then select mediator.

    The properties of the MBean appear in the right pane.

  3. To change the value of a property, modify its Value field and then click Apply.

    Note:

    Not all values can be modified. The System MBean properties generally correspond to the properties listed inTable 15-1, with some additional read-only properties for the MBean. An additional property, ContainerInitRetries, is not listed in Table 15-1. This property indicates the number of attempts that are made to create an Oracle Mediator service engine instance ID.

15.2 Configuring Resequenced Messages

For Mediator service components to resequence messages, you must configure the following:

If the 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 Mediator Service Engine Properties page or the System MBean Browser using one of the methods described in Section 15.1, "Configuring Oracle Mediator Service Engine Properties."

  2. Enter a value for the following 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 resequencer locker to sleep when there are no messages in the database.

    Note:

    For more information about these properties, see Table 15-1.

  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.