21 Configuring Oracle Business Activity Monitoring

This chapter introduces Oracle Business Activity Monitoring (Oracle BAM) configuration, and it explains how to configure Oracle BAM Server properties, Web applications properties, and distribution lists.

This chapter includes the following topics:

21.1 Introduction to Configuring Oracle BAM

Oracle BAM Server is the collection of the components Oracle BAM Active Data Cache (Oracle BAM ADC), Oracle BAM Report Cache, Oracle BAM Enterprise Message Sources (EMS), and Oracle BAM Event Engine.

The Oracle BAM Web applications are a collection of thin clients (Active Studio, Architect, Administrator, and Active Viewer) and Oracle BAM Report Server.

For more information about each of the subcomponents of Oracle BAM Server and Oracle BAM Web applications, see Oracle Fusion Middleware User's Guide for Oracle Business Activity Monitoring.

The most commonly used Oracle BAM Server and Web applications properties are configured in Oracle Enterprise Manager Fusion Middleware Control Console. See Section 21.3, "Configuring Oracle BAM Server Basic Properties" and Section 21.2, "Configuring Oracle BAM Web Basic Properties" for more information.

Security configuration is discussed in Section 21.9, "Configuring Security", and adding and managing Oracle BAM roles (permissions) and user accounts is discussed in Section 23.3, "Managing Oracle BAM Users."

Oracle User Messaging Service (UMS) must be configured so that alerts are delivered to Oracle BAM users. See Section 21.5, "Configuring Oracle User Messaging Service" for this information.

When using Oracle BAM in an SOA composite application, the Oracle BAM Adapter configuration must be completed. See Section 21.7, "Configuring Oracle BAM Adapter" for more information.

Advanced properties are located in configuration files that must be edited directly. See Section 21.10, "Configuring Advanced Properties" for more information. Also, see Section 21.11, "Oracle BAM Configuration Property Reference" for a listing of all properties available for Oracle BAM configuration.

Oracle BAM distribution lists are used to send alerts and reports to multiple Oracle BAM users, rather than having to specify several individual recipients. Distribution lists are configured in the Oracle BAM Administrator application. See Section 21.6, "Configuring Oracle BAM Distribution Lists" for more information.

For performance tuning information for Oracle BAM, see Oracle Fusion Middleware Performance Guide.

For Oracle BAM high availability configuration information, see Oracle Fusion Middleware High Availability Guide.

21.2 Configuring Oracle BAM Web Basic Properties

Some basic Oracle BAM Web applications properties are configured using Oracle Enterprise Manager Fusion Middleware Control Console.

Oracle BAM Web applications must be restarted when changes are made to any Oracle BAM properties. See Section 23.2, "Managing Oracle BAM Availability" for information about restarting Oracle BAM.

The following topics describe how to configure each property:

For information about configuring advanced properties, see Section 21.10, "Configuring Advanced Properties" and Section 21.11, "Oracle BAM Configuration Property Reference."

21.2.1 Configuring Oracle BAM Web Applications Properties

The Oracle BAM Web applications properties are configured in the OracleBamWeb Properties page in Fusion Middleware Control Console.

To configure Oracle BAM Web applications properties:

  1. Go to the OracleBamWeb Properties page in Fusion Middleware Control Console by selecting the OracleBamWeb node.

    Open Fusion Middleware Control Console in your Web browser at:

    http;//host_name:port_number/em
    

    In the navigation tree, the Oracle BAM Web node is named OracleBamWeb in the BAM folder.

    Description of bam_em_nav.gif follows
    Description of the illustration bam_em_nav.gif

  2. Select BAM Web Properties in the BAM Web menu.

    Description of bam_config_web_menu.gif follows
    Description of the illustration bam_config_web_menu.gif

    The BAM Web Properties page opens.

    Description of bam_config_web.gif follows
    Description of the illustration bam_config_web.gif

  3. Enter the desired values in each of the fields provided.

    See the following sections for information about configuring each of the properties:

  4. Click Apply.

    You must restart the Oracle BAM application after any property changes.

21.2.2 Configuring Application URL

The Application URL property value must be updated from localhost to the actual host name to generate the correct URLs for reports and alerts.

The Application URL property is configured in both the Oracle BAM Web applications properties page and the Oracle BAM Server properties page. In Oracle BAM Web applications page, the URL is used to generate the full URL for reports and alerts.

Note that this property is common to both Oracle BAM Web applications and Oracle BAM Server. If it is configured on one page, the same value appears on the other configuration page.

21.2.3 Configuring Report Loading Indicator

The Report Loading Indicator property specifies whether the report loading indicator is enabled or disabled by default when viewing reports in Oracle BAM Active Studio and Oracle BAM Active Viewer.

With this property enabled, the report loading indicator is shown by default when a report is viewed; however, individual users can choose to disable the report loading indicator in their user preferences configuration. See Oracle Fusion Middleware User's Guide for Oracle Business Activity Monitoring for more information.

21.2.4 Configuring Server Name

The Server Name property provides the host name of Oracle BAM Server. Oracle BAM Web applications are separate applications that require the location of Oracle BAM Server to get data from the Active Data Cache and Report Cache for the Oracle BAM Report Server.

21.3 Configuring Oracle BAM Server Basic Properties

Some basic Oracle BAM Server properties are configured using Oracle Enterprise Manager Fusion Middleware Control Console.

Oracle BAM Server must be restarted after any changes to Oracle BAM properties. See Section 23.2, "Managing Oracle BAM Availability" for information about restarting Oracle BAM.

The following topics describe how to configure each property:

For information about configuring advanced properties, see Section 21.10, "Configuring Advanced Properties" and Section 21.11, "Oracle BAM Configuration Property Reference."

21.3.1 Configuring Oracle BAM Server Properties

Oracle BAM Server properties are configured in the OracleBamServer Properties page in Oracle Enterprise Manager Fusion Middleware Control Console.

To configure Oracle BAM Server properties:

  1. Go to the Oracle BAM Server home page by selecting the OracleBamServer node in Fusion Middleware Control Console.

    Open Fusion Middleware Control Console in your Web browser at:

    http;//host_name:port_number/em
    

    In the navigation tree, the Oracle BAM Server node is named OracleBamServer, and it is found in the BAM folder.

    Description of bam_em_nav_server.gif follows
    Description of the illustration bam_em_nav_server.gif

  2. Select BAM Server Properties from the BAM Server menu.

    Description of bam_config_server_menu.gif follows
    Description of the illustration bam_config_server_menu.gif

    The BAM Server Properties page opens.

    Description of bam_config_server.gif follows
    Description of the illustration bam_config_server.gif

  3. Enter the desired values in each of the fields provided.

    See the following sections for information about configuring each of the properties:

  4. Click Apply.

    You must restart the Oracle BAM application after any property changes.

21.3.2 Configuring Data Source JNDI

The Data Source JNDI property specifies the database used by Oracle BAM ADC. Enter the data source JNDI name created for Oracle BAM ADC.

21.3.3 Configuring Application URL

The Application URL property is used only by Oracle BAM Web applications. This configuration property is no longer used by Oracle BAM Server. See Section 21.2.2, "Configuring Application URL" for information about configuring this property for Oracle BAM Web applications.

21.3.4 Configuring Viewset Sharing

The Viewset Sharing property enables viewset sharing when possible. A viewset is an object that represents a query to a given Oracle BAM data object. A viewset can include fields (which can be columns from the data object or lookups from other data objects), aggregates, groups, or calculated fields. A viewset can also be sorted, filtered, and row-level security is applied implicitly to it.

