Introduction to Configuring Oracle BAM Configuring the Logger

22-10 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite 1. In Fusion Middleware Control, go to the usermessagingdriver-email User Messaging Email Driver page by expanding the User Messaging Service folder, then selecting the usermessagingdriver-email bam_server1 node.

2. From the User Messaging Email Driver shortcut menu, select Email Driver

Properties .

3. 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, email account name, and password to access this email account. Configuring Oracle Business Activity Monitoring 22-11 See Section 25.4, Configuring User Messaging Service Drivers for more information. Table 25–7, Custom Email Properties contains specific information about the properties you must configure.

4. Click Apply to save the changes.

5. Enter the email account in the Outbound Email Account property in the Oracle

BAM Server configuration. See Section 22.3.7, Configuring Outbound Email Account for details.

22.6 Configuring Oracle BAM Distribution Lists

Oracle BAM distribution lists are used to send alerts and reports to multiple Oracle BAM users, rather than having to specify several individual recipients. 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.

The Oracle BAM start page is located at: http:host_name:port_numberOracleBAM

2. Select Distribution List management from the list.

3. Click Create.

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

22-12 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite

5. Click Continue to save the distribution list name.

6. Select the new distribution list that is displayed in the Distribution Lists list on

the left side of the page, and click Edit.

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. Configuring Oracle Business Activity Monitoring 22-13

8. Click Save.

The users are added to the distribution list.

22.7 Configuring Oracle BAM Adapter

Oracle BAM Adapter properties, including the adapter batching properties, are configured in Oracle WebLogic Server Administration Console. See Section 22.7.1, Configuring Oracle BAM Adapter Properties for details. Some issues that must be considered when Oracle BAM Adapter including Oracle BAM sensor actions in a BPEL process is used in a SOA composite application are configuring connection factories, trusted domains, 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 22.7.2, Configuring Oracle BAM Connection Factories for details. When using the RMI connection between a SOA composite application and Oracle BAM Server, that is when they are deployed in different domains, trusted domain configuration must be done in Oracle WebLogic Server Administration Console. See Section 22.7.3, Configuring Trusted Domains for more information. 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 22.7.4, Configuring Credential Mapping for more information. The oracle.bam.adapter logger should be configured to troubleshoot issues with Oracle BAM Adapter. See Section 22.4, Configuring the Logger for information about logger configuration. 22-14 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite

22.7.1 Configuring Oracle BAM Adapter Properties

Oracle BAM Adapter properties are configured in Oracle WebLogic Server Administration Console. To configure Oracle BAM Adapter properties:

1. Go to the Oracle WebLogic Server Administration Console

http:host_name:port_numberconsole, and log on.

2. In the Domain Structure menu, select Deployments.

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

4. In the Settings for OracleBamAdapter page, select the Configuration tab, and then

the Properties tab in the second row. 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. Configuring Oracle Business Activity Monitoring 22-15 5. Enter the new values, select the checkboxes for each updated value, and click Save . See Table 22–1, Oracle BAM Adapter Configuration Properties for information about each property. Also, see Section 22.8, Configuring Oracle BAM Batching Properties for general information about configuring batching properties. 6. Restart the SOA domain server. It must be restarted because that is where the Oracle BAM Adapter is deployed. Table 22–1 lists the Oracle BAM Adapter configuration properties. Note: To commit these changes to the deployment plan you must click Activate Changes in the Change Center. If the Activate Changes button does not appear, see the Oracle BAM Troubleshooting Guide on the Oracle Technology Network web site for a workaround: http:www.oracle.comtechnologyproductsintegrationbam collateraldocumentation.html Table 22–1 Oracle BAM Adapter Configuration Properties RMI Property SOAP Property Default Description Batch_Lower_Limit SOAP_Batch_Lower_Limit 1000 The minimum amount of elements in a batch before it is sent out. Batch_Upper_Limit SOAP_Batch_Upper_Limit 5000 The maximum amount of elements in a batch before it is sent out. Batch_Timeout SOAP_Batch_Timeout 5000 The timeout in milliseconds after which the batch is sent out even if it is not full. 22-16 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite

22.7.1.1 Configuring the Adapter to Retry Sending Messages

If messages from BPEL process monitors are published when Oracle BAM Server is unavailable, the messages are not persisted and therefore are not published to the Oracle BAM data objects when Oracle BAM Server comes back online. You can change this behavior by setting the Oracle BAM Adapter property Block_On_Batch_Full to true in Oracle BAM Adapter configuration as described in Section 22.7.1, Configuring Oracle BAM Adapter Properties. For more information about BPEL process monitors see Oracle Fusion Middleware Developers Guide for Oracle SOA Suite.

22.7.2 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_numberconsole, and log on.

2. In the Domain Structure menu, select Deployments.

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

Block_On_Batch_Full SOAP_Block_On_Batch_Full false The default setting for block on batch full, which indicates whether batching operations should block when the batch is full. If true then batching calls block until room is freed up in the batch for the operation. If false then BatchIsFullExcept ion exception is thrown. Number_Batches SOAP_Number_Batches 10 The limit of the number of pending calls allowed. Table 22–1 Cont. Oracle BAM Adapter Configuration Properties RMI Property SOAP Property Default Description Configuring Oracle Business Activity Monitoring 22-17

4. In the Settings for oracle-bam-adapter page, select the Configuration tab, and then

the Outbound Connection Pools tab in the second row.

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. 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 eisbamrmi 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 eisbamsoap connection factory is provided out of the box. 22-18 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite 6. Configure each of the properties by clicking in the table cells and entering the values. This configuration creates the connection factory with HTTP. To configure an HTTPS connection factory, see Section 22.7.2.1, Configuring HTTPS for Oracle BAM Adapter . Note: Press Enter after entering a value in the table. Note: The UserName field should contain an Oracle BAM user who is a member of application-level role Administrator or Report Architect. See Section 24.3.3, Adding Members to Application Roles and Section 24.3.4, Introduction to Oracle BAM Application Roles for information about assigning users to Oracle BAM application roles.