Product Questions
Software download location
BAM Documentation
Operating System
Database System
Installation
IE Browser Settings
IIS Server Settings
BAM server startup
BAM Console
Enterprise Link
Administrator
Architect
Active Studio
Active Viewer
BAM BPEL Integration
BAM Check List
BAM Deployment
BAM WebServices

1. Product Questions

Question: With BAM 10.1.3.3 release I see two versions of the product namely "Oracle Business Activity Monitoring 10g (10.1.3.3.0)" and "Oracle Business Activity Monitoring with Enterprise Link for BAM 10g (10.1.3.3.0)". What is the difference?
Solution: Unlike prior releases, Oracle Business Activity Monitoring 10g (10.1.3.3.0) no longer includes the Enterprise Link feature by default. There are two primary ways of loading base data into Oracle BAM, 1) through Enterprise Link and 2) through Oracle BPEL PM or ESB products. Customers who do not need Enterprise Link functionality can just use "Oracle Business Activity Monitoring 10g (10.1.3.3.0)" with Oracle BPEL PM or ESB products. If you require the Enterprise Link module, then use the "Oracle Business Activity Monitoring with Enterprise Link for BAM 10g (10.1.3.3.0)" version.

Question: Are all BAM dashboards and reports available as webpages ?
Solution: All BAM dashboards and reports can be viewed directly as webpages without ActiveViewer. To get the URL for the report, see ActiveStudio- select report – copy shortcut URL.

Question: How can BAM dashboards and reports be included in a portal?
Solution: All BAM dashboards can be referenced using a URL, these can be embedded in other portals and webpages as iFrames.

Question: Do any of the components provide apis or hooks to enable remote management of the solution? E.g. starting up services, getting operational data etc.. Does it rely on OS functions for that e.g. control panel services manager?
Solution: All of the BAM components are Windows Services, and as such they can be managed from the Windows Services console, started and stopped remotely and so on.

Question: Which platforms are supported by BAM?
Solution: In the current version, BAM software runs on Windows platform. But BAM can interface with other technologies and collect data and events from various heterogenous sources. Future BAM releases starting with 11gR1 will run in a J2EE container and will support all standard platforms supported by Oracle SOA.

Question: Which setup is recommended for BAM internationalization ?
Solution: Set the database character set for EE8MSWIN1250.

2. Software download location

BAM software is available on OTN for free download. This download permits you to download the software and use it in limited fashion. See licensing restrictions on Oracle public page and licensing agreement before download.
To get full support for the product, you should buy the product license and have a valid suppport and maintenance contract. BAM Oracle Public Forum URL - http://forums.oracle.com/forums/forum.jspa?forumID=252
Licensed customers with valid support contract can get help from Oracle support by logging into MetaLink support pages.

3. BAM Documentation

• BAM 10.1.2.1
• BAM 10.1.3.X
• Comments on documentation can be sent through Oracle support and also through the public forum.

4. Operating System
Please refer to product documentation for supported operating system platforms and patches. Oracle Application Server 10g Release 3 (10.1.3.1) certification information is available here. BAM installer allows you to install on non-server platforms such as WinXP, Win2000 Professional, and Windows Vista, please consult release notes and install guide for OS limitations, install options etc. Do not use WinXP, Win2000 Professional, or Windows Vista OS for in depth testing and production of BAM Server.

Question: What happens if my Windows OS user password changes ?
Solution: If Windows OS BAM user password changes, (i.e. the password is changed for user account that runs the BAM services), the BAM software configuration must be updated to use new password. Please contact Oracle support for detailed steps for changing configuration.

5. Database System
Please refer to product documentation for supported operating system platforms and patches.
You can install BAM product schema on the same DB instance with other SOA products, or your applications. You have to be aware of DB traffic, loads and performance etc. See performance section for details.

6. Installation

Pre Install Steps:

Please refer to product documentation for supported operating system platforms and patches. Set the EventViewer properties to overwrite messages. Start > Settings > Control Panel > Administrative Tools > Event Viewer. In Event Viewer select �Overwrite events as needed� in the following - Application Log > Properties  Security Log > Properties System Log >Properties.
During installation, if your system does not have Microsoft DotNet 1.1 – the installer will install the framework and reboot. You have to continue installation again after this initial reboot.
During installation, if your system does not have ODAC (Oracle client for DotNet)- the installer will install the software, and reboot. You have to continue installation after this initial reboot.