Typically, a particular viewset can be shared with other users if they are trying to access the same Oracle BAM dashboard, if the viewsets are not dissimilar due to factors such as row-level security, prompts or parameters used in filters, and so on.

A snapshot is a query result set that can be created by the viewset. Snapshots can be produced from a viewset after it is opened. Because snapshot generation is so performance-intensive, viewset sharing allows Oracle BAM Server to take only one snapshot of a given view to share across multiple users of the same dashboard.

Sharing viewsets between users of the same views improves performance, but requires that new users wait for viewsets to be synchronized as each new user begins sharing the viewset.

The first user who opens an Oracle BAM dashboard receives a new snapshot (which is cached) and immediately receives active data in real time. Changes for active data, called change lists, are cached.

When additional users open the same dashboard, they receive the cached snapshot that was generated for the first user, and they receive cached change lists (more rapidly than the first user) while the "Synchronizing Active Data" message is displayed.

By default, up to 50 change lists are cached, so if multiple users open a dashboard, secondary users must wait for up to 50 change lists to be sent to the dashboard before they begin receiving real-time active data.

The ElementsCountLimit property can be set to allow fewer change lists to be cached. See Section 21.11, "Oracle BAM Configuration Property Reference" for information about configuring advanced properties.

21.3.5 Configuring Report Cache Persistence Manager

The Report Cache Persistence Manager property specifies the persistence location (file based or memory based). Select the appropriate persistence location for your Oracle BAM Report Cache.

21.3.6 Configuring Oracle Data Integrator Integration Properties

The Oracle Data Integrator integration properties specify values for integrating Oracle Data Integrator with Oracle BAM Server.

Enter the appropriate values for the following properties:

ODI User: The user that executes the scenarios in Oracle Data Integrator.

ODI Password: The encoded Oracle Data Integrator password.

ODI Work Repository Name: The name of the Oracle Data Integrator work repository database.

ODI Agent Host: The IP address or host name of the server where the Oracle Data Integrator agent is running.

ODI Agent Port: The Transmission Control Protocol (TCP) port on which the Oracle Data Integrator agent is listening.

21.3.7 Configuring Outbound Email Account

This section explains how to configure the e-mail address that appears in the From header of e-mail notifications sent by the Oracle BAM Event Engine.

The Outbound Email Account property on Oracle BAM Server must point to a dedicated e-mail account for delivering Oracle BAM alert notification e-mail messages and Oracle BAM report link e-mail messages.

If an Oracle BAM alert configured with a secondary action to send an e-mail notification fails on the primary action, this property must be configured with an e-mail address that Oracle UMS can access at run time. Creating a dedicated e-mail account for this purpose is recommended.

Note:

Administrators should not use personal e-mail accounts to test alerts, because Oracle UMS may delete e-mail notifications in the mail box and continue deleting messages as they arrive.

To complete the configuration, you must configure the Oracle UMS usermessagingdriver-email driver. See Section 21.5, "Configuring Oracle User Messaging Service" for details.

Oracle BAM Event Engine has another configuration property, TimeoutPeriodToGetFailedStatusesInMins, which is the time interval for which the Event Engine waits after delivering an e-mail notification, to see if it receives any failure notification from Oracle UMS. The default value for this property is 10 minutes. If a failure notification does not arrive within this time, the Event Engine assumes that e-mail delivery was successful, and the failover action is discarded. Failure notifications arriving after this time are ignored by the Event Engine. See Section 21.11, "Oracle BAM Configuration Property Reference" for information about configuring TimeoutPeriodToGetFailedStatusesInMins.

21.4 Configuring the Logger

Use the Log Configuration page to configure logging levels. For information about viewing the logs, see Section 22.6, "Monitoring Oracle BAM Logs."

To open the Log Configuration page, right click the OracleBamServer node or OracleBamWeb node in the navigation tree and select Logs > Log Configuration as shown in Figure 21-1.

Figure 21-1 Logs Shortcut Menu

Description of Figure 21-1 follows
Description of "Figure 21-1 Logs Shortcut Menu"

For each logger, select the desired notification level as shown in Figure 21-2.

Figure 21-2 Setting Log Levels

Description of Figure 21-2 follows
Description of "Figure 21-2 Setting Log Levels"

21.5 Configuring Oracle User Messaging Service

Oracle User Messaging Service (UMS) must be configured properly in Fusion Middleware Control Console to send e-mail notifications when alerts are issued.

The UMS e-mail driver monitors the outbound e-mail account configured for Oracle BAM Server for any delivery failures, including rejected e-mails. E-mail delivery failure notifications are asynchronous, that is, there is no definite time within which e-mail rejection notification is received.

To configure the service:

  1. Open Fusion Middleware Control Console in your Web browser at:

    http;//host_name:port_number/em
    
  2. Go to the usermessagingdriver-email (User Messaging Email Driver) page in Fusion Middleware Control Console by expanding the User Messaging Service folder, then selecting the usermessagingdriver-email (bam_server1) node.

    Description of bam_ums_nav.gif follows
    Description of the illustration bam_ums_nav.gif

  3. From the User Messaging Email Driver shortcut menu, select Email Driver Properties.

    Description of bam_ums_menu.gif follows
    Description of the illustration bam_ums_menu.gif

  4. In the Driver-Specific Configuration section, the properties IncomingMailServer, IncomingUserIDs, and IncomingUserPasswords must be provided with the Internet Message Access Protocol (IMAP) server name (Oracle UMS also supports POP3), e-mail account name, and password to access this e-mail account.

    Description of bam_ums_driver.gif follows
    Description of the illustration bam_ums_driver.gif

    See Section 24.4, "Configuring User Messaging Service Drivers" for more information. Table 24-4, "Custom E-Mail Properties" contains specific information about the properties you must configure.

  5. Click Apply to save the changes.

  6. Enter the e-mail account in the Outbound Email Account property in the Oracle BAM Server configuration. See Section 21.3.7, "Configuring Outbound Email Account" for details.

21.6 Configuring Oracle BAM Distribution Lists

Oracle BAM distribution lists are configured using the Oracle BAM Administrator application.

To configure distribution lists:

  1. Go to the Oracle BAM start page, log in, and select Administrator.

    Description of bam_start_page.gif follows
    Description of the illustration bam_start_page.gif

    The Oracle BAM start page is located at:

    http://host_name:port_number/OracleBAM/
    
  2. Select Distribution List management from the list.

    Description of bam_admin_menu_distlist.gif follows
    Description of the illustration bam_admin_menu_distlist.gif

  3. Click Create.

  4. Enter a unique Distribution List Name and click Create.

    Description of bam_dist_list.gif follows
    Description of the illustration bam_dist_list.gif

  5. Click Continue to save the distribution list name.

    Description of bam_dist_list_cont.gif follows
    Description of the illustration bam_dist_list_cont.gif

  6. Select the new distribution list that is displayed in the Distribution Lists list on the left side of the page, and click Edit.

    Description of bam_dist_list_edit.gif follows
    Description of the illustration bam_dist_list_edit.gif

  7. Select user accounts to add to the distribution list from the Select Members list.

    You can select multiple users by clicking on several user names. The highlighted user names are added to the distribution list.

    Description of bam_dist_list_add_mem.gif follows
    Description of the illustration bam_dist_list_add_mem.gif

  8. Click Save.

    The users are added to the distribution list.

21.7 Configuring Oracle BAM Adapter

