Thursday, January 14, 2010

Oracle SOA Suite Documentation

Oracle SOA Suite 10g
http://www.oracle.com/technology/products/soa/soasuite/collateral/documentation.html#10.1.3.1.0


Oracle Fusion Middleware 11g Release 1 (11.1.1) Documentation

http://www.oracle.com/technology/documentation/middleware.html

Installing JDeveloper 11g & SOA JDeveloper Extension

Download the  Oracle JDeveloper 11g (11.1.1.2.0) (Build 5536) and run the executable file.

Installing JDeveloper 11g R1

Complete the installation wizard as follows

  1. Select Create a new Middleware Home and enter C:\Oracle\Middleware\jdev11gR1.If you enter something else, then adjust accordingly when C:\Oracle\Middleware\jdev_11gR1 is referenced.
    clip_image002
  2. Click on Next.
  3. Choose Install Type as Complete, and then click on Next.
  4. JDK Selection: you will see your JAVA_HOME.
    clip_image002[5]
  5. Click on Next.
  6. Confirm Product Installation Directories.
    clip_image002[7]
  7. Click on Next.
  8. Choose Shortcut location: "All Users", and then click on Next.
  9. Review Installation Summary.
    clip_image002[9]
  10. Click on Next and the installation starts.
  11. Wait for the installation to complete a few minutes.
  12. When installation completes, deselect Run Quickstart and click on Done.

Updating JDeveloper for SOA Jdeveloper Extension

SOA design time in JDeveloper requires a JDeveloper extension called Oracle SOA Composite Editor (11.1.1.2.0). While this is normally updated over the network when using release-level software, you can also perform the update manually if you have the extension file.

We will update it manually using the locally downloaded Oracle SOA Composite Editor (11.1.1.2.0)

JDeveloper periodically prompts you to accept an automatic network update. Since this is released software, you have the option to click on OK to update to a newer version. The SOA extension is about 230 MB and may take some time.

Please follow these steps

  1. Start JDeveloper Studio 11.1.1.1.0 from the Windows Programs menu: Oracle Fusion Middleware 11.1.1.1.0 or run C:\Oracle\Middleware\ jdev_11gR1\jdeveloper\jdeveloper.exe.
  2. Select Default Role, deselect Show this dialog every time, and click on OK.
  3. Click on No to "Migrate from previous release".
  4. If you are prompted to select file extensions to associate with JDeveloper, deselect everything or select the ones you would like for your machine and continue.

Now you can update the SOA Composite Editor extension. These instructions show you how to update the extension over the network.

  1. Select Help | Check For Updates; click on Next.
  2. Select Search Update Centers and select Oracle Fusion Middleware Products.
  3. Click on Next. The system will search the update center for extensions.
    clip_image002[11]
  4. From the list of extensions, select Oracle SOA Composite Editor and click on Next to begin downloading. The extension is about 230 MB and takes a few minutes to download.
    clip_image002[13]
  5. When the extension has finished downloading, it is listed with the version number detail.
    clip_image002[15]
  6. Click on Finish.

The above sequence assumes that the installation of the extension is done via a PC Connected to Internet.

The SOA JDeveloper Extension can also be installed locally at Step (3)

Tutorial for Building an Application with Oracle SOA Suite

The WebLogic Fusion Order Demo application of the Fusion Order Demo was created to demonstrate using Oracle SOA Suite for processing orders from a Web shopping store front. This tutorial focuses on rebuilding the WebLogic Fusion Order Demo application, the SOA sample application of Fusion Order Demo.

Run by a fictitious company called Global Company, the Fusion Order Demo provides two main parts, the Store Front module and the WebLogic Fusion Order Demo application.

The StoreFront modules sells electronic devices through a storefront-type Web application. The StoreFrontUI project uses JavaServer Faces (JSF) as the view technology, and relies on the Oracle ADF Model layer to interact with Oracle Application Development Framework (Oracle ADF) Business Components in the StoreFrontService project.

Once a customer places an order, the WebLogic Fusion Order Demo application processes the order.