You can install BAM on non-server OS such as: Windows XP or Windows 2000 Professional etc. The installer will provide a warning message and continue to install. You can use these OS for simple development or basic testing only because of OS limitations.

You can install BAM, IIS, DB etc. all on one single machine. You have to be aware of the resource consumption such as CPU/memory/etc.

BAM can also be installed on VMWare, but only for small scale demo or testing. BAM is not officially supported on VMWare, and strongly recommended against making VMWare based projects, or scaling or performance even if the VMWare contains official supported server OS configurations.

During Installation:

Question: Is there any restriction on Log files location?
Solution: When installing BAM for logs location don't use C:\Program Files or directories under it, IIS won't write to this location.  

Question: Database connection fails with error ORA-12638: Credential retrieval failed, what to do?
Solution: Comment following line in sqlnet.ora
SQLNET.AUTHENTICATION_SERVICES= (NTS)

Post Install Steps:

Verify that Database and TNS listener are running. Verify from DOS prompt that "tnsping oraclebam", and "sqlplus orabam/orabam@oraclebam ; select count(*) from tab;" works. Select count should show 48+ tables. sqlplus orasagent/orasagent@oraclebam; select count(*) from tab should show 100+ tables.
After installatio, Oracle client for DotNet should be the first entry in your DOS %PATH% environment.

Question: How do I modify configuration files settings?
Solution: You can modify the configuration file settings to give more error information. All C:\OracleBAM\BAM\***.exe.config files are configuration files. You can change "WARN" to "DEBUG" in the parameter line:
< priority value="WARN" / > Do not modify any other parameter(s) in the config file.

Question: I am trying to install BAM and everything has gone well so far but all the links on the BAM start up page are grayed?
Solution: Buttons on start page are grayed out could be result of few things
You aren't logged in to machine as the user who installed. To make sure, go to Control Panel -> Administrative Tools -> Services, locate service "Oracle BAM Active Data Cache" double click on it and in "Log On" tab see the username -- are you logging on with same user to machine?
You need to use only I.E Browser and version 6+.

Question: After installing BAM, I see some plain text on accessing main page.
Solution: If yours is a Windows 2003 machine there are some additional steps, see "Configuration for Windows Server 2003" section in Install Guide.
Check that .NET is installed on the machine. This typically happens if IIS was installed/ re-installed after .NET. One workaround for this issue is to run the following command.
Go to C:\WINDOWS\Microsoft.NET\Framework\v1.1.4322 directory (Note: the version number might be different if you se multiple versions you could go to the folder with the latest version)
Run the command baspnet_regiis.exe

Question: BAM stops working after installing App Server/Database (any Oracle product)
Solution: I have BAM installed successfully and running okay. I then needed to install the J2EE Mid Tier on the same box. Once I had done this then Active Data Cache fails to start, with the error ORA-12154: TNS: Could not resolve the connect identifier....
Installing the Mid-Tier (or any Oracle product), alters PATH environment variable, thus when starting ActiveDataCache it was picking up the wrong version of tnsnames.ora and thus failing.
ADC is dependent on the path setting, modifying the PATH to put the Mid-Tier at the end fixes this problem. Oracle client for DotNet should be the first entry in your DOS %PATH% environment.

Question: You receive "The requested resource is in use." error message when accessing BAM main page
Solution: This is IIS problem the possible cause for this is vbscript.dll reference in registry got messed up and you need to re-register it. Try -
regsvr32 %windir%/system32/vbscript.dll.
regsrv32 %windir%/system32/jscript.dll
Please also refer to Troubleshooting chapter of BAM Installation Guide.

7. IE Browser Settings

IE browser settings for pop up blocker should be disabled.
IE browser settings for default ActiveX components should be enabled (note this is default built-in ActiveX controls and not custom controls). Oracle BAM does not download any custom or proprietary ActiveX controls the IE. Oracle BAM server does not install any "proprietary" components on IE browser.

Question: Does BAM support other Internet browsers?
Solution: No, You need to use only IE Browser and version 6+.