There are two items that must be considered when Oracle BAM Adapter (including Oracle BAM sensor actions in a BPEL process) is used in an SOA composite application: connection factories and credential mapping.

Before deploying applications that use Oracle BAM Adapter, a connection factory to Oracle BAM Server must be configured. You can configure both Remote Method Invocation (RMI) and Simple Object Access Protocol (SOAP) connection factories. See Section 21.7.1, "Configuring Oracle BAM Connection Factories" for details.

If the Oracle BAM Adapter is using credentials rather than a plain text user name and password, in order for Oracle BAM Adapter (including Oracle BAM sensor actions in a BPEL process) to connect to Oracle BAM Server, the credentials must also be established and mapped. See Section 21.7.2, "Configuring Credential Mapping" for more information.

Notes:

Use plain text user names and passwords only in nonproduction mode. Do not mix using credential mapping and plain text user information; apply one at a time to avoid confusion.

Because Oracle BAM and Oracle SOA Infrastructure use different identity stores, an Oracle BAM user must be configured in the service infrastructure identity store if there is not a common service infrastructure user and Oracle BAM user.

Oracle BAM Adapter does not support transactional behavior. Even though there is a section in Oracle WebLogic Server Administration Console for configuring transaction support, Oracle BAM Adapter must remain at the No Transaction level.

21.7.1 Configuring Oracle BAM Connection Factories

Some configuration in the Oracle WebLogic Server Administration Console is necessary before using Oracle BAM Adapter.

Use the Oracle WebLogic Server Administration Console to configure the Oracle BAM connection factories for connections with Oracle BAM Server.