This tutorial covers the creation of the WebLogic Fusion Order Demo application. Prior to reading this tutorial, use the Oracle Fusion Middleware Tutorial for Running a Sample Application with Oracle SOA Suite to understand the runtime environment. It explains how you place an order through the StoreFront module, and describes how to monitor the order as it is processed by the WebLogic Fusion Order Demo application through Oracle Enterprise Manager Fusion Middleware Control.

Link to PDF file of this tutorial

Go to the Introductions to the SOA Sample Application tutorial Introduction to the SOA Sample Application (HTML)
This chapter introduces the Fusion Order Demo and the WebLogic Fusion Order Demo application. It provides the tasks for preparing to build the Fusion Order Demo, including installation and configuration.

Go to the Setting Up to Use the FusionOrderBooking Application tutorial Creating the SOA Application (HTML)
This set of exercises describes how to create the WebLogic Fusion Order Demo application in Oracle JDeveloper and how to create the PartnerSupplierComposite composite during the creation of the application.

Go to the Understanding the JDeveloper SOA Composite Editor tutorial Creating the OrderBookingComposite Composite (HTML)
This set of exercises describes how to create the OrderBookingComposite composite of the WebLogic Fusion Order Demo application.

Go to the Using the BPEL Designer tutorial Creating the First Half of the OrderProcessor BPEL Process (HTML)
This set of exercises describes how to create the first half of the OrderProcessor BPEL process for the OrderBookingComposite composite.

Go to the Using the BPEL Designer tutorial Creating the Second Half of the OrderProcessor BPEL Process (HTML)
This set of exercises describes how to create the second half of the OrderProcessor BPEL process for the OrderBookingComposite composite.

Go to the Using the Mediator Designer tutorial Adding the OrderPendingEvent Mediator Service (HTML)
This set of exercises describes how to subscribe to a business event using Oracle Mediator. It describes how to create a business event for when an order is created by the StoreFrontService service. It also describes how to create a mediator service component to subscribe to this business event and invoke the OrderProcessor BPEL process through a routing rule to process a new order.

Go to the Using the Mediator Designer tutorial Adding a Flow to Update Order to the OrderBookingComposite (HTML)
This set of exercises how to use Oracle Mediator to publish and subscribe to a business event for updated orders.

Go to the Modifying a Business Rule tutorial Creating the Task Display Form for the ApprovalHumanTask Human Task (HTML)
This set of exercises describes how to create a task form for the ApprovalHumanTask human task in the OrderProcessor BPEL process for orders requiring approval. The task form displays the contents of the task to approver jstein.

Oracle SOA Suite 11g & 10g Samples

With the new SOA 11g release a lot of new features are introduced. In the previous releases, we had our sample directory for each product. With this new release, the samples are not in the distribution. Here is a list of links were you can find the example for 11g as well for 10g:

ComponentGeneral OTN location
BPEL PMhttp://www.oracle.com/technology/sample_code/products/bpel
Adaptershttp://www.oracle.com/technology/sample_code/products/adapters
Human Workflowhttp://www.oracle.com/technology/sample_code/products/hwf
Mediatorhttp://www.oracle.com/technology/sample_code/products/mediator
Oracle Service Bushttp://www.oracle.com/technology/sample_code/products/osb
B2Bhttp://www.oracle.com/technology/sample_code/products/b2b
BAMhttp://www.oracle.com/technology/sample_code/products/bam
BPMhttp://www.oracle.com/technology/sample_code/products/bpm
BPMN http://www.oracle.com/technology/sample_code/products/bpmn
EDAhttp://www.oracle.com/technology/sample_code/products/event-driven-architecture
Repositoryhttp://www.oracle.com/technology/sample_code/products/regrep
Registryhttp://www.oracle.com/technology/tech/soa/uddi/index.html
Ruleshttp://www.oracle.com/technology/sample_code/products/rules
SOA (general)http://www.oracle.com/technology/sample_code/products/soa

Oracle SOA Suite 11g Roadmap

First the release calendar, Patch Set1 and Soa Suite 10.1.3.5 for OC4J and WLS are already out, So we can expect the coming 4, 5 months BPM 11g , OSB 11g and off course at last Patch Set 2

The new features of PS1, like Soa composer, Spring preview support, invocation api

PS2 will probably bring us composite folders ( domains ) , BPEL 2.0, Spring support in production, Direct binding between OSB and Soa Suite