Question: Google Notebook stops ActiveData
Solution: Once I installed Google Notebook (http://www.google.com/notebook/download) add on to IE, ActiveData stopped working for me. Uninstalling fixed the problem.

8. IIS Server Settings

Question: Is Microsoft Internet Information Services (IIS) required, if so where can I get it?
Solution: Yes, IIS is required. Oracle does not provide you this Microsoft software. IIS is an integration piece in Windows OS. Under control panel, add/remove programs...click the add/remove windows. You will be prompted to provide Windows OS CD. During the IIS install you will be prompted 3 or 4 times for above location.

Question: Are there any IIS server specific settings ?
Solution: Yes, IIS settings are given in post install section of install document.

Question: Do I need Microsoft DotNet Framework ?
Solution: Yes, Microsoft DotNet Framework 1.1 is required. The installer will detect this and install this framework if missing. If your system has DotNet Framework 2.0, see post install instructions in install document.

9. BAM server startup

Question: Starting "Oracle BAM Active Data Server" - System error 1069 has occurred.
Solution: Windows - Services- Oracle BAM Active Data Server - LogOn - set the correct user name and password for this service, click on Apply, and try to start. The user name should be a member of Windows Administration Group.

Question: Error event from BAM Plan Monitor is recorded in the event viewer - PlanMonitor: Plan Monitoring processing suspended.
Solution: This could be caused by a Web component of Enterprise Link that isn't installed.It's not required, but we're dependent on a file called sagsa2.dll. This is a known issue and has been addressed in the next release.
For now, copy the file in the attached zip file SaGSA2.zip to your OracleBAM\Enterprise Link directory.
Open DOS, navigate to the above location and run this command to register it:
> regsvr32 sagsa2.dll
You should get a confirmation dialog. Then retry restarting the Plan Monitor

Question: How do I enable Windows 2000 Advanced Server so that Sagent can take advantage of 3 GBs of program address space?
Solution: There are two things that you have to do in order to get the Sagent Data Flow Service to utilize 3 GB of program address space.  First you have to enable the operating system with the /3GB switch and then you have to enable the Data Flow Service by running the command: imagecfg -l sadcagnt.exe
The imagecfg bl sadcagnt.exe command sets the IMAGE_FILE_LARGE_ADDRESS_AWARE bit in the image header for the program.  By only allowing access to the extra GB of address space to programs that have this bit set, Microsoft prevents any problems that might result if suddenly every program running on the system had a 3 GB program address space (and only 1 GB for system address space).
Step 1 -- Enable the operating system to utilize the 3 GB switch.
1) Add the /3GB switch to the ARC path in the Boot.ini file, as follows:
multi(0)disk(0)rdisk(0)partition(2)\WINNT="Windows 2000 Advanced Server" /3GB
The boot.ini file will be at the c:\ root. If you do not find the boot.ini file, perform the following steps:
1)         Right-click on My Computer and select the Advanced tab.
2)         Select Startup and Recovery.
3)         Change bDisplay list of operating systems for xx secondsb to a longer time frame. Remember what it was set to originally as you will eventually set it back.
4)         Open the command window.
5)         Change the directory to c:\.
6)         Type at the c:\ prompt: c:\attrib bs bh br boot.ini.
7)         Hit enter.
8)         Type at the c:\ prompt: c:\boot.ini. This will open up Notepad and will allow you to edit the boot.ini file as explained above.
9)         Save the changes.
10)       Close Notepad.
11)       Change your Startup and Recovery options to their original settings.
12)  Reboot.
Step 2 -- Run the imagecfg -l sadcagnt.exe command.
1)         Stop the Data Flow Service.
2)         Copy sadcagnt.exe to a backup location.
3)         Open the command window.
4)         Type at the c:\prompt: C:\imagecfg bl sadcagnt.exe.
If the imagecfg executable is not installed on the server you can do one of two things:

1) bThe Imagecfg.exe file is available in the Windows 2000 Server Supplement One Resource Kit. If this resource kit is installed on your system, you can find Imagecfg.exe in the C:\Program Files\Resource Kit" default location folder. If the resource kit has not been installed, you can extract Imagecfg.exe from the Debug.cab file on the root of the Windows 2000 Server Supplement One Resource Kit CD-ROMb (Microsoft Knowledge Base Article 297812).
2) Also, you can download the imagecfg.exe from: http://www.robpol86.com/misc_pgs/imagecfg.php. After downloading, you must install it by copying the file to %systemroot%\system32 (or C:\Windows\system32). Then make another copy of it in %systemroot%\system32\dllcache (or C:\WINDOWS\system32\dllcache).
Here is a link to a Knowledge Base Article that explains both steps 1 (enable /3GB) and 2 (imagecfg):
http://support.microsoft.com/default.aspx?scid=kb;en-us;297812&Product=win2000