To configure Oracle BAM connection factories:

  1. Go to the Oracle WebLogic Server Administration Console (http://host_name:port_number/console), and log on.

  2. In the Domain Structure menu, select Deployments.

    Description of bam_wls_domstructmenu.gif follows
    Description of the illustration bam_wls_domstructmenu.gif

  3. In the Deployments summary table, search for OracleBamAdapter and click it.

    Description of bam_wls_adapterdeploy.gif follows
    Description of the illustration bam_wls_adapterdeploy.gif

  4. In the Settings for OracleBamAdapter page, select the Configuration tab, and then the Outbound Connection Pools tab in the second row.

    Description of bam_wls_connpooltabs.gif follows
    Description of the illustration bam_wls_connpooltabs.gif

  5. Configure the connection factory interface that you intend to use in Oracle JDeveloper, by expanding the appropriate Group and Instance target and clicking the Java Naming and Directory Interface (JNDI) name.

    Description of bam_wls_connpoolexpand.gif follows
    Description of the illustration bam_wls_connpoolexpand.gif

    To configure the connection factory for RMI-based calls, click to expand the oracle.bam.adapter.adc.RMIConnectionFactory group and select the JNDI name that the user uses in Oracle JDeveloper. The eis/bam/rmi connection factory is provided out of the box.

    To configure the connection factory for SOAP-based calls, click to expand the oracle.bam.adapter.adc.SOAPConnectionFactory group and select the JNDI name that the user uses in Oracle JDeveloper. The eis/bam/soap connection factory is provided out of the box.

    Description of bam_wls_connpool.gif follows
    Description of the illustration bam_wls_connpool.gif

  6. Configure each of the properties by clicking in the table cells and entering the values.

    Description of bam_wls_connpoolprop.gif follows
    Description of the illustration bam_wls_connpoolprop.gif

    Note:

    The UserName field should contain an Oracle BAM user who is a member of application-level role Administrator or Report Architect. See Section 23.3.3, "Adding Members to Application Roles" and Section 23.3.4, "Understanding Oracle BAM Application Roles" for information about assigning users to Oracle BAM application roles.

    This configuration creates the connection factory with HTTP. To configure an HTTPS connection factory, see Section 21.7.1.1, "Configuring HTTPS for Oracle BAM Adapter".

    The RMI protocol has different configuration properties.

    Description of bam_wls_connpoolprop_rmi.gif follows
    Description of the illustration bam_wls_connpoolprop_rmi.gif

  7. Click Save.

21.7.1.1 Configuring HTTPS for Oracle BAM Adapter

To configure HTTPS:

  1. Locate the oracle.bam.adapter.adc.soap.SOAPConnectionFactory connection factory in the Oracle WebLogic Server Administration Console as described in Section 21.7, "Configuring Oracle BAM Adapter".

    Description of bam_wls_connpooltabs.gif follows
    Description of the illustration bam_wls_connpooltabs.gif

  2. Click to expand the oracle.bam.adapter.adc.soap.SOAPConnectionFactory node, select the eis/bam/soap option, and click New.

    Description of bam_wls_connpoolnew_start.gif follows
    Description of the illustration bam_wls_connpoolnew_start.gif

  3. Select the oracle.bam.adapter.adc.soap.SOAPConnectionFactory option and click Next.

    Description of bam_wls_connpoolnew.gif follows
    Description of the illustration bam_wls_connpoolnew.gif

  4. Enter a JNDI name for this connection factory and click Finish.

    Description of bam_wls_connpoolnewjndi.gif follows
    Description of the illustration bam_wls_connpoolnewjndi.gif

  5. Select the eis/bam/https connection pool instance in the Groups and Instances list.

    Description of bam_wls_connpoolnew_https.gif follows
    Description of the illustration bam_wls_connpoolnew_https.gif

  6. Complete the configuration properties as shown in Section 21.7, "Configuring Oracle BAM Adapter," and change the IsHTTPSEnabledWebService value to true.

    Description of bam_wls_connpoolprop_https.gif follows
    Description of the illustration bam_wls_connpoolprop_https.gif

21.7.2 Configuring Credential Mapping

Configure Oracle BAM Adapter to securely store user name and password properties using Oracle WebLogic Server credential mapping functionality.

Note:

Use plain text user names and passwords only in nonproduction mode. Do not mix using credential mapping and plain text user information; apply one at a time to avoid confusion.

To configure credential mapping:

  1. Using the Oracle WebLogic Server Administration Console, go to Deployment > OracleBamAdapter > Security > Credential Mappings.

    Description of bam_wls_credmap_locate.gif follows
    Description of the illustration bam_wls_credmap_locate.gif

  2. Click New and select an outbound connection pool instance for which to create a credential mapping entry, then click Next (By default, Oracle BAM is installed with two connection pools, eis/bam/rmi and eis/bam/soap).

    Description of bam_wls_credmap_select.gif follows
    Description of the illustration bam_wls_credmap_select.gif

    Note:

    Ensure that a separate credential mapping entry for each outbound connection pool is created. If there are any additional outbound connection pools other than the defaults, you must create corresponding credential mappings for them as well.
  3. Select Unauthenticated WLS User, and click Next (Unauthenticated WLS User is similar to an anonymous user).

    Description of bam_wls_credmap_user.gif follows
    Description of the illustration bam_wls_credmap_user.gif

  4. Specify a corresponding user name and password for connecting to Oracle BAM Server, then click Finish to complete the credential mapping.

    Description of bam_wls_credmap_eis.gif follows
    Description of the illustration bam_wls_credmap_eis.gif

  5. Repeat these steps to create the credential mapping for the other Oracle BAM connection pool entries.

    After you configure the credential mappings for each of the outbound connection pool entries, the mappings appear in the Credential Mappings table.

    Description of bam_wls_credmap_list.gif follows
    Description of the illustration bam_wls_credmap_list.gif

  6. For these changes to take effect, Oracle WebLogic Server must be restarted.

21.8 Configuring Oracle BAM Batching Properties

The batch processor batches operations (for example, insert, update, upsert, and delete) between the client and the Active Data Cache server to improve performance by limiting the number of remote calls. For example, 10 update operations could be processed in a single remote call with batching enabled, rather than making 10 remote calls.

Note:

Batching is used only on incoming data, not on internal Oracle BAM processes.

Oracle BAM batching properties are configured in the BAMCommonConfig.xml file at:

BAM_DOMAIN_HOME/servers/BAMManagedServer/tmp/_WL_user/oracle-bam-11.1.1/tmpdir/APP-INF/classes/config/

Oracle BAM must be restarted after any changes to Oracle BAM properties. See Section 23.2, "Managing Oracle BAM Availability" for information about restarting Oracle BAM.

Table 21-1 Active Data Cache API and SOAP (Oracle BAM Adapter) Batching Properties

Oracle BAM ADC API Property SOAP Property Default Description

ActiveDataCache_Datasets_Batching_Limit_PendingCalls

Adapter_SOAP_Batching_Limit_PendingCalls

10

The limit of the number of pending calls allowed.

ActiveDataCache_Datasets_Batching_Limit_Lower

Adapter_SOAP_Batching_Limit_Lower

1000

The minimum number of elements in a batch before it is sent out.

ActiveDataCache_Datasets_Batching_Limit_Upper

Adapter_SOAP_Batching_Limit_Upper

5000

The maximum number of elements in a batch before it is sent out.

ActiveDataCache_Datasets_Batching_Timeout

Adapter_SOAP_Batching_Timeout

5000

The timeout interval in milliseconds after which the batch is sent out even if it is not full.

ActiveDataCache_Datasets_Batching_FlushOnDemand_Limit

Adapter_SOAP_Batching_FlushOnDemand_Limit

1000

The number of rows to take into a batch when flushing on demand.

ActiveDataCache_Datasets_Batching_RetryInterval

Adapter_SOAP_Batching_RetryInterval

30000

The interval in milliseconds at which batch processing should attempt to retry failed flush attempts.

ActiveDataCache_Datasets_Batching_MaxRetryInterval

Adapter_SOAP_Batching_MaxRetryInterval

3600000

The maximum interval in milliseconds at which batch processing should attempt to retry failed flush attempts.

ActiveDataCache_Datasets_Batching_MaximumRetries

Adapter_SOAP_Batching_MaximumRetries

Integer.MAX_VALUE

The maximum number of times batch processing should attempt to retry failed flush attempts. Zero indicates no retry.

ActiveDataCache_Datasets_Batching_SuspendOnDisconnect

Adapter_SOAP_Batching_SuspendOnDisconnect

false

Suspend on disconnect, which indicates whether batching operations should be permanently suspended if and when the connection to Oracle BAM Server is lost.


Batching Retry Mechanism

The batching retry mechanism is designed to retry remote calls to the server in the event communication with the server is lost due to, for example, network problems or Oracle BAM Server going offline. The operation of this retry mechanism is governed by the configuration properties detailed in this section. The term flush refers to the attempt to send the batch calls to the Oracle BAM Server for processing.

The RetryInterval property specifies the interval between retry attempts in milliseconds. If the MaxRetryInterval value is unspecified (0), then the code continues retrying at the RetryInterval value until the batch flush is successful or the MaximumRetries value is exceeded.

If the MaxRetryInterval value is specified, then the retry interval value is doubled on each retry up to the MaxRetryInterval value. It stays at the MaxRetryInterval rate until the batch flush is successful, or the MaximumRetries value is exceeded. This allows the retry rate to decline over time to a more reasonable long-term rate. If the server does not recover quickly, do not continue to retry at a rapid rate.

If the MaximumRetries value is 0, then no retries are attempted and failed batches are discarded.

If the SuspendOnDisconnect value is true, then all batching is permanently suspended until the client application is restarted, regardless of whether communication with Oracle BAM Server is reestablished.

If the pending batch limit is reached and the current batch is full (maximum size reached), then batch calls are blocked. There is no place to queue the operation from the current call, so Oracle BAM blocks the client until the condition resolves itself.

Table 21-1 describes the configuration properties that can be specified for the Active Data Cache API batching (which is used by the RMI connection factory, configured in Section 21.7.1, "Configuring Oracle BAM Connection Factories").

The Oracle BAM Adapter batching mechanism (used by the SOAP connection factory) has an identical set of configuration properties and default values.

21.9 Configuring Security

Security is configured in Oracle WebLogic Server. See Oracle Fusion Middleware Securing Oracle WebLogic Server for information about the topics listed in this section.

General information about Oracle WebLogic Server security is available in Oracle Fusion Middleware Understanding Security for Oracle WebLogic Server.

This section address the following security topics as they relate to Oracle BAM:

21.9.1 Configuring Credential Mapping

Credential mapping is used to securely store user name and password properties when using the Oracle BAM Adapter. For information see Section 21.7.2, "Configuring Credential Mapping."

21.9.2 Configuring Oracle BAM User Permissions

To provide secure access to the Oracle BAM applications, users are assigned to roles that provide the necessary permissions. See Section 23.3, "Managing Oracle BAM Users" for more information.

21.9.3 Configuring Secure Socket Layer

Oracle WebLogic Server provides the facilities needed to enable Secure Socket Layer (SSL) on any Oracle SOA Suite and Oracle WebCenter connections into Oracle WebLogic Server.

Use the Java Development Kit (JDK) keytool utility to create and manage keystores and certificates, and use the Oracle WebLogic Server Administration Console to configure Oracle WebLogic Server listeners.

See "Configuring SSL" in Oracle Fusion Middleware Securing Oracle WebLogic Server for more information.

Although Oracle WebLogic Server lets you configure the Oracle BAM Web applications on both SSL and non-SSL ports, and Oracle BAM can also be configured to run on both SSL and non-SSL ports, it causes issues with the URL configured for Oracle BAM alerts. When Oracle BAM is running on both SSL and non-SSL ports, it cannot send two Oracle BAM report URLs to the alert e-mail receiver. It is the responsibility of the administrator to decide which mode of access (SSL or non-SSL) to use for the Oracle BAM report URL recipients.

To start Oracle BAM in SSL mode, and enable Oracle BAM clients (like ICommand) to invoke Oracle BAM ADC, invoke EJBs, JMS resources, and JDBC resources using SSL, you must configure the following Oracle BAM properties:

Communication_Protocol in the BAMCommonConfig.xml, BAMServerConfig.xml, and BAMICommandConfig.xml files, as follows:

Default value: <Communication_Protocol>t3</Communication_Protocol>

For SSL using t3s: <Communication_Protocol>t3s</Communication_Protocol>

ListenPort in BAMCommonConfig.xml file, as follows:

Default value: <ListenPort>ListenPort</ListenPort>

For SSL: <ListenPort>SSLListenPort</ListenPort>

21.9.4 Configuring Oracle Internet Directory

For general information about configuring Oracle Internet Directory, see "Configuring Users and Groups in the Oracle Internet Directory and Oracle Virtual Directory Authentication Providers" in Oracle Fusion Middleware Securing Oracle WebLogic Server

To use Oracle Internet Directory with Oracle BAM:

  1. Configure Oracle Internet Directory using the Oracle WebLogic Server Administration Console.

  2. Create OracleSystemUser in Oracle Internet Directory, by connecting to Oracle Internet Directory with an Lightweight Directory Access Protocol (LDAP) browser and creating a user in the same base user Distinguished Name that was provided in the Oracle WebLogic Server Administration Console while configuring Oracle Internet Directory.

  3. Run the following SQL statements to null the user global unique identifiers (GUID) in the Oracle BAM schema:

    UPDATE "SysIterUser" SET "SysIterUser"."GUID" = NULL,
    "SysIterUser"."Inactive" = NULL;
    

21.10 Configuring Advanced Properties

Oracle BAM provides many advanced properties not available for configuration using the OracleBamServer and OracleBamWeb properties pages in Fusion Middleware Control Console. These advanced properties are configured using the System MBean Browser or by editing the Oracle BAM configuration files directly.

See Section 21.11, "Oracle BAM Configuration Property Reference" for a listing of all properties available for Oracle BAM configuration.

To configure the advanced properties using the System MBean Browser:

  1. Select System MBean Browser in the OracleBAMWeb or OracleBAMServer menu.

    Description of bam_admin_menu_mbean.gif follows
    Description of the illustration bam_admin_menu_mbean.gif

  2. Select the path to the appropriate Application Defined MBeans page:

    • For properties common to all Oracle BAM components select Application Defined MBeans > oracle.bam.common > Server: bam_server1 > Application: oracle-bam > Config > BAMCommonConfig (see Figure 21-3).

    • For Oracle BAM Server-specific properties select Application Defined MBeans > oracle.bam.server > Server: bam_server1 > Application: oracle-bam > Config > BAMServerConfig.

    • For Oracle BAM Web applications-specific properties select Application Defined MBeans > oracle.bam.web > Server: bam_server1 > Application: oracle-bam > Config > BAMWebConfig.

    Figure 21-3 System MBean Browser Navigation Tree

    Description of Figure 21-3 follows
    Description of "Figure 21-3 System MBean Browser Navigation Tree"

    The associated configuration properties are displayed in the System MBean Browser.

    Description of bam_em_mbean.gif follows
    Description of the illustration bam_em_mbean.gif

  3. Edit property values in the Values column, and click Apply.

  4. Oracle BAM must be restarted after any changes to Oracle BAM properties. See Section 23.2, "Managing Oracle BAM Availability" for information about restarting Oracle BAM.

Editing Oracle BAM Configuration Property Files

All Oracle BAM properties are located in configuration files. These files are located in the following directory on the host where the Oracle BAM components are installed:

BAM_DOMAIN_HOME/servers/BAMManagedServer/tmp/_WL_user/oracle-bam-11.1.1/tmpdir/APP-INF/classes/config

The configuration properties usually go into the BAMCommonConfig.xml file, which contains the properties global to all Oracle BAM components. These properties can also be specified in component specific configuration files:

  • Oracle BAM Server-specific properties are configured in BAMServerConfig.xml

  • Oracle BAM Web applications-specific properties are configured in BAMWebConfig.xml

  • Oracle BAM ICommand utility-specific properties are configured in BAMICommandConfig.xml

The properties set in the BAMCommonConfig.xml file are always loaded. Any additional configuration files must be loaded explicitly. Oracle BAM Server explicitly loads the BAMServerConfig.xml file, the Oracle BAM Web applications explicitly load the BAMWebConfig.xml file, and ICommand explicitly loads the BAMICommandConfig.xml file. When a configuration file is loaded, its properties override any properties previously set, that is properties specified in BAMServerConfig.xml override properties set in BAMCommonConfig.xml.

21.11 Oracle BAM Configuration Property Reference

This section provides a brief description of each Oracle BAM configuration property that may be used.

Advanced properties are configured in the Fusion Middleware Control Console System MBean Browser, or in Oracle BAM-specific XML configuration files. See Section 21.10, "Configuring Advanced Properties" for information about configuring properties that do not appear in the Oracle BAM configuration pages in Fusion Middleware Control Console.

Table 21-2 Oracle BAM Configuration Properties

Property Name Description

ActiveDataCache.API.Batching.ThreadPool.CoreSize

Configured in BAMCommonConfig.xml

Indicates how many threads to keep in the Oracle BAM ADC API ThreadPools when idle.

Default: 5

ActiveDataCache.API.Batching.ThreadPool.KeepAliveTimeInSecs

Configured in BAMCommonConfig.xml

Amount of time (in seconds) to keep an idle thread in the Oracle BAM ADC API ThreadPools.

Default: 20

ActiveDataCache.API.Batching.ThreadPool.MaxSize

Configured in BAMCommonConfig.xml

Maximum number of threads in the Oracle BAM ADC API ThreadPools.

Default: 100

ActiveDataCache.API.Batching.ThreadPool.QueueSize

Configured in BAMCommonConfig.xml

Maximum number of messages that can be queued in the Oracle BAM ADC API ThreadPools.

Default: 30

ActiveDataCache.API.BufferedDataReader.ThreadPool.CoreSize

Configured in BAMCommonConfig.xml

Indicates how many threads to keep in the Oracle BAM ADC BufferedDataReader ThreadPools when idle.

Default: 10

ActiveDataCache.API.BufferedDataReader.ThreadPool.KeepAliveTimeInSecs

Configured in BAMCommonConfig.xml

Amount of time (in seconds) to keep an idle thread in the Oracle BAM ADC BufferedDataReader ThreadPools.

Default: 20

ActiveDataCache.API.BufferedDataReader.ThreadPool.MaxSize

Configured in BAMCommonConfig.xml

Maximum number of threads in the Oracle BAM ADC BufferedDataReader ThreadPools.

Default: 100

ActiveDataCache.API.BufferedDataReader.ThreadPool.QueueSize

Configured in BAMCommonConfig.xml

Maximum number of messages that can be queued in the Oracle BAM ADC BufferedDataReader ThreadPools.

Default: 30

ActiveDataCache.Kernel.ActiveDataQueue.ThreadPool.CoreSize

Configured in BAMServerConfig.xml

Indicates how many threads to keep in the Oracle BAM ADC ActiveDataQueue ThreadPools when idle.

Default: 20

ActiveDataCache.Kernel.ActiveDataQueue.ThreadPool.KeepAliveTimeInSecs

Configured in BAMServerConfig.xml

Amount of time (in seconds) to keep an idle thread in the Oracle BAM ADC ActiveDataQueue ThreadPools.

Default: 20

ActiveDataCache.Kernel.ActiveDataQueue.ThreadPool.MaxSize

Configured in BAMServerConfig.xml

Maximum number of threads in the Oracle BAM ADC ActiveDataQueue ThreadPools.

Default: 100

ActiveDataCache.Kernel.ActiveDataQueue.ThreadPool.QueueSize

Configured in BAMServerConfig.xml

Maximum number of messages that can be queued in the Oracle BAM ADC ActiveDataQueue ThreadPools.

Default: 30

ActiveDataCache_Datasets_Batching_FlushOnDemand_Limit

Configured in BAMWebConfig.xml

Number of rows to include in a batch when flushing on demand. See Section 21.8, "Configuring Oracle BAM Batching Properties" for more information.

Default: 1000

ActiveDataCache_Datasets_Batching_Limit_Lower

Configured in BAMWebConfig.xml

The minimum amount of elements in a batch before it is sent out. See Section 21.8, "Configuring Oracle BAM Batching Properties" for more information.

Default: 1000

ActiveDataCache_Datasets_Batching_Limit_PendingCalls

Configured in BAMWebConfig.xml

The limit of the number of pending calls allowed. See Section 21.8, "Configuring Oracle BAM Batching Properties" for more information.

Default: 10

ActiveDataCache_Datasets_Batching_Limit_Upper

Configured in BAMWebConfig.xml

The maximum amount of elements in a batch before it is sent out. See Section 21.8, "Configuring Oracle BAM Batching Properties" for more information.

Default: 5000

ActiveDataCache_Datasets_Batching_ThreadPoolSize

Configured in BAMWebConfig.xml

The constant size thread pool (that is, containing a fixed number of threads).

Default: 25

ActiveDataCache_Datasets_Batching_Timeout

Configured in BAMWebConfig.xml

The time-out in milliseconds after which the batch is sent out even if it is not full. See Section 21.8, "Configuring Oracle BAM Batching Properties" for more information.

Default: 50

Adapter_SOAP_Batching_FlushOnDemand_Limit

Configured in BAMCommonConfig.xml

Number of rows to include in a batch when flushing on demand. See Section 21.8, "Configuring Oracle BAM Batching Properties" for more information.

Default: 1000

Adapter_SOAP_Batching_Limit_Lower

Configured in BAMCommonConfig.xml

The minimum amount of elements in a batch before it is sent out. See Section 21.8, "Configuring Oracle BAM Batching Properties" for more information.

Default: 1000

Adapter_SOAP_Batching_Limit_Upper

Configured in BAMCommonConfig.xml

The maximum amount of elements in a batch before it is sent out. See Section 21.8, "Configuring Oracle BAM Batching Properties" for more information.

Default: 5000

Adapter_SOAP_Batching_Timeout

Configured in BAMCommonConfig.xml

The timeout interval in milliseconds after which the batch is sent out even if it is not full. See Section 21.8, "Configuring Oracle BAM Batching Properties" for more information.

Default: 50

ADC_PassThrough_Import_BatchSize

Configured in BAMServerConfig.xml

The maximum number of rows that are imported from an external data object.

Default: 50

ADC_PassThrough_Import_MaxRowsToImportAtOnce

Configured in BAMServerConfig.xml

Maximum number. of rows imported by ExternalDataManager at one time.

Default: 100

ADC_PassThrough_Import_MaxSize

Configured in BAMServerConfig.xml

Maximum size imported by ExternalDataManager.

Default: -1

ADCBatchSize

Configured in BAMServerConfig.xml

Refers to JDBC statement batching. When the Oracle BAM ADC executes SQL statements it uses JDBC batching to reduce the number of calls to the database, improving performance. Each call executes a batch of statements rather than a single statement.

Default: 100

ADCChannelName

Configured in BAMServerConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: invm:topic/oracle.bam.messaging.activedatacache.activedata

ADCDataSource

Configured in BAMServerConfig.xml

The data source for the Active Data Cache. See Section 21.3.2, "Configuring Data Source JNDI" for more information.

Default: jdbc/oracle/bam/adc

ADCLogBatchInsertLocks

Configured in BAMServerConfig.xml

Indicates whether to log Oracle BAM ADC batch insert locks.

Default: false

ADCLogFolderLocks

Configured in BAMServerConfig.xml

Indicates whether to log Oracle BAM ADC folder locks.

Default: false

ADCLogSqlStatements

Configured in BAMServerConfig.xml

Indicates whether to log Oracle BAM ADC SQL statements.

Default: false

ADCLogTransactionLocks

Configured in BAMServerConfig.xml

Indicates whether to log Oracle BAM ADC transaction locks.

Default: false

ADCMaxViewsetRowCount

Configured in BAMServerConfig.xml

The default limit for rows of data displayed in a view with this property. Note that the higher you set this value, the more performance is impacted.

Default: 64000

ADCPreloadDataObjectIDs

Configured in BAMServerConfig.xml

Indicates whether data objects should be loaded at Oracle BAM ADC startup rather than on-demand as they are accessed. Pre-loading the data objects increases startup time but decreases initial data object access time. Not pre-loading the data objects decreases startup time but increases initial data object access time. Also, pre-loading all data objects where many data objects are rarely referenced may needlessly increase memory requirements.

ADCPushInterval

Configured in BAMServerConfig.xml

The rate at which Oracle BAM Active Data Cache pushes events to Oracle BAM Report Server. This is one factor that affects the frequency at which active events occur on Oracle BAM dashboard pages. Increasing this interval reduces the load on Oracle BAM Server. However, larger intervals increase the likelihood of multiple updates in the dashboard being collapsed into single updates.

Note that you can override the default ADCPushInterval within particular reports by setting the Active Data Retrieval Interval property in the Report Properties dialog box for a particular Oracle BAM dashboard or report. Open a report in Active Studio, then select Edit > Change Report Properties > Advanced to set the active data retrieval interval. Nonzero values override the ADCPushInterval value for that particular report.

Default: 1000

ADCPushThreadPoolSize

Configured in BAMServerConfig.xml

Indicates the size of the threadpool for Oracle BAM ADC push functionality.

Default: 10

ADCRetryCount

Configured in BAMWebConfig.xml

Number of times to retry the Oracle BAM Active Data Cache connection.

Default: 2

ADCSecurityFiltersEnabled

Configured in BAMServerConfig.xml

Indicates whether Oracle BAM ADC security filters are to be enabled.

Default: true

ADCServerName

Configured in BAMServerConfig.xml

Host name of Oracle BAM Server.

Default: localhost

ADCServerPort

Configured in BAMServerConfig.xml and BAMICommandConfig.xml

Port used by Oracle BAM Server.

Default: 7001

ADCViewsetTimeoutSec

Configured in BAMServerConfig.xml

Specifies the time-out for retrieving a viewset.

Default: 0

ADCWaitTime

Configured in BAMWebConfig.xml

Interval between Active Data Cache connection attempts.

Default: 20

ApplicationURL

Configured in BAMCommonConfig.xml and BAMServerConfig.xml

URL for Oracle BAM Web applications and Oracle BAM Server. See Section 21.3.3, "Configuring Application URL" and Section 21.2.2, "Configuring Application URL" for more information.

Default: http://localhost:7001

Architect_Content_PageSize

Configured in BAMWebConfig.xml

Controls how many rows are shown when viewing data object contents in Oracle BAM Architect.

Default: 100

AutoIncrementBlockSize

Configured in BAMServerConfig.xml

Indicates amount of increment for block size.

Default: 100

CacheDirectory

Configured in BAMServerConfig.xml

Designates the directory used by Report Cache to cache snapshots and active data.

Default: cache

ChangeListDelay

Configured in BAMServerConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: 1

ChannelName

Configured in BAMCommonConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: OracleBAM

CheckViewsFallingBehindInterval

Configured in BAMWebConfig.xml

Indicates the interval to check whether views are falling behind.

Default: 20

CollaborationNILogin

Configured in BAMWebConfig.xml

Whether NI Login is used.

Default: false

ColumnarTimeout

Configured in BAMWebConfig.xml

Indicates the columnar time-out.

Default: 0

Communication_Protocol

Configured in BAMCommonConfig.xml, BAMServerConfig.xml, and BAMICommandConfig.xml

For SSL using t3: <Communication_Protocol>t3s</Communication_Protocol>

See Section 21.9.3, "Configuring Secure Socket Layer."

Default: t3

ConnectionFactoryName

Configured in BAMCommonConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: jms/QueueConnectionFactory

DeletesActiveDataSize

Configured in BAMServerConfig.xml

InsertsActiveDataSize, UpdatesActiveDataSize, UpsertsActiveDataSize, DeletesActiveDataSize determine how many inserts, updates, upserts, and deletes, respectively, should be executed before releasing and then requiring the lock on the data object being modified. This keeps the operation from holding the data object lock for long periods of time when there are Viewsets open on this data object.

Default: 50

DisplayUIStackTrace

Configured in BAMWebConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

This property enables user interface stack traces (by setting this property value to true). This property is used for temporary diagnostic purposes only because exposing a stack with internal details is a potential security threat.

Default: false

DistributionListGroupType

Configured in BAMWebConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: none

ElementsCountLimit

Configured in BAMServerConfig.xml

The number of change lists that are cached before rewriting the cache file.

The default value is 50. When the 51st change list is received, it is cached by replacing the 1st change list.

Default: 50

ElementsSizeLimit

Configured in BAMServerConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: 500

EmailIDForSender

Configured in BAMServerConfig.xml

E-mail address that appears in the From header of notifications sent by the Event Engine. See Section 21.3.7, "Configuring Outbound Email Account" for more information.

Default: BAM-NOTIFICATION_AR@oracle.com

EMSConnectionRecoveryDuration

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

EnableADCDatasetLockTimeout

Configured in BAMServerConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Indicates whether data set lock timeout is enabled.

Default: false

EnableDataTruncationMsg

Configured in BAMWebConfig.xml

Indicates whether to enable the data truncation message.

Default: false

EnableGetAllViewsInOneRoundTrip

Configured in BAMWebConfig.xml

Allows all views to be retrieved in one round trip.

Default: true

EventEngine.Action.ThreadPool.CoreSize

Configured in BAMServerConfig.xml

Indicates how many threads to keep in the Event Engine Action ThreadPools when idle.

Default: 4

EventEngine.Action.ThreadPool.KeepAliveTimeInSec

Configured in BAMServerConfig.xml

Amount of time (in seconds) to keep an idle thread in the Event Engine Action ThreadPools.

Default: 20

EventEngine.Action.ThreadPool.MaxSize

Configured in BAMServerConfig.xml

Maximum number of threads in the Event Engine Action ThreadPools.

Default: 100

EventEngine.Action.ThreadPool.QueueSize

Configured in BAMServerConfig.xml

Maximum number of messages that can be queued in the Event Engine Action ThreadPools.

Default: 4

EventEngine.AlertHistory.ThreadPool.CoreSize

Configured in BAMServerConfig.xml

Indicates how many threads to keep in the Event Engine AlertHistory ThreadPools when idle.

Default: 4

EventEngine.AlertHistory.ThreadPool.KeepAliveTimeInSecs

Configured in BAMServerConfig.xml

Amount of time (in seconds) to keep an idle thread in the Event Engine Action ThreadPools.

Default: 20

EventEngine.AlertHistory.ThreadPool.MaxSize

Configured in BAMServerConfig.xml

Maximum number of threads in the Event Engine AlertHistory ThreadPools.

Default: 100

EventEngine.AlertHistory.ThreadPool.QueueSize

Configured in BAMServerConfig.xml

Maximum number of messages that can be queued in the Event Engine RuleFire ThreadPools.

Default: 10

EventEngineAlertHistoryEventLogging

Configured in BAMServerConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: false

EventEngineAlertHistoryRecordsPerWrite

Configured in BAMServerConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: 10

EventEngine.RuleFire.ThreadPool.CoreSize

Configured in BAMServerConfig.xml

Indicates how many threads to keep in the Event Engine RuleFire ThreadPools when idle.

Default: 4

EventEngine.RuleFire.ThreadPool.KeepAliveTimeInSecs

Configured in BAMServerConfig.xml

Amount of time (in seconds) to keep an idle thread in the Event Engine RuleFire ThreadPools.

Default: 20

EventEngine.RuleFire.ThreadPool.MaxSize

Configured in BAMServerConfig.xml

Maximum number of threads in the Event Engine RuleFire ThreadPools.

Default: 100

EventEngine.RuleFire.ThreadPool.QueueSize

Configured in BAMServerConfig.xml

Maximum number of messages that can be queued in the Event Engine RuleFire ThreadPools.

Default: 4

EventEngineCheckADCIntervalSecs

Configured in BAMServerConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: 5

EventEngineMaxConnections

Configured in BAMServerConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: 25

EventEngineMaxShutdownWaitInterval

Configured in BAMServerConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: 10

EventEngineSaveLastFireIntervalSecs

Configured in BAMServerConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: 10

FileHandleCacheSize

Used by Oracle BAM Report Cache to cache file handles of the files used for caching when file-based persistence is used (see Section 21.3.5, "Configuring Report Cache Persistence Manager" for information about persistence management).

Handle caching increases the speed of reading and writing active data and snapshots. Each viewset has two file handles--one for the snapshot and another for active data.

The value for this property sets the number of file handles that are cached by default.

To disable file handle caching, set this property value to zero (0).

The cost of file handle caching is that all of the cached file handles remain open, and so a) on servers configured for a very small number of concurrent open file handles, and b) on servers heavily loaded with open file handle count reaching the maximum value, this could create a problem. For these scenarios, reduce FileHandleCacheSize to an appropriate smaller value.