And maybe Soa Suite 11G release 2 will have a light soa console, Rest / JSON & Debugger support

For more info see the original document on OTN.

Download and See David Shaffer Soa Suite roadmap yourself

Oracle SOA Suite 11g: Install Everything in One AdminServer

1. Prerequisites
See details http://www.oracle.com/technology/software/products/ias/files/fusion_requirements.htm.

a. Database

You need XE Universal database version 10.2.0.1 or 10g database version 10.2.0.4+ or 11g database version 11.1.0.7+. You cannot use any other database version.
If you are using XE, you must update database parameters if you have never done this for your database installation. You only have to do this once after installing. Make sure processes parameter is >=200.
Sometimes the shutdown/startup command at the end here fails. In that case, simply restart the XE service in the Control Panel/Administrative Tools dialog after setting your parameters.

sqlplus sys/welcome1@XE as sysdba
SQL> show parameter session
SQL> show parameter processes
SQL> alter system reset sessions scope=spfile sid='*';
SQL> alter system set processes=200 scope=spfile;
SQL> shutdown immediate
SQL> startup
SQL> show parameter session
SQL> show parameter processes

b. Browser

You must use Firefox 3 or IE 7 for EM. You must use IE 7 for BAM or for FireFox with the IETab add-on (https://addons.mozilla.org/en-US/firefox/addon/1419).

c. Oracle WebLogic Server

Install Oracle WebLogic Server 11g(10.1.3.1) under D:\oracle\wls_090602 or any other new directory as $ORACLE_HOME.

d. Repository Creation Utility

Create with the Repository Creation Utility (RCU) the SOA infrastructure schemas: Metadata Services, SOA Infrastructure, Business Activity Monitoring (if needed) and User Messaging Service.

e. Oracle SOA Suite

Install Oracle SOA Suite 11g under D:\oracle\wls_090602\Oracle_SOA1 or under your WebLogic Server directory $ORACLE_HOME.

2. Create a Domain

In a command window go to $ORACLE_HOME\Oracle_SOA1\command\bin. $ORACLE_HOME is the path where WebLogic is installed. Oracle_SOA1 is the path where Oracle SOA Suite 11g is installed.
Enter config.cmd or on Unix config.sh.
cd D:\oracle\wls_090602\Oracle_SOA1\common\binconfig.cmd

a. Welcome

When the install wizard Welcome screen comes up, select Create a new WebLogic domain.
step00
Click Next.

b. Select Domain Source

Select Generate a domain and select Oracle SOA Suite, Oracle Enterprise Manager and Oracle BAM. Dependent products are selected automatically.
step01a
Click Next.

c. Specify Domain Name

Enter the domain name: e.g. soadev
step02a
Click Next.

d. Configure Administrator User Name and Password

Enter user name weblogic and password welcome1, confirm password. If you choose instead to use a secure password for the admin, adjust accordingly later in the document when the password is referenced.
step03a
Click Next.

e. Configure Server Start Mode and JDK

Select the Sun SDK 1.6_11 and leave Development Mode checked. You can select JRockit to avoid PermGen OutOfMemoryerror.
step04a
Click Next.

f. Configure JDBC Component Schema

With all of the components selected, enter the password (e.g. welcome1 ) for the password in the Schema Password field. Enter the Service, Host and Port for the database.
step05a
Review the Schema Owner field and confirm that they are the same as what you configured in the Configure Schema section when you ran the Repository Creation Utility (RCU). You can review the screen shots in that section of this document for the schema owners.
Complete the following if the schema owners need to be updated:
1. Deselect all the component checkboxes and select BAM Schema.
2. Enter the Schema Owner, SH_ORABAM
3. Next, deselect BAM Schema and select the next one.
4. Enter the schema owners one-by-one by pre-pending SH_ to the defaulted value. SH is the prefix specified in the RCU.
5. Continue until all schema owners are entered (see screen shot).
Click Next.

g. Test Component Schema

The data source connections are all tested.
step06
If all are successful, click Next, otherwise click Previous and correct any errors.

h. Select Optional Configuration

Select Administration Server, Managed Servers, Cluster and Machines and Deployments and Services.
step07a
Click Next.

i. Configure managed Servers

Select bam_server1 and click Delete, select soa_server1 and click Delete.
step09
Click Next.

j. Configure Cluster

step10
Click Next.

k. Configure Machine

step11
Click Next.

l. Assign Servers to Machines

Move AdminServer to the right.
step12a
Click Next.

m. Target Deployments to Cluster or servers

If not already done. Select AdminServer on the left and click Select All on the right.
step12a
Click Next.

n. Target Services to Cluster or Servers

If not already done, select AdminServer on the left and click Select All on the right.
step13
Click Next.

o. Configuration Summary

step15
Click Create.

p. Creating Domain

Wait for the create to finish – takes just a minute.
step16
Click Done.
Congratulation!

3. Start
Start the Admin Server: Go to Domain Location reported on the Creating Domain screen.
D:\oracle\wls_090602\user_projects\domains\soadev\bin
startWebLogic.cmd
Wait for the Admin Server to finish starting up. It takes a few minutes – watch for status Server started in RUNNING mode and SOA Platform is running and accepting requests in log console window
step99

4. Server URLS
Weblogic console http://localhost:7001/console (login with weblogic/welcome1)
EM console http://localhost:7001/em (login with weblogic/welcome1)
SOA worklist application http://localhost:7001/integration/worklistapp
The link for B2B http://localhost:7001/b2b
The link for BAM (must use IE browser) http://localhost:7001/OracleBAM

Installing Oracle SOA Suite 11g R1

Introduction:

In this post we will see detailed steps to install SOA 11g. The approach used in all 11g FMW components (Including SOA) is very different then 10g. The basic limitation of any 10g component involving infrastructure was that the product itself used to create database and configure the entire infrastructure. This used to put limitation on database port which always used to be 1521.

Here in 11g version, a user has a flexibility to use any port. 11g expects installed database as a pre-reqs and uses that database to create corresponding repository. This way we can have database and listener at any port and provide that information while creating repository.

Also another important feature with all 11g components is that web server used is weblogic and it is kept as another separate component in the form of pre-reqs. So any 11g components requiring web server expects weblogic as pre-reqs. With this brief introduction about 11g FMW components characteristics we will see the installation procedure for SOA 11g.

Installing SOA 11g:

Following are the brief steps for installing SOA 11g

  1. Install database 11g (11.1.0.6 / 11.1.0.7) including configuring TNS and listener. You could also use Oracle XE Universal Edition.
  2. Create repository using Oracle RCU (Repository Creation Utility).
  3. Install WLS (weblogic Server) and create a Middleware Home.
  4. Install SOA 11g inside middleware home.
  5. Use config.sh (Unix) / config.cmd (Windows) or WLST to create and configure SOA domain and managed servers.
  6. In case of SOA 11g, BAM also gets install and configured if selected. Here we will install both SOA and BAM.

Download Locations:

Download all the software to get started.

1. In the following steps, save all downloaded files to c:\stageSOA. This document assumes that path. If you save them somewhere else then make sure there are no spaces in your path and adjust accordingly when c:\stageSOA is referenced in this document.

2. Unzip the Oracle SOA Suite (11.1.1.2.0) ZIP file to c:\stageSOA.

3. Unzip the Repository Creation Utility (11.1.1.2.0) ZIP file to c:\stageSOA.

Step 1) Install database 11g  including configuring TNS and listener or XE Universal Edition