Question: Is there any restriction on Regional Settings?
Solution: You may see some problems related to Regional Settings, on Windows 2000 laptop: only after setting all the components of the Regional Settings to American_US, I got it working.
In particular, I had to set: Your locale = English (United States) (was: Italian)
Language settings: Western Europe and United States (default) (was: all languages checked)
Time format: h:mm:ss:tt
Time separator: :
AM Symbol: AM
PM Symbol: PM
Input Locale: English (Inited States) (was: English (United Kingdom))

Question:  On Windows 2003 server, even if .NET framework 1.1. is installed, it could happen that ASP.NET is not.
Solution:  In this case BAM installed properly but when connecting to the /OracleBAM URL the user get HTTP 404 error.
To evoid this, I suggest to check the availability of ASP.NET before installing BAM on Windows 2003 server
To do so follow this Microsoft support note  :
IIS 6.0: ASP.NET Is Not Automatically Installed on Windows Server 2003
http://support.microsoft.com/kb/332124/en-us

10. BAM Console

Question: How do I access BAM after install?
Solution: BAM Main URL - http://host:portnumber/OracleBAM

Question: BAM Console buttons are disabled ?
Solution:For initial access, you have to be the user who installed the software on the system. OR use the MakeMeABAMAdmin.sql script given to create yourself as a BAM administrator.(See Utilities section)

Question: Is the BAM GUI completely web based ? What are the certified browsers ?
Solution: Yes, our web applications are completely web and AJAX based. It uses push mechanism so that users are always current with information. Currently only IE v6+ is supported.

11. Enterprise Link

Question: What's the login credentials for BAM and Enterprise Link?
Solution: BAM Main Page - Uses Windows Integrated Authentication. By default the user who installed is granted the Administrator Role.
Enterprise Link Design Studio - user is "BAM" with no password. 
Enterprise Link Admin - When you click connect, login screen shows up with sa filled in for user, there is no password.

Question: Enterprise Link Plan (design time) error message: "Unable to create ELADCCOM COM object."
Solution: Check if ELADCCOM.dll exists in OracleBAM\BAM directory. If not, you may not have selected Standard Components under Enterprise Link during the install. If it exists, try running from DOS: "regasm eladccom.dll /codebase"  A plan cannot be damaged by this error message.  The underlying problem with the dll just needs to be remedied, then all plans should be fine after that (meaning you can continue to edit/run them).

Question: When I try to connect to the Enterprise Design Studio, it fails 9/10 times, but does connect eventually.
Solution: If you have Outlook open - please close it. Then connect to Design Studio.
There's some intermittent problem in connecting which has to do with the Oracle connector used in Outlook.
So if you ever run into this problem, close Outlook. This is a known issue

Question: Enterprise Link Design Studio login fails.
Solution: When starting Design Studio, get the error "VBA Initialization failed"
Try running vba6.msi from the <BAM Download dir>\bam\BAMEnterpriseLink\Vba6\release directory.

