Installing Oracle SOA Suite/JDeveloper 11g

This post guides you through the installation of the Oracle SOA Suite 11g with JDeveloper 11 with the use of Oracle XE database (for Windows).
Note: It is assumed that Oracle XE database is already installed.

Required downloads

The detailed steps are nicely described here.
The next picture gives a nice overview of the directory structure created.

Step1 -  Create Schemas for Oracle SOA Suite and Oracle BAM (RCU)

  • Unzip the files
  • Run bin/rcu.bat
  • At the Database Connection Details fill in the XE details. If you encounter the next fault you have probably not started the XE database.

  •   Ignore all warnings

  • Click OK
  • Select all components

  • I ran into the following problem:

When you click Ok you see the following error:

And this is about the Processes DB Init parameter that is wrong.
To fix this goto the Database Home page, Sql Editor and execute the following statements:
alter system set PROCESSES=500 scope=SPFILE;
alter system set open_cursors=500 scope=SPFILE; 
If everything is ok you should see the next screen.
  • Further ignore errors from portal installation

Step 2 - Install Oracle WebLogic Server and Create the Middleware Home
  • Run wls1031_win32.exe
  • Choose Middleware Home (example: d:\oracle\middleware)
  • Register for security updates, leave empty, Next
  • Choose Typical install type
  • Choose Weblogic Server Home (example: d:\oracle\middleware\wlserver_10.3)
  • The next screens choose Next and the installation progress screen is shown
  • After a while you are done with this step
Step 3 - Installing SOA Suite and BAM
  • Unzip ofm_soa_generic_11.
  • Run setup.exe within Disk1 directory
  • When asked for the Java jre use middleware home (d:\oracle\middleware\jdk160_11\jre)
  • When the checks are finished the installation locations are asked:
    Use the Middleware Home (selected by default) and use Oracle_SOA1 (also default)
  • The following components are installed: BPEL PM, Mediator, Rules, B2B, Human Workflow, BAM

Step 4 - Creating Domain

  • Run Configuration Application Server within SOA
  • Create a New Domain
  • Select all products to be supported
  • Enter a Domain name
  • Configure JDBC Component Schema

  • Select all optional configuration

  • Configure the Administration Server, leave unchanged
  • Configure Managed Servers, leave unchanged
  • Configure Clusters, leave unchanged
  • Configure Machines, leave unchanged
  • Assign Servers to Machines, leave unchanged
  • Target Deployments to Clusters or Servers, leave unchanged
  • Target Services to Clusters or Servers, leave unchanged
  • Configure JMS File Stores, leave unchanged
  • Configure RDBMS Security Store Database, leave unchanged
  • Summary
  • Create
Step 5 - Install JDeveloper
  • Run jdevstudio11111install.exe
  • Choose the existing Middleware Home directory
  • The rest is Next, Next, ...
  • After JDeveloper is installed start JDeveloper
  • Choose Help -> Check for Updates
  • On the Source page choose:

  • On the Update page select the extensions to download

  • Note: You need an Oracle Web Account. 
  • After the download is finished you have to restart JDeveloper.