Default: 100

GenericSatelliteChannelName

Configured in BAMServerConfig.xml and BAMICommandConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: invmjms:topic/oracle.bam.messaging.systemobjectnotification

GenericSatelliteSystemObjectNames

Configured in BAMServerConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default values:

SystemObjectName=SysIterReport,MonitorColumnName=SysIterLastModified,MessageColumn1=SysIterID,MessageColumn2=SysIterLastModified;

SystemObjectName=SysIterUser,MonitorColumnName=SpecificTimeZoneOffset,MessageColumn1=SysIterID;

SystemObjectName=SysIterUser,MonitorColumnName=AdjustTimeZoneSetting,MessageColumn1=SysIterID;

SystemObjectName=SysIterUser,MonitorColumnName=AdjustDaylightSavingsSetting,MessageColumn1=SysIterID;

SystemObjectName=SysIterDataset,MonitorColumnName=SysIterLastModified,MessageColumn1=SysIterID;

HelpAppLocation

Configured in BAMWebConfig.xml

This property is no longer used in Oracle BAM.

iActiveDataCloseReportsTimeout

Configured in BAMWebConfig.xml

Timeout to close reports.

Default: 500

iActiveDataMaxDiffCounter

Configured in BAMWebConfig.xml

The maximum difference counter for iActiveData.