Question: Unable to open Enterprise Link Design Studio. It is throwing error "Unable to create SaBins OCX".
Solution: This could be a problem in registering SaBins OCX file.
Open DOS command prompt, navigate to OracleBAM\Enterprise Link directory (where SaBins.Ocx should exist) and run registering command.
> regsvr32 sabins.ocx
You should get a pop up stating it successfully registered. Then try reopening Design Studio.
If still you are not able to open Enterprise Design studio and you are getting following errors: -
-Unable to create control
-Unable to create SeBins OCX
-Unable to create MainFrame Client window (Bins view)
-Failed to create empty document
Than some more files were not registered during the install. Try to manually register all these files.
So open DOS command prompt and run commands given below to register all these files:
for %i in (*.ocx) do regsvr32 %i
for %f in (*.dll) do regsvr32 %f
Even though calling the above commands can result in a LOT of pop up confirmation windows (some don't need to be registered and would error), but you should be able to open Enterprise Link Design Studio.
 

12. Administrator

Question: Plan Monitor Suspended, what do I do now?
Solution: If the Data Flow Service does not start before the Plan Monitor service, you may encounter the following errors in the Event Viewer log: -
----------
PlanMonitor: Unable to connect to Data Flow Service.
[ErrorSource="PlanMonitor", ErrorID="PlanMonitor.PlanLib.DfsConnect"]
Exception
TP -- 0x2, TP -- 0x17
WinError: 10061
No connection could be made because the target machine actively refused it.
[ErrorSource="DataFlowService", ErrorID="PlanMonitor.PlanLib.Msg"]
PlanMonitor: Plan Monitoring processing suspended. Service must be restarted.
ErrorSource="PlanMonitor", ErrorID="PlanMonitor.BackgroundFatal"]
Maximum retry count of 5 reached. No further attempts will be made to connect to the Data Flow Service.
[ErrorSource="PlanMonitor", ErrorID="PlanMonitor.RetryCountDFS"]
----------
To resolve this issue you must stop both the Data Flow Service and the Plan Monitor service, and then restart the Data Flow Service before restarting the Plan Monitor service.

Question: The windows service for BAM Plan Monitor is started, an error event from BAM Plan Monitor is recorded in the event viewer.
----------
PlanMonitor: Plan Monitoring processing suspended. Service must be restarted.
[ErrorSource="PlanMonitor", ErrorID="PlanMonitor.BackgroundFatal"]
COM object with CLSID {7BCBA505-8837-11D5-8503-00104B2D6AB3}
is either not valid or not registered.
[ErrorSource="mscorlib"]
----------
In Oracle BAM Administrator, the status of BAM Plan Monitor is "Suspended".
Is there any workaround for this problem? Is it installation problem?
Solution: Most probable cause is that you have MULTIPLE version of the same plan in locked and saved state.
Your best option - stop plan monitoring service, open designstudio (thick client) open your plan, and make sure in the BOTTOM bar/bin - there are no plans of the same name showing up. You should have only 1 version of the plan saved, and no plans in any locked state showing up in the bottom bin.
Then save & close your designstudio, and start plan monitoring, and set the plan for running.

Question: Can you have multiple sources per plan?
Solution: You can certainly have a plan read from 2 message queues at the same time, but if you join it together there is no mechanism to wait for a message from the other queue, and there is of course no point of having them in the same plan if you donbt join themb&

13. Architect

Question: Deployment across lifecycles for different pieces. Are the artifacts exportable, deployable across different servers (dev, stage, prod)?
Solution: All of the BAM metadata artifacts, including: Plans, EMSs, DataObjects, Reports, Alerts, etc. can be exported and imported using a utility called ICommand, which exports to and imports from XML files.
This utility has both a command line and a WebService interface. It is fully documents in the product documentation.

