Oracle Fusion, BPEL and coordination of master- and detail processes

The new Oracle Fusion Middleware 11g just got released a few days back, so time to play with it! Oracle did a great job on the installation guide and quickstart again, so installation wasn’t a real hard job. A short overview of the steps we need to follow Install Oracle Database (i used OracleXE) Create Schemas for Oracle SOA Suite and Oracle BAM by using Repository Creation Utility (RCU) Install Oracle WebLogic Server and Create the Middleware Home Installing Oracle SOA Suite Configuring Oracle SOA Suite Post-Installation Tasks Installing Oracle SOA Suite Design-Time Components On the download page i downloaded the next components Oracle WebLogic Server SOA Suite This part will show us the included components but also the list of required additional software and optional software Repository Creation Utility Quiet some software to install before we can get started. I assume you already have the db running so lets get on to the next step. Create Schemas for Oracle SOA Suite and Oracle BAM by using Repository Creation Utility (RCU) Unzip ofm_rcu_linux_11.1.1.1.0_disk1_1of1.zip and run ./rcu I needed to change the next parameters in the db alter system set PROCESSES=500 scope=SPFILE; alter system set open_cursors=500 scope=SPFILE; And the next parameters in the linux kernel (/etc/security/limits.conf) 1 # tbv oracle soa suite 11g 2 oracle          hard    nofile  4096 3 oracle          soft    nofile  4096 And a list of missing/wrong version of system packages 01 Root 02 Checking operating system certification 03 Expected result: One of enterprise-4,enterprise-5,redhat-4,redhat-5,SuSE-10 04 Actual Result: redhat-5 05 Check complete. The overall result of this check is: Passed 06   07 Checking recommended operating system packages 08 Checking for gcc-4.1.0-28.4; Not found. Failed &lt;&lt;&lt;&lt; 09 Checking for gcc-c++-4.1.0-28.4; Not found. Failed &lt;&lt;&lt;&lt; 10 Checking for setarch-1.6-1; found setarch-2.0-1.1-i386. Passed 11 Checking for sysstat-5.0.5-1; Not found.  Failed &lt;&lt;&lt;&lt; 12 Checking for libstdc++-4.1.0-28.4; found libstdc++-4.1.2-44.el5-i386. Passed 13 Checking for libstdc++-devel-4.1.0-28.4; Not found. Failed &lt;&lt;&lt;&lt; 14 Checking for compat-libstdc++-296-2.96-132.7.2; Not found.  Failed &lt;&lt;&lt;&lt; 15 Checking for compat-db-4.1.25-9; Not found. Failed &lt;&lt;&lt;&lt; 16 Checking for control-center-2.8.0-12; found control-center-1:2.16.0-16.el5-i386.  Passed 17 Checking for glibc-common-2.3.4-2.9; found glibc-common-2.5-34-i386.  Passed 18 Checking for binutils-2.16.91.0.5-23.4; found binutils-2.17.50.0.6-9.el5-i386.  Passed 19 Checking for make-3.80-202.2; found make-1:3.81-3.el5-i386. Passed 20 Check complete. The overall result of this check is: Failed &lt;&lt;&lt;&lt; 21 Checking kernel parameters 22 Checking for VERSION=2.6.18; found VERSION=2.6.18-128.1.16.el5. Passed 23 Checking for hardnofiles=4096; hardnofiles=1024.  Failed &lt;&lt;&lt;&lt; 24 Checking for softnofiles=4096; softnofiles=1024.  Failed &lt;&lt;&lt;&lt; 25 Check complete. The overall result of this check is: Failed &lt;&lt;&lt;&lt; 26 Checking Recommended glibc version 27 Expected result: ATLEAST=2.5-12 28 Actual Result: 2.5-34 29 Check complete. The overall result of this check is: Passed 30   31 Checking physical memory 32 Expected result: 1024MB 33 Actual Result: 1196MB 34 Check complete. The overall result of this check is: Passed Install all the correct packages (yum available/yum install), and ignore the other warnings during install. Setup your own db instance I selected just all the components Install Oracle WebLogic Server and Create the Middleware Home chmod the bin file and run ./oepe11_wls1031_linux32.bin I had some ‘wrong class version exceptions’, so installed java6 update14. Create a new home Installing Oracle SOA Suite Unzip ofm_soa_generic_11.1.1.1.0_disk1_1of1.zip and run ./runInstaller in Disk1 Configuring Oracle SOA Suite Now we need to configure the soa suite installation with the Oracle Fusion Middleware Configuration Wizard. Go to 1 <ORACLE_HOME>/common/bin and run ./config.sh Since i used 1 db for all the components, select al the components and config the same db settings Most of the steps are just next, next and a few more next. Post-Installation Tasks Start both the AdminServer and the ManagedServers. AdminServer 1 <SOASUITE_HOME>/user_projects/domains/domain_name/startWebLogic.sh ManagedServers 1 <SOASUITE_HOME>/user_projects/domains/domain_name/bin/startManagedWebLogic.sh soa_server1 (default name) 2 <SOASUITE_HOME>/user_projects/domains/domain_name/bin/startManagedWebLogic.sh bam_server1 (default name) On startup it will prompt you for the username/password we used on during installation Installing Oracle SOA Suite Design-Time Components For development we will download Oracle JDeveloper 11g R1 (Build 5407). To be able to create soa projects in it we need to update it with the Oracle SOA Suite Extension. Go to Help > Check for Updates. Select ‘Oracle Fusion Middleware Products’ in the ‘Search Update Centers’, next and select ‘Oracle SOA Suite Composite Editor 11.1.1.0′. New consoles (look-and-feel) weblogic server 10.3.1 console enterprise manager Installation is done! Just a few urls to check if everything went ok administration server http://host:admin_server_port (default installation : http://localhost:7001) wls console http://host:admin_server_port/console (default installation : http://localhost:7001/console) enterprise manager http://host:admin_server_port/em (default installation : http://localhost:7001/em)

