Installing Oracle SOA Suite 11gR1 on Windows

So you want to install the Oracle SOA Suite 11g on your Windows machine, but are too lazy busy to read the documentation, even the “Quick Installation Guide for Oracle SOA Suite”? Well, here is an even more condensed version that includes all the download links you may need. Don’t expect this post to explain things – it is is merely a cheatsheet for Windows users looking at a simple one-machine install.

Downloading the packages

(Before we even get started – have you defragmented your drive lately? If not, why don’t you do this now, before we add more software to your machine! This tends to be a recurring issue in our trainings: people come with heavily fragmented drives and this tremendously slows down installers. Right-click on your drive in “My Computer” > Properties > Tools > Defragment Now)

First, you will need to have an OTN account to download packages – you can sign up here; it’s free. Then head here and click on the “Free Download” link in the top right corner.


Here are the packages you will need (under 3.5GB for all the installation packages):

  1. Oracle Database 10g Express Edition: the SOA Suite requires a database for persistence. While you can go for the full Enterprise version, the Express edition is a fine choice for a development environment.
  2. WebLogic Server: this will provide the JEE environment (as well as the JMS provider) required to run the SOA Suite (a JEE application).
    Choose the “Oracle WebLogic Server 11gR1 (10.3.1) - Package Installer” (or the corresponding international version). The name of the package is wls1031_win32.exe, 570MB in size.
  3. Repository Creation Utility: this will lay the database schemas that the SOA Suite uses for various persistence tasks (audit trails, etc,). The name of the package is and it is 282MB in size.
  4. SOA Suite: this is the actual JEE application that contains the SOA engines and that will be deployed on WebLogic.
    Choose the “SOA Suite, Generic” package, its name is and it is 1.5GB in size.
  5. JDeveloper: this is the IDE that you will use to design and deploy your SOA composites.
    Choose the “Studio Edition”. The name of the package is jdevstudio11111install.exe and is 934MB in size.

Installation steps

Install a Database

Install the XE database if you don’t already have one. We will not detail this here.

Run the Repository Creation Utility (RCU)

Run the Repository Creation Utility (RCU) to create the database schemas:

  1. unzip the package you downloaded earlier to C:\ORACLE\11gR1 (for instance).
    Execute C:\ORACLE\11gR1\rcuHome\BIN\rcu.bat.
    Here is the main screen that requires input:

  2. Ignore the warning message (as Heidi mentioned earlier, this simply indicates that Oracle XE is not certified for production use):

  3. Check “SOA Infrastructure” and enter a prefix:

  4. Accept everything after that and create the tables.

Install WebLogic

  1. Execute wls1031_win32.exe
  2. Choose a location for your install – I picked C:\ORACLE\11gR1\MW_HOME

  3. Enter your email if you wish to receive security updates (something you should definitely do if you are an administrator)
  4. Choose a typical install
  5. Accept all other defaults

(no need to run QuickStart since it is really geared towards WebLogic users more than SOA)

Install SOA Suite

  1. Extract the zip file that you downloaded for SOA. I extracted mine to C:\DOWNLOADS\ORACLE\11gR1\soa.
  2. Execute C:\DOWNLOADS\ORACLE\11gR1\soa\Disk1\setup.exe
  3. You might be prompted for a JDK, if so simply enter the path to the one that was installed with WLS: C:\ORACLE\11gR1\MW_HOME\jdk160_11 in my case.
  4. Choose a name for your home directory (for me it will be DMD_SOA1) or accept the default of Oracle_SOA1:


Configure SOA Suite

  1. Go to your SOA home directory, common/bin (for me it will be C:\ORACLE\11gR1\MW_HOME\DMD_SOA1\common\bin) and execute config.cmd
  2. Create a new WebLogic domain
  3. I would recommend you put both Oracle SOA Suite and Oracle Enterprise Manager in the same domain.

  4. Choose a name for your domain (for me it will be dmd_soa_domain1)
  5. Choose a JDK or accept the default (Sun SDK for development environments)
  6. The next screen “Configure JDBC Component Schema” is probably the one that requires the most attention in the whole install process (definitely need to improve this step in subsequent releases!):
    1. If you have picked the default prefix of “DEV_” during the RCU install then check all schemas and then update:
      • service (XE is often the default)
      • hostname (localhost for us)
      • port (1521 is the XE default)
    2. If you have not picked the default prefix, then in addition to the above you will also need to cycle through each schema to update the prefix: Check one schema. Make your change. Uncheck the schema and check the next one. etc.
  7. Ensure that all the tests on the next screen are successful
  8. Don’t select anything on the “Select Optional Configuration” screen
  9. Note down the URL for the admin server

Start the Servers

At this point you should be ready to start the servers!

  • admin server: C:\ORACLE\11gR1\MW_HOME\user_projects\domains\dmd_soa_domain1\startWebLogic.cmd
  • managed SOA server: C:\ORACLE\11gR1\MW_HOME\user_projects\domains\dmd_soa_domain1\bin\startManagedWebLogic.cmd soa_server1

Obviously you should create some shortcuts to easily start these in the future.

Test the Consoles

  1. Ensure you can reach the WebLogic Administration Console: http://localhost:7001/console (if you have installed using default ports).
  2. Ensure you can reach Enterprise Manager: http://localhost:7001/em (if you have installed using default ports).
  3. In Enterprise Manager, ensure that you see the “SOA” folder in the left-hand side navigation tree:

  4. That’s it for the runtime part! Let’s now install JDeveloper so that we can start our development and deploy a few composites to our brand new shiny servers.

Install JDeveloper

  1. Execute jdevstudio11111install.exe
  2. Create a new middleware home for JDeveloper (this is to ensure that JDeveloper doesn’t overwrite the container that we have already installed in the previous steps). For instance C:\ORACLE\11gR1\JDev.

Install the SOA Extension for JDeveloper

  1. Start JDeveloper
  2. Execute C:\ORACLE\11gR1\JDev\jdeveloper\jdev\bin\jdev.exe (if you want the console window) or C:\ORACLE\11gR1\JDev\jdeveloper\jdeveloper.exe (if you don’t care about the console).
  3. “Check for Updates”:

  4. Ensure the “Oracle Fusion Middleware Products” and “Official Oracle Extensions and Updates” centers are checked and click “Next”
  5. Check the “Oracle SOA Composite Editor” and then hit “Next”

  6. You will be prompted for your OTN credentials
  7. At this point JDev will start downloading the extension and restart itself to complete the installation

That’s it. You have just installed a very complete SOA development environment, including everything from the core JEE container, a messaging provider, a BPEL engine, a human workflow and associated worklist, a rules engine, a mediation component, various adapters, a security policy manager, monitoring and management environment and an IDE. Next we will look at a few things we can do with all this!


Super. Can't wait for the next post. I am interested in taking baby steps with this installation before doing more complex things. Thanks

Posted by Mike Ballack on August 23, 2009 at 05:17 PM PDT #