QuestionHow can data coming from sensors be stored permanently (before and after calculations are done), how can these be transferred to/from a DW?
Solution Using BAM EnterpriseLink. We include a complete ETL tool (OEM'd from Sagent and rebraded) that allows traditional ETL type of work. Additionally, we message enabled it so that same ETL plans can also be run in an event driven fashion.

QuestionCan you explain please the functionality we can use in BAM to pre process data? E.g, Sensors supply different timestamp information as a process goes through different steps. From that information we need to count the time spent in different process steps, would like to maintain an average time spent with each process step, would like to compare with averages measured last month, would like to calculate project averages to the average number of people working on a project step, etc.
Solution BAM provides extensive analytics functionality. All the sensor data can be aggregated in real time as BAM gets it. You can then slice and dice it as you like. Please see BPEL-BAM integration samples or the Loanflow demo.

Question How are external data objects used typically. ?
Solution : External data objects in BAM are data objects that can be directly read into BAM from traditional RDBMS databases. These data objects can be used for lookup, designing star schema etc.

Question: What components need to be installed on the target system to collect data or interface with real time events.?
Solution: Components required on target machine to interface with BAM: No additional software or components or libraries are required to be installed on other machines, or event generating sources for BAM interface. BAM communicated with these external systems using JMS Topics and picks up data .

Question: What is the standard used for interfacing with external events ?
Solution: Format of data/ events: It is recommended to send XML data over JMSTopics for easy interface. In the current version, BAM supports JMA 1.1 complaint systems, and JMS Topics only. BAM supports other data sources too, but XML over JMS is considered best for high speed, real time, low payload, asynchronous, non-intrusive and gauranteed delivery. Communication Protocol: BAM predominantly uses JMS & HTTP as communication channel for incoming data. Data format is XML [no predefined schema]. Outgoing communication is SMTP for email  and WSDL for webservice calls.

14. Active Studio

Question: ActiveStudio does not start.
Solution: Verify that ODAC client library directory is the 1st directory in the OS %PATH% settings. Verify that Database and TNS listener are running. Verify from DOS prompt that "tnsping oraclebam", and "sqlplus orabam/orabam@oraclebam ; select count(*) from tab;" works. Select count should show 48+ tables.

Question: Can rules be based on multiple data objects per rule?
Solution: No. The only way to kind of accomplish this is to use lookups from other DataObjects into the DataObject you base your alert on.

Question: How do I save reports for source code control or other arcbival reasons. ?
Solution : In Active Studio, Edit mode users can save the report with different names, and extensions. (Example: MyReport_V1). When a report is saved, the current state of the report is not saved.  Only the report definition is saved (everything specified in the editor - data objects, fields, properties etc).  No data is saved and the next time the report is opened in edit mode, it might appear different depending on whether the underlying data has changed.
There was no automatic version control in this BAM release. Users can change the report definition and select “Save As” function to save a new version of the report. You can create folders; make copies of reports and save them in different folders. Also user can export reports as xml and save them off somewhere else and import them later. You can use these files for source code control.

Question: How do I customize my own colors and themes for the reports. ?
Solution : Open Architect page of BAM and then going to Data Objects -> DataObjects/System/Views -> Chart Themes There is a list of existing themes, you can add your own theme at this point. Each chart property page also has a color selection, you can set your own custom colors at the individual chart component level.

15. Active Viewer

Question:Can BAM display secure data and lock data with user authorizations. The requirement from a business driver is for their end users to see realtime, BAM-style, reporting of updates securely. The business data uses label security/virtual private database to restrict what their individual users can get access to in the database, and they want this restricted data view to permeate through BAM as well. This would mean, I think, that all BAM components (EL, ADC, report engines, etc.) would have to avoid compromising the restricted view. E.g. if user Matthew Ware can only access rows in the database labelled "MW", then Matthew Ware the BAM end user can see updates representing those rows and no other information.
Solution:The feature is available in BAM Architect, and the data in the dataobject can be protected at row level. It is called 'setting data object permissions', and defining 'security filters'. See BAM Archtiect documentation for full feature steps.

Question: How do I enabling client logging?
Solution: BAM has a facility to log on the client side where you have Active Viewer running, this information is useful for performance analysis and debugging. Follow the steps below:-
Go to Internet Explorer menu item Tools then select Internet Options - Select Security Tab
In the Security level for this zone section click on Custom level Button
A new window open for Settings - Under ActiveX controls and plug-ins section Enable all choices - Close all I.E browser windows
Create following directory tree C:\iter\spurce\webapplications\logs
Now open new I.E. window and navigate to Active Viewer and open the report. You should not see any errors and a log file in above directory should be created.

Question: Are BAM dashboard objects JSR-168 compatible?
Solution: BAM dashboards have a unique URL which can be embedded in any portal using iframe. We are not JSR 168 compatible but this is on the roadmap for next release.

Question: Can the same BAM dashboard page show values from the following different sources at the same time to compare and combine (calculations) ? Solution: Yes. The aggregated and preprocessed data from BPEL sensors (realtime values), and simulatneous data exported from other systems (xls or xml) can be displayed in same dashboard

16. BAM BPEL Integration

Question: JDeveloper Integration Issues and Workarounds
Solution: 1) Must use version 10.1.3.1 of the BPEL JDeveloper plugin. Turn off JDev-auto-update option to avoid having a newer version auto installed by JDeveloper

Question: JDeveloper does not allow sensor action to be defined
Solution:Your BPEL project should have imported into the WSDL. In current release- WSDL containing in-line schema is not supported. See BAM_SOAOrderBooking as as an example. Known issue: BPEL tutorial SOAOrderBooking contains inline schema, hence BAMSensors can only be added after inline schema is changed to imported schema.