Default: 10

iActiveDataMinIntervalsToWait

Configured in BAMWebConfig.xml

The minimum interval to wait for iActiveData.

Default: 5

iActiveDataReloadOnSecsBehindThreshold

Configured in BAMWebConfig.xml

The threshold value for reloading iActiveData. The

Default: 10

iActiveDataRestartInterval

Configured in BAMWebConfig.xml

The restart interval for iActiveData.

Default: 3000

iActiveDataRestartTimeout

Configured in BAMWebConfig.xml

The restart timeout value for iActiveData.

Default: 10000

iActiveDataScriptsCleanupFactor

Configured in BAMWebConfig.xml

A property to address a Microsoft Internet Explorer memory leak, when active data is coming into the dashboard at a fast pace, by forcing periodic browser refreshes. This value may be further increased when active data is coming to the dashboard at a rate of 25 events per second or greater. You can monitor the Microsoft Internet Explorer memory consumption to determine an appropriate value.

Default: 1048576

ICommand_Default_User_Name

Configured in BAMICommandConfig.xml

Specifies default security credentials for running ICommand operations. See Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite for more information.

ICommand_Default_Password

Configured in BAMICommandConfig.xml

Specifies default security credentials for running ICommand operations. See Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite for more information.

Import_BatchSize

Configured in BAMServerConfig.xml

