Macos – Installing Oracle 11g on OSX


I would like to run a complete SOA/OSB development environment on OSX.
Unfortunately, Oracle 11g (SOA and OSB) is missing OSX installers.

Is it possible to run a native development environment on OSX ?

I need Oracle Enterprise Pack Extensions, OSB extension, jDeveloper and SOA composites to work natively.

Best Solution

Yes! The fact that Oracle doesn't provide a OSX installer doesn't mean these product shouldn't work natively. Most of them are actually 100% Java.

Please follow the instructions below to install you development environment.

Instructions are for 11g but were also tested with The trick is to run the installer via a Linux VM and migrate the files to OSX.

Linux VM Installation

It doesn't really matter if you get a 32 or 64 bits Linux distribution. However, the installation folder should be the same on Linux and MacOS.

  1. Download VirtualBox and create a Virtual Machine for Linux. Since we are dealing with Oracle products, rather user their linux distribution: look for this file on google OracleLinux-R5-U7-Server-i386-dvd.iso
  2. With the VM installed, up and running, boot into Linux.
  3. Install JDK 1.6 for Linux 32 bits

Download the following software, oracle offers native installers for windows and Linux. However you should stick to generic downloads as much as possible. Some of these packages come in several zips, extract files according to oracle directions.

  • Weblogic & coherence: wls1034_generic.jar
  • OEPE:
  • jDeveloper: jdevstudio11114install.jar
  • OSB: ofm_osb_generic_11.
  • SOA: soa_generic_11.

Install the software in the following order

  1. Weblogic & Coherence: run with java -Xmx1024m -jar wls1034_generic.jar
  2. OEPE extract act in a folder called /oepe
  3. OSB Disk1/runInstaller - Make sure OSB IDE extensions are being installed (in OEPE)
  4. SOA Disk1/runInstaller
  5. jDeveloper

OSX Installation


Here comes the trick, copy the oOracle Middleware folder from your Linux VM to OSX. Make sure the location is the same. For instance if you installed under /Oracle/Middleware on Linux, you should copy to /Oracle/Middleware on OSX.


For some obscure reasons, Oracle installers don't recognize the Apple JVM. While not mandatory, it is good practices to fix the issue with the following script.

 $ sudo mkdir -p /System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home/jre/lib
 $ cd /System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home/jre/lib
 $ sudo ln -s /System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/classes/classes.jar rt.jar


  1. Download the following software (64bits please!)
  2. Extract the file into /oepemac
  3. Right click on
  4. On the opened menu, choose “Show Package Contents”
  5. Edit file “/Contents/MacOS/eclipse.ini”, append the following lines


  6. Now copy the file from the folder “oepe/dropins” to “oepemac/dropins” (both under your middleware home).

Oracle XE

Oracle_XE is unfortunately not supported on OSX. we will need to run it via a VirtualBox appliance. The good news is that Oracle provides a easy to install RPM.

  1. Download oracle-xe-
  2. Under Linux, as root, run 'rpm -i oracle-xe-'
  3. Next step is to download and run Oracle RCU to prepare the data model, please refer to the next section for directions.

For reference, we allocated 1cpu, 600MB of ram to our Linux/OracleXE VM.

Next Steps

Configure your web logic development domain. Please refer to this document for instructions. Quick Start Guide for Oracle® SOA Suite 11gR1 (

Fix startup scripts

Finally, you will need to fix domain startup script as follows

------------- user_projects/domains/DEVdomain/bin/ -------------

index f74490c..8d75c6c 100755
@@ -108,7 +108,7 @@ else
        export JAVA_VENDOR
-       JAVA_HOME="/usr/java/jdk1.6.0_21"
+       JAVA_HOME=`/usr/libexec/java_home`
        export JAVA_HOME

------------ user_projects/domains/DEVdomain/bin/ ------------

index 8c6743b..b92cfa4 100755
    @@ -144,6 +144,15 @@ case ${PLATFORM_TYPE} in
         export USER_MEM_ARGS
    +# OSX
    +  export USER_MEM_ARGS
    +  ;;

       # Sun OS
Related Question