Question: What other issues need to be doc'd? Is there a requirement to set a "namespace enabled" JDev option?
Known issues: FYI - Currently tthe "JDeveloper Integration Issues and Workarounds" section contains two issues:
1. Test Connection Hangs on Port 80 When HTTPS Selected"
2. Web Services Interface Only Works with BPEL 10.1.3.1
3. Namespaces were added to the Oracle Business Activity Monitoring target schema. The namespace-enabled BPEL needs to run with the namespace-enabled Oracle Business Activity Monitoring and vice versa. Also JDeveloper must have the correct 10.1.3 BPEL plugin installed.

Question: What are the recommended BAM sensor settings for BPEL 10.1.3.1
Solution:For best performance, it is recommended to turn “on” batching and use default-batch parameters, and use ‘upsert’ operation with an unique key (instead of insert). This recommendataion is for best perforamnce on both the BPEL engine and BAM sensors.

Question: What is the BAM sensor 'dialog' settings for BPEL 10.1.3.1
Solution: BAM sensor dialog box, use BPEL 'OnCompletion'.

Question: What is the BAM sensor 'variable' settings for BPEL 10.1.3.1
Solution: BAM sensor dialog box, use BPEL variable at highest level eg: $outputVariable. Donot drill down the variable to next level nodes such as 'payload' or 'OrderStatus' or 'myValue'.

Question: Not able to reach BAM webservice URL as given in sensorAction.xml
Solution: After designing the BPEL-BAM sensor in BPEL process, JDeveloper tool creates a new sensorAction file called sensorAction.xml. This file contains a property called bamServe with values http://ExampleServer:80/OracleBAM/DataObject/DataObjectOperations.asmx. You cannot open the above URL in a browser. Browser gives HTTP 404 error. This is a known problem and will not affect BAM/BPEL in any way.

17. BAM Check List

If your BAM is not running after installation, please check the following points and send us your comments: -

No.	Check Points	Expected Behavior
1	Check if your database is up and reachable c:\>sqlplus system/welcome@orcl	You should be able to connect to database system user.
2	Check if your IIS is up and running http://localhost	You should be able to see a default asp page http://localhost/localstart.asp
3	Check if all BAM Services are up and running (Start > Settings > Control Panel > Administrative Tools > Services) Oracle BAM Active Data Cache Oracle BAM Data Flow Service Oracle BAM Event Engine Oracle BAM Plan Monitor Oracle BAM Report Cache	All these services should be in bStartedb state
4	If services are not running on the BAM server Login service name (name/passwd), user should have admin rights.	.
5	If service fails to start with 1068 error b set event viewer settings to overwrite messages. [Start > Settings > Control Panel > Administrative Tools > Event Viewer]	In Event Viewer select bOverwrite events as neededb in the following - Application Log > Properties Security Log > Properties System Log >Properties
6	If service fails to start with permission error, set correct permission for services. The password may be wrong	.
7	Check if BAM User names (orabam and orasagent) and the Service (oraclebam) created properly c:\>sqlplus orabam/orabam@oraclebam c:\>sqlplus orasagent/orasagent@oraclebam SQL>tnsping oraclebam	c:\>sqlplus orabam/orabam@oraclebam --> select count(*) from tab; [this should show 100+ items] c:\>sqlplus orasagent/orasagent@oraclebam --> select count(*) from tab; [this should show 48+ items]
8	Check if you get any Error message in Event Viewer's System Log and Application Log (Start > Settings > Control Panel > Administrative Tools > Event Viewer)	Please note down Error Message or Warning Message. This could be the reason of not proper working of your BAM
9	If you have configured your BAM for a particular port number then your BAM URL would be http://<BAM Server>:<http port>/oraclebam	For default port 80, the BAM URL is http://<BAM Server>/oraclebam
10	Please check your Internet Explorer (IE)	BAM runs only on IE 6 SP1 and above. Pop-up blocker should be disabled Active X Control should be enabled
11	%PATH% - should have your ODAC client c:\OraclebBAM\odac as 1st item.	.
12	You should remove .NET component before installing IIS and BAM	.
13	If you are getting the following IIS Error then apply the solution - The requested resource is in use	Solution - In Command Prompt, try - regsvr32 %windir%/system32/vbscript.dll
14	Let us know if ORACLE_SID and ORACLE_HOME shows any value c:\>echo %ORACLE_HOME% c:\>echo %ORACLE_SID%	.
15	For opening Design studio no password is required. If the dll is not registered correctly then you may get some error here.	.