Batch size for import by ExternalDataManager.

Default: 50

Import_MaxRowsAtOnce

Configured in BAMServerConfig.xml

Maximum number of rows imported by ExternalDataManager at one time.

Default: 100

Import_MaxSize

Configured in BAMServerConfig.xml

Maximum size imported by ExternalDataManager.

Default: -1

InsertsActiveDataSize

Configured in BAMServerConfig.xml

InsertsActiveDataSize, UpdatesActiveDataSize, UpsertsActiveDataSize, DeletesActiveDataSize determine how many inserts, updates, upserts, and deletes, respectively, should be executed before releasing and then requiring the lock on the data object being modified. This keeps the operation from holding the data object lock for long periods of time when there are Viewsets open on this data object.

Default: 50

ListenPort

Configured in BAMCommonConfig.xml.

For SSL: <ListenPort>SSLListenPort</ListenPort>

See Section 21.9.3, "Configuring Secure Socket Layer."

Default: ListenPort

MaxDBNodeFailoverRetries

Configured in BAMServerConfig.xml

Used in Oracle BAM RAC High Availability configuration. Indicates the number of retries Oracle BAM Server attempts in an event of a RAC failover.

Default: 5

MTTimerThreadPoolSize

Configured in BAMServerConfig.xml

Oracle BAM has a timer implementation that dispatches timer events using a thread pool. This allows timer events to be processed in parallel. This property determines the thread pool size for this timer implementation.