Oracle Fusion Middleware 11g (ofm11g) on Centos 5

Because of a little illness Lucas was a bit faster with the publish of his article but i decided to still post it on my blog. In the new Fusion 11g, Oracle added a new extension to the bpel language for the coordination of master- and detail processes. With this add on it is possible to relate a master process with his detail processes and give signals to each other when to start and when parts are finished. Let’s start with building something We created a new composite application and added 3 bpel processes to it. The first process is the master process and this one will invoke 2 detail processes. The idea is to let both detail process only get started when they receive a ‘signal’ from the master processes. If they receive it, they’ll execute their own logic and when either finished or at some point they want to communicate back to the master process, they give a ‘signal’ back. In the master process, after the the receive add the first signal 1 <bpelx:signal name="doDetail1" label="doDetail1" to="details"/> This will give the first detail process a signal so it will be able to receive Now we need to invoke the first detail process 1 <invoke name="invokeDetail" 2         inputVariable="invokeDetail_process_InputVariable" 3         partnerLink="MyDetail.mydetail_client" portType="ns1:MyDetail" 4         operation="process" 5         bpelx:detailLabel="detailProcessComplete1" 6         bpelx:invokeAsDetail="true"> Two things in here are needed. The first is the bpelx:invokeAsDetail=”true” and the second is the bpelx:detailLabel=”detailProcessComplete1″ The last property is used in cases in which we have multiple detail processes and the signals need to get correlated back with the master process. Now lets see what is needed in the first detail process to receive the signal and eventually send one back to the master process. The first activity after the receive is the receive signal 1 <bpelx:receiveSignal name="WaitOnSignalFromMaster" 2                      label="doDetail1" from="master"/> This will receive the signal from its master process and after that will carry on. Without the signal the detail process won’t get started. So you will only be able to trigger this detail/sub process from it’s master process. After receiving the signal the detail process can execute some logic and eventually send back the signal to the master process 1 <bpelx:signal name="ReplyBackToMaster" 2               label="detailProcessComplete1" to="master"/> In the master process we use the receiveSignal activity to receive it back from the detail process and go on with the process. 1 <bpelx:receiveSignal name="waitForDetailProcess1" 2                      label="detailProcessComplete1" from="details"/> The same code is needed to invoke the second detail process. It’s up to you to decide wether or not the second detail process can run parallel to the first one. If this is not the case we need to wait on the receiveSignal from the first detail process before we can start the second one. If both processes can execute their logic and eventually send the signal back we can also receive both signals on the end of the master process. If both signals are receive we can do the callback because the whole process (master and all his details have been completed). And in this case we can invoke the detail processes like oneway processes, but still inform the master process about the state of all these oneway (long running?) processes. At the end aggregate all the signals and do the callback or some other activity which is needed as soon all the detail processes reported back. Testcase1 What will happen if we remove one of the receiveSignals from the Master process. the master process will wait on the receivesignal activity until it receveid it. Testcase2 What will happen when we do not send the signal from the master process to the detail process but leave the receiveSignal in the detail process. The master process will wait on the receiveSignal from detail process1. Since the invoke of the both detail processes are oneway and we do the ‘check’ on the receiveSignals at the end, detail process1 will just complete and send the signal back to the master process. After this the master process will keep on waiting on the signal from detail process1. Testcase3, when all just works Eventually the flow of the master process can look like this. In here i placed the receiveSignals to the end of the process. You can also place them after the invokes of the detail processes, so you’re sure they will wait on each other.