Having your database up and running is the most important pre-requisite for installing SOA Suite.

  • Read the following requirements carefully to be sure you are ready to begin the SOA Suite installation:
    • You need one of:
      • Oracle XE Universal database version 10.2.0.1
      • Oracle 10g database version 10.2.0.4+
      • Oracle 11g database version 11.1.0.7+
    • You cannot use any other database version in 11gR1 (certification of additional databases is on the roadmap). Specifically, you cannot use XE Standard, it must be Universal.
    • We have seen problems with installing XE when a full 10g database is already installed in the environment.
    • The Windows registry sometimes gets the database file location confused. It is recommended to pick one or the other to avoid such issues.
    • If you need to uninstall XE, make sure that you follow the instructions in Oracle Database Express Edition Installation Guide 10g Release 2 (10.2) for Microsoft Windows Part Number B25143-03, Section 7, Deinstalling Oracle Database XE (http://download.oracle.com/docs/cd/B25329_01/doc/ install.102/b25143/toc.htm).
    • If you need to uninstall 10.2, be sure to follow the instructions in Oracle atabase Installation Guide 10g Release 2 (10.2) for Microsoft Windows (32-Bit) Part Number B14316-04, Section 6, Removing Oracle Database Software (http://download. oracle.com/docs/cd/B19306_01/install.102/b14316/ deinstall.htm).
  • Install OracleXEUniv.exe recommended for a small footprint database. Make sure that you read step 1 above before installing. You can get XE from here: http://www.oracle.com/technology/products/database/xe/index.html or Download from Oracle XE Univ.
  • Configure Oracle XE Universal Edition as follows.
    When you are using Oracle XE, you must update database parameters if you have never done this for your database installation. You only have to do this once after installing. Set the processes parameter to >=200 using the following instructions.
  • <Prompt> sqlplus sys/welcome1@XE as sysdba
    <SQL> show parameter session
    <SQL> show parameter processes
    <SQL> alter system reset sessions scope=spfile sid='*';
    <SQL> alter system set processes=200 scope=spfile;
    <SQL> shutdown immediate
    <SQL> startup
    <SQL> show parameter session
    <SQL> show parameter processes

Step 2) Create repository using Oracle RCU (Repository Creation Utility)

Using RCU, you can create repository for SOA. You dont have to install RCU for using it. RCU comes as a zip file which you need to unzip. Once you unzip you run <RCU_UNZIP>/bin/rcu binary

This will invoke a GUI. On the first page you can select “Create Repository” and click on next.

On the next page RCU will ask for database details in which you want to create the repository. The page will look as shown below

1

Once you connect to database, on the next page you need to select the repository that you want to create. Here you can select SOA as shown below. Metadata services will get selected automatically. Also you can use any prefix for these schema. All these schema created will have the prefix string prefixed to it. In this case it will prepend DEV before each schema name. Example DEV_MDS, DEV_SOAINFRA etc.

2

Once you click on next, it will show the summary and will create tablespace if they dont exists. After tablespace creation, click on create and it will create the required repository schemas.

Step 3) Install WLS (weblogic Server) and create a middleware home