Default: 5

ODIAgentHost

Configured in BAMServerConfig.xml

The IP address or host name of the server where the Oracle Data Integrator agent is running. See Section 21.3.6, "Configuring Oracle Data Integrator Integration Properties" for more information.

Default: localhost

ODIAgentPort

Configured in BAMServerConfig.xml

The TCP port on which the Oracle Data Integrator agent is listening. See Section 21.3.6, "Configuring Oracle Data Integrator Integration Properties" for more information.

Default: 20910

ODIPassword

Configured in BAMServerConfig.xml

The encoded Oracle Data Integrator password. See Section 21.3.6, "Configuring Oracle Data Integrator Integration Properties" for more information.

Default: SUNOPSIS

ODIUser

Configured in BAMServerConfig.xml

The user that executes the scenarios in Oracle Data Integrator. See Section 21.3.6, "Configuring Oracle Data Integrator Integration Properties" for more information.

Default: SUPERVISOR

ODIWorkRepositoryName

Configured in BAMServerConfig.xml

The name of the Oracle Data Integrator work repository database. See Section 21.3.6, "Configuring Oracle Data Integrator Integration Properties" for more information.

Default: WORK_DEV

oracle.bam.common.messaging.util.

MessageConsumerRegistryQueuedPusher_CorePoolSize

Configured in BAMCommonConfig.xml

Indicates how many threads to keep in Message Registry ThreadPool when idle.

Default: 20

oracle.bam.common.messaging.util.

MessageConsumerRegistryQueuedPusher_KeepAliveTime

Configured in BAMCommonConfig.xml

Amount of time (in seconds) to keep an idle thread in the Message Registry ThreadPool.

Default: 60

oracle.bam.common.messaging.util.

MessageConsumerRegistryQueuedPusher_MaximumPoolSize

Configured in BAMCommonConfig.xml

Maximum number of threads in the Message Registry ThreadPool.

Default: 100

oracle.bam.common.messaging.util.

MessageConsumerRegistryQueuedPusher_MaximumQueueSize

Configured in BAMCommonConfig.xml

Maximum number of messages that can be queued in the Message Registry ThreadPool.

Default: 30

RecordsLimitForEmail

Configured in BAMWebConfig.xml

The number of rows allowed in a List view or Columnar report used in an e-mail attachment before a limit error is displayed. Attachments containing reports can become large because they include data compared to a report link that accesses the report and data on Oracle BAM Server.

Default: 1000

RecordsLimitForSaveOffline

Configured in BAMWebConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: 0

RecordsLimitForValueBrowser

Configured in BAMWebConfig.xml

Number of values that are presented in values browser for constructing filter expressions.

Default: 50

ReportCache.ViewSets.ThreadPool.CoreSize

Configured in BAMServerConfig.xml

Number of threads to keep in Report Cache ThreadPool when idle.

Default: 5

ReportCache.ViewSets.ThreadPool.KeepAliveTimeInSecs

Configured in BAMServerConfig.xml

Amount of time (in seconds) to keep an idle thread in the Report Cache ThreadPool.

Default: 20

ReportCache.ViewSets.ThreadPool.MaxSize

Configured in BAMServerConfig.xml

Maximum number of threads in the Report Cache ThreadPool.

Default: 100

ReportCache.ViewSets.ThreadPool.QueueSize

Configured in BAMServerConfig.xml

Maximum no. of messages that can be queued in the Report Cache ThreadPool.

Default: 30

ReportCacheChannelName

Configured in BAMServerConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: invmjms:topic/oracle.bam.messaging.reportcache.activedata

ReportCacheMaxConnections

Configured in BAMWebConfig.xml

The maximum number of connections allowed by Report Cache to its clients.

Default: 25

ReportCacheMaxShutdownWaitInterval

Configured in BAMWebConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: 10

ReportCachePersistenceManager

Configured in BAMServerConfig.xml

See Section 21.3.5, "Configuring Report Cache Persistence Manager" for more information.

Default: FileBasedPersistenceManager

ReportLoadingSetting

Configured in BAMWebConfig.xml

The report loading indicator to be enabled. See Section 21.2.3, "Configuring Report Loading Indicator" for more information.

Default: on

SensorFactory

Configured in BAMICommandConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: oracle.bam.common.statistics.noop.SensorFactoryImpl

ServerName

Configured in BAMWebConfig.xml

The Oracle BAM Server host name. See Section 21.2.4, "Configuring Server Name" for more information.

Default: localhost

UpdatesActiveDataSize

Configured in BAMServerConfig.xml

InsertsActiveDataSize, UpdatesActiveDataSize, UpsertsActiveDataSize, DeletesActiveDataSize determine how many inserts, updates, upserts, and deletes, respectively, should be executed before releasing and then requiring the lock on the data object being modified. This keeps the operation from holding the data object lock for long periods of time when there are Viewsets open on this data object.

Default: 50

UpsertsActiveDataSize

Configured in BAMServerConfig.xml

InsertsActiveDataSize, UpdatesActiveDataSize, UpsertsActiveDataSize, DeletesActiveDataSize determine how many inserts, updates, upserts, and deletes, respectively, should be executed before releasing and then requiring the lock on the data object being modified. This keeps the operation from holding the data object lock for long periods of time when there are Viewsets open on this data object.

Default: 50

UseDBFailover

Configured in BAMServerConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: true

ViewSetExpiryTimeout

Configured in BAMWebConfig.xml

This property is for Oracle BAM internal use only. Do not change it unless instructed to do so by Oracle Support Services.

Default: 120

ViewSetSharing

Configured in BAMServerConfig.xml

See Section 21.3.4, "Configuring Viewset Sharing" for more information.

Default: true