I install RCU. However, the installation stopped due to an error (RCU-6107). RCU-6107:Falha de Pré-requisito do Parâmetro de Inicialização do BD para: processes Valor Necessário = 200, Valor Atual = 40, Operador de Comparação: ">=" at oracle.sysman.assistants.rcu.backend.task.PrereqTask.execute( at at To fix this problem, try to connect to your database and change the amount of processes allowed. SQL> alter system set processes=300 scope=spfile; Try to install RCU after this change.

Posted by Cleber Moura on September 09, 2009 at 02:01 AM PDT #

Mike: Working on some new samples - they should hit samplecode sometimes next week (I'll make sure to blog about it). Cleber: Did you try to augment the number of processes in the database? You can use the command suggested in the error message you posted to do that. You will also find more details here: Hope this helps!

Posted by Demed on September 09, 2009 at 10:10 AM PDT #

Hi Demed: Is SOA Suite now certified for windows 7? I have 8GB RAM on windows 7 64 bit with Intel Core 2 duo 3.06 GHZ machine. Have not seen anywhere, that it has been certified. So far I have downloaded all the components for 32 bit Linux but hesitant to do that, since I will have only less than 4GB available. Can you please clarify whether it is will install on windows 7? I also saw a forum post on this ( ). Do you think this will work? Appreciate if you can reply. Srini

Posted by Srini on February 25, 2010 at 10:49 AM PST #

Hi Srini, SOA Suite is not yet certified on Windows 7 but WLS is (see certification matrix here: This being said, it seems several people are running this combination successfully so while I wouldn't try it for a production server if it's just for you dev environment you might just want to give it a shot. Let us know how it goes!

Posted by Demed L'Her on February 26, 2010 at 01:27 AM PST #

I'm trying to configure SOA suite after installing JDeveloper (which installed WebLogic) and I'm getting jar dependency errors: [C:\Oracle\Middleware\Oracle_SOA1\common\templates\applications\oracle.soa_template_11.1.1.jar] Multiple dependency matches: Oracle SOA Management Extension: [C:\Oracle\Middleware\jdeveloper\common\templates\applications\oracle.soa.mgmt_template_11.1.1.jar] Oracle SOA Management Extension: [C:\Oracle\Middleware\oracle_common\common\templates\applications\oracle.soa.mgmt_template_11.1.1.jar]

Posted by JoeK on February 26, 2010 at 02:18 AM PST #

Hi Joe, You mention that JDeveloper "installed WebLogic": the WebLogic container bundled with JDeveloper is a stripped down special version of WLS meant for Java and ADF deployment only. It is not sufficient to install SOA. Is that the WLS you were trying to configure for SOA? If so, please download the full version of WLS as per the above instructions instead. Hope this helps.

Posted by Demed L'Her on February 26, 2010 at 02:26 AM PST #

These are not the screens that are showing on my install. The screen I am looking at shows: Hostname: Port: Service Name: ORABPEL password: ORAESB password: ORAWSM password

Posted by Dorothy on March 21, 2010 at 09:56 AM PDT #

- Installed all the pieces of Oracle SOA Suite 11g (WLS, RCU, SOA, domain containing soa and bam) - can reach all the consoles (admin, b2b, worklist) except for em - when I hit the http://localhost:7001/em, it displays the login page - after I enter the userid and password, the display clocks and nothing shows up on the screen - there are no errors generated on the logs. Ensured that Enterprise Manager was selected when creating the domain - can you please shed some light as to what might be going on ?

Posted by Sanjoy Dasgupta on April 25, 2010 at 02:53 PM PDT #

That's fairly unusual. A few things I would do: 1. Try in a different browser (ex: if you were using Firefox, try with IE) 2. If you were using a proxy, try to bypass it ("no proxy") if that is an option 3. ensure you allow pop-ups for that server 4. if all this fails look in the server log Hope this helps.

Posted by Demed L'Her on April 26, 2010 at 03:39 AM PDT #

I have just followed this guide to set up a testbed environment for SOA 11g on my Windows 7 machine. After running the 'Configure SOA Suite' by creating a new domain in the app server for SOA Suite 11g, I was unable to start the managed WebLogic server. soa-infra would not deploy properly, and I could not get the 'SOA' folder to display when opening up Enterprise Manager. The solution was to configure Node Manager properly before starting startManagedWebLogic.cmd soa_server1. You need to run the script: \Middleware\oracle_common\common\bin\setNMprops.cmd which appends the correct settings to That step is not included in this blog post, but as far as I can see, it is a crucial step in order to configure soa-infra and related components. Cheers Anders

Posted by Anders Ostergaard Jensen on April 27, 2010 at 12:21 PM PDT #

Anders, Thanks for sharing the details. This is interesting and might be helpful to others. However you should not have to manually perform this step for a standard install. Where you installing in an existing environment or building some cluster?

Posted by Demed L'Her on April 27, 2010 at 01:37 PM PDT #


I have a working install with all components on a Windows 2008 server.

Jdeveloper 11gR1
Oracle DB 11gR2
MDM 2.01
OUAF 4.1
Weblogic 10.3

And now I need to install SOA suite 11g. When I did, Jdeveloper stopped working. All that came up was foe me to select the role and then nothing.
I was able to revert back to a saved image.

So now that I will start over I was wondering if you know of any special setup conditions I need to pay attention to when I install SOA suite 11g on top of my existing install.

I hate to mess with that working MDM image now since it took me a while to get there.

Any help would be greatly appreciated.

Posted by Steve on June 23, 2011 at 11:32 PM PDT #

Hi, a put the java path on soa setup screen but the windows 7 64 bit shell closes. What´s the problem?

Posted by guest on June 24, 2011 at 10:22 PM PDT #

Unable to run setup.exe while installing SOA suite.
I am using windows 7 OS and 64 bit.
Installing is exiting after providing JRE path and hitting enter.
Any quick inputs to run this will be more helpful.


Posted by Ram on August 07, 2011 at 09:27 PM PDT #

do we need MKS tool Kit for Oracle SOA Suite 11g installation.

Posted by saurabh on August 31, 2011 at 03:46 AM PDT #

Thanks, for providing the nice short notes to install the SOA

Posted by guest on May 19, 2012 at 10:20 PM PDT #

I was able to install SOA on my windows 7 64bit. I created a link to "Program Files" java using following commands. If mklink command is not available, download it from microsoft.

mkdir tools

cd C:\tools

mklink /D java "C:\Program Files\Java\jdk1.6.0_25"

Once you created the link, point C:\tools\java as JAVA_HOME for SOA instatllation

Posted by guest on June 25, 2012 at 02:19 AM PDT #

Many thanks to the above guest. It solved my problem installing SOA11g on Windows 2008 R2.

Posted by guest on September 04, 2012 at 08:01 AM PDT #


Are there any plans on providing a working guide?

Posted by Shannara on December 21, 2012 at 12:45 PM PST #

I'm trying to install SOA Suite on my local Windows 7 64-bit system. I have gone through the process to install DB 11g, WebLogic, RCU, JDeveloper with SOA Extensions. Everything is working fine. Now I'm trying to install the actual SOA Suite. After running setup.exe and specifying a valid 64-bit JRE (I've tried both the Java HotSpot JRE which I used to install and configure WebLogic, and a fresh install of JRockit), a command window pops up indicating that all tests have passed, and says "Preparing to launch Oracle Universal Installer from C:\Users\rich\AppData\Local\Temp\OraInstall2013-03-07_10-49-13AM. Please wait ..." and then nothing happens. The command window goes away, but no installer appears, no prompt, no error message... just nothing. At this point in the process, there are no logs, so I can't get more information on what's going on. Any help or insight you can provide would be greatly appreciated.

Posted by Rich on March 07, 2013 at 09:03 AM PST #


Have you tried this:
- open command prompt (cmd.exe)
- navigate to directory containing setup.exe
- type setup.exe
This might tell you more than simply double-clicking on the installer.

Posted by Demed on March 07, 2013 at 09:14 AM PST #

Also: check out your oraInventory/logs directory and the .log, .err and .out corresponding to your install. See

Posted by Demed on March 07, 2013 at 09:35 AM PST #

Post a Comment:
  • HTML Syntax: NOT allowed

Find Us on facebook Follow us on twitter Oracle SOA Suite forum
SOA PM team
Welcome to the Oracle SOA Suite team blog. We'll use this site for news and information that did not make it into our official documentation for a reason or another.


« April 2014