Wednesday, December 22, 2010

Remove AQ Adapter and Add/Create JMS Adapter in JDeveloper

This note describes how to replace your AQ Adapter with a JMS Adapter in JDeveloper 11g.

Many customers have been facing issues with Oracle AQ, when used by Oracle SOA Suite 10g and 11g for asynchronous flows. Therefore, this post is intended to show you how to move to JMS instead of AQ.

The steps below will also show you how to remove components and change variables to match with the current partner link JMS Adapter.

1. Open JDeveloper 11g

2. Open project that uses AQ Adapter

3. Select composite.xml and add JMS Adapter to External References under AQ Adapter (Enqueue)

4. Config settings for JMS Adapter
a. Service Name:         ExampleJMS
b. Select OEMS:         Oracle Weblogic JMS
c. Select App Server:  Dev
d.Interface:                 Keep defaulted (specify later)
e. Select:                      Produce Message (equivalent to AQ Adapter Enqueue)
f. Browse and select Destination: ExampleModule (select the appropriate queue)
g. Keep all remaining settings defaulted
h. Browse for schema file
i. Connect JMS Adapter to BPEL Process

5. Select and edit the BPEL process

6. Remove AQ Adapter from the Partner Link (right side)

7. Drag the existing Invoke to the new Partner Link (JMS Adapter)

8. Update new settings to Invoke component
a. Operation
b. Update Variables: Input
c. Select and Edit Invoke
d. Add new Target Variable

9. Edit source and replace invoke portType and point to the newly created (when you make the project)

10. In composite.xml, remove AQ Adapter from the External References

11. Remove variable names associated with previous AQ Adapter in bpel process source code (e.g., ns14:Produce_Message_ptt,when you make the project)

12. Within the area of Exposed Services in the composite.xml, select and add JMS Adapter under the AQ Adapter (Dequeue)

13. Use config settings for JMS Adapter similar to the following:
a. Service Name:        ExampleJMS
b. Select OEMS:        Oracle Weblogic JMS
c. Select App Server:  Dev
d. Interface:                Keep defaulted (specify later)
e. Select: Produce Message (equivalent to AQ Adapter Enqueue)
f. Browse and select Destination: ExampleModule (select the appropriate queue)
g. Keep all remaining settings defaulted
h. Browse for schema file
i. Connect JMS Adapter to BPEL Process

14. Select and edit BPEL Process

15. Remove AQ Adapter from Partner Link (left side)

16. Drag Receive to new Partner Link (JMS Adapter)

17. Select and edit Receive component
a. Add new Target
b. Update Variable: Input

Applicable Versions:
  • Oracle SOA Suite 11g (11.1.1.x)

1 comment:

Alex Bandit said...

Pretty interesting post! Thanks it was interesting. cheap yard signs