That's it and now you can start developing SOA components using SCA, but that is an item for another blog item ;)


  1. Thank you very much for this post, it helped me a lot!

  2. Hi Roger,

    Thanks for the guide.

    I'm looking to jump ship from ILE RPG + Websphere MQ + SOA development, to Oracle SOA developement. Either with Jdeveloper+Java (new to me), or Netbeans+ROR (known to me). But the information mentioned (by Nestor Camilo) about visually designing with ADF, and therefore productivity and standardization, made me re-think the Netbeans+ROR option. Also, it made me doubt if there is one company out there looking for Oracle based SOA + ROR.
    Some more background to this here : http://www.linkedin.com/groupAnswers?viewQuestionAndAnswers=&discussionID=25792400&gid=77513

    Continuing, but I think that the RAM requirements for installing the following are horrendous, totaling about 10GB RAM. Although my PC has 8GB RAM and nTB of HHD, it wouldn't cope.

    So what do you think would be the REAL hardware requirements for installing the following for one single developer :

    In a VMware VM (Ubuntu Server 10.04 LTS 32-bit) :
    1) Oracle DB EE 11gR2 ¹
    2) Oracle Weblogic Server 11gR1 + Coherence + OEPE

    ¹ With this guide : http://www.pythian.com/news/13291/installing-oracle-11gr2-enterprise-edition-on-ubuntu-10-04-lucid-lynx/

    On Windows 7 Ultimate 64-bit or Kubuntu Desktop 10.04 64-bit :
    3) Oracle Fusion Middleware Repository Creation Utility 11gR1
    4) Oracle SOA Suite 11gR1
    5) JDeveloper Studio 11gR2


  3. Hello Robert,
    Thanks for the question. First I let you know that i'm not a infra guy. But I do have some questions:
    1) Why install DB EE, Express Edition not enough?
    2) Why Coherence and OEPE when already using JDeveloper?
    3) What will you be using on your machine? So what do you want to test?

    I have installed the SOA Suite on my machine with 4GB, so 8GB should be plenty enough.


  4. Everything Oracle (except NetBeans) is new to me. That's probably why.

    1) I didn't realise that there was an Express edition.
    All installation walkthroughs I have seen mention the Enterprise Edition.
    If the Express edition is at the same release level, and gives me everything for SOA development, I see no problems in using that version.
    2) Coherence + OEPE come bundled with WLS.
    Can you opt out during installation ?
    Oracle installation docs do not mention this.
    The less resources used, the better.
    3) I have a couple of ROR web applications on a DB2 Express DB, and MySQL back end, which I want to port to an Oracle DB back end. And the Rails front end maybe to ADF.
    This is all homebrew, but rather large. Without telling too much, and getting myself into problems. Almost all SOA services I had to design, map, and develop at work in ILE RPG + Websphere, were also done at home to learn ROR.
    So nothing to be released. Just learning and maybe porting to Java as well to learn that.

  5. @Robertino

    What is your goal to learn?
    A) Java
    B) SOA
    C) Oracle SOA Suite

    A) You do not need Oracle SOA Suite to learn Java
    B) You do not need Oracle SOA Suite to learn SOA
    C) You do not need bi EE DB, you can start with MySql or Oracle Express Edition.

    First I think you should expose your data (database) within a webservice and call these webservices from ROR. After that you can easily change the DB or change your front end.
    Expose the webservices through the Oracle Service Bus.
    The SOA Suite could be used as a platform to expose your databases.

  6. A) Agree, but long term
    B) There is always something to learn, but see below
    C) Agree

    The version of Websphere MQ I have is ancient, and not supported anymore. The current version is V7.01. Also there are no more free versions, and no developer discounts. I decided not to sink anymore money into IBM's wallet.

    Regarding B), this is a very brief overview of what I have now :

    1) IBM DB2 Express-C 9.7

    2) DB2 On Rails (through the IBM_DB-1.1.1 gem)

    3) MySQL 5.1

    4) WebSphere Application Server Community Edition
    Community Edition v2.1.1.4 http://www-01.ibm.com/support/docview.wss?uid=swg27018543

    5) Rjb gem Ruby Java Bridge (a bridge between Ruby and Java with JNI)
    So I can speak to the App Server from Ruby, and use the MQ APIs. (Also handy to speak to Oracle ADF from Ruby)

    6) Websphere MQ 5.4 as the bus
    For COBOL, PL/I, Java, (ILE) RPG, and C/C++, JMS, Perl, .NET, SOAP, VB

    7) Ruby 1.9.1 and Rails 2.3

    8) And the other bits XML, Bus and Service Adapters, (Web) Services, (Web) Requests

  7. The books from Thomas Erl (www.soabooks.com) are good to learn the concepts of SOA Services.
    In your case you have to design the Services that you need from your legacy systems. Then choose the right technologies to expose the Services (can be WebServices, can be something else).
    Also think about a Common Data Model so the data can be reused within Services.
    Then in the future you can also use BPM to model and execute the business processes.

  8. Roger,

    I've bought several products over the years from SOAschool.com.

    I was trying to tell you that I've been designing and building SOA services since 2004.
    I've SOA enabled legacy AS/400 databases and applications to carriers like DHL, Nippon Express, SAP, the web, etc.
    Mapping data, defining and describing the services (functional and technical), estimation / planning of required capacity for the services, DB adapters (conversion and reporting) for in the legacy, and new systems, and the adapters to connect the services to the bus, etc.
    Request-Reply, Fire-and-Forget, etc, messaging.

    I'm not saying that I know everything there is to know about SOA Services. But I do know a fair bit.
    (Have a look at my LinkedIn profile.)
    I'm trying to take my SOA knowledge to a different platform.

    Most of these SOA services and adapters I **cough** rebuilt **cough** privately **cough** while learning Ruby. So they were written with a ROR front-end and Ruby back end.
    So in the short term I'm sticking to Ruby for the front-end and want to mix that with ADF designed classes. I want to port the back-end to Oracle DB and WLS.
    In the long term I'm looking to add Java to my skills. Shouldn't be too hard.
    But I like to have stuff installed (without hogging my system). If everything I need is within easy reach (already installed), it's easier and faster to learn.

  9. Robertino,

    Ok, clear, sorry, my misinterpretation.
    Just hoped that exposing with WebServices alone is not SOA ;)

    If in fact I should start with the OSB, to expose the backend systems. So the SOA Suite and OSB installation (WLS is included). That must easily fit with 8GB.

    Good luck !

    You may also check out Edwin Biemond's blog: biemond.blogspot.com/

  10. Hi Roger,

    It's not a problem, I asked you for information, so I listen. And maybe I should have been more precise.

    And no, exposing with webservices alone is not SOA. But as a one man band (in at-home-ICT anyway) I have to do it in steps and learn.

    Thanks very much for the info.
    Better get it done now.