Next step is to install WLS server. Carry out the basic installation of WLS. You need to provide a new location for middleware home when asked for as shown below.

wls1

Next it will ask for the location of weblogic. Here you can accept the default value as it will be created inside middleware home.

wls2

Select all other values as default and install WLS.

Step 4) Install SOA 11g inside middleware home

Installation of SOA home is again very straight. Installation of SOA will just lay down the file system, it wont configure anything. Important input while installing SOA is the middleware home location and location for SOA home

soa1

Here Oracle_SOA1 directory will get created inside mwhome directory. Rest of the inputs for SOA installation can be default.

Step 5) Use config.sh or WLST to create and configure SOA domain and managed servers

Once SOA installation is done, the last and the most important step is configuring SOA domain.

You need to navigate to <middleware_home>/Oracle_SOA1/common/bin location and run config.sh script. This script will open a new GUI window. Follow the below screen shots for configuring SOA.

soa2

Select all the required template from this screen. If you don’t need BAM installation, you can uncheck the Business Activity Monitoring template. Click on Next.

soa3

On the next screen give any domain name (soa_domain) in this case. You can keep the Domain location and Application location as default. These directories will get automatically created when this domain gets created at the end of installation. Click on Next.

soa4

On this screen, provide the weblogic password and click on Next.

soa5

On this screen you need to provide the database connection details like database name, hostname and database port. You also need to provide all the schema names and password you created using RCU. RCU will create exact 5 schemas required for SOA configuration. You need to provide details of those schemas on this screen. Once you click in next, the configurator will test the connection for all 5 schemas.

Once the connection test goes successful, you can keep rest of the values as default and create the required domain.

After domain creation start the weblogic server using <middleware_home>/user_projects/domain/<domain_name>/bin/startWeblogic.sh script

Also start the managed servers using <middleware_home>/user_projects/domain/<domain_name>/bin/startManagedWeblogic.sh script

You can then login to console using http://<SOA hostname>:<AdminServer port>/console

soa6

In the next post, I will provide the WLST details instead of config.sh for performing tasks in step 5) above.

Hope this helps !!