18. Deployment:

Important: Oracle reserves the right to change the deployment recommendations tech note provided here. If you have high demand environment, please consult your local Oracle representative. Distributed  Architecture. BAM components can be installed in a distributed architecture. By default = the installer installs all the components on the same box. Install guide has detailed steps to install specific sub-components on separate machines.
Browser In the current release IE v6 and above is supported.
High Availability: Oracle RAC support in BAM: BAM supports HA configuration. See install guide for detailed steps. BAM repository can be deployed on an Oracle RAC environment. Also contact your Oracle representative for a detailed HA install & config guide
Authentication: User authentication from LDAP: BAM supports LDAP v2 interfaces. See documentation and tech notes for detailed configuration instructions.
Migration: See migration technote. All bam components, artifacts, and data can be easily exported into an XML file, and imported back into a new environment.
Best practices: Please contact your Oracle consulting representative for details in this area. Oracle BAM team has extensive knowledge from various customer deployments and can share the best practises with you.
Performance tuning: Performance tuning and configuration details are given in BAM documentation. See the following document sections.
Performance Guide - Application Server Performance Guide 10g Release 3 (10.1.3.1.0) Doc number: B28942-0 and
BAM Install guide
- 3.2 Performance Configuration Settings
- 3.6 Installing Multiple Plan Monitors
- 3.12.15 Batch Processing
Also consult the generic deployment guide. Please start an early dialog with support and your Oracle representative for your performance needs
Local Support: Oracle has technical help and sales team in many geographies to assist you. If you are in a specific country and need more attention or support or help on Oracle BAM, please contact your local Oracle sales representative or post your geographical details on the BAM forum.

19. WebServices:

Question: Can BAM invoke (call) an external webservice or application ?
Solution: Yes, BAM can call external webservices and applications exposed as URLs, See tech note for examples and steps.

Question: Can BAM alerts invoke (call) a BPEL process ?
Solution: Yes, BAM alert actions can be set to call BPEL process. See demo samples for example, and tech note for detailed steps.

Question: Can an external webservice call (invoke) BAM and send event data ?
Solution: Yes, external webservice can call BAM and populate data in BAM repository. See samples. BAM exposes various webservice as given below.

Question: Can BAM poll an external webservice and request data ?
Solution: No. BAM cannot poll an external webservice or URL to request data. In general such polling operation are poor design scenarios and should be avoided.

Question: Can BAM call an external URL as part of the report operation ?
Solution: Yes, BAM reports can be designed to provide buttons to external URLs. These buttons are called actionable buttons. The URLs can be static or dynamically constructed. See tech notes for detailed design steps.

Question: What are the various webservices exposed by BAM ?
Solution: BAM exposes the following webservices to the outside world (all these services are protected by basic HTTP authentication). The below URLs assume BAM is installed on localhost, port 80. Open the below URL with correct hostname and port number on your browser to see the webservice descriptors (WSDL)

BAM Web Services:
BAM webservice inspection: To verify BAM webservices open: http://localhost/oraclebam/inspection.wsil. And then you can inspect individual data objects as per the WSDL described in this page. Example: http://localhost/oraclebam/StudentLab/inspection.wsil. These individual end point WSIL gives the webservice end point for the individual BAM dataobjects.
BAM data object operations: To describe BAM operations open: http://localhost/OracleBAM/Services/DataObject/DataObjectOperations.asmx?wsdl
BAM data object layout (definitions): To describe data object layout: http://localhost/OracleBAM/Services/DataObject/DataObjectDefinition.asmx?wsdl
BAM alert schema: To describe BAM alert object layout sent out when BAM alert calls a webservice, see demo scenario BAMCallingBPEL. Note the restrictions on namespace in the technote and the example.
BAM example of dataobject layout: End point webservice describing the BAM dataobject - http://localhost/oraclebam/StudentLab/BPELOrderBookingDataObject.wsdl