Antony Reynolds' Blog

  • January 31, 2011

Using the SOA-BPM VIrtualBox Appliance

Antony Reynolds
Senior Director Integration Strategy

Quickstart Guide to Using Oracle Appliance for SOA/BPM

Recently I have been setting up some machines for fellow engineers.  My base setup consists of Oracle Enterprise Linux with Oracle Virtual Box.  Note that after installing VirtualBox I needed to add the VirtualBox Extension Pack to enable RDP access amongst other features.  In order to get them started quickly with some images I downloaded the pre-built appliance for SOA/BPM from OTN.

Out of the box this provides a VirtualBox image that is pre-installed with everything you will need to develop SOA/BPM applications.

Specifically by using the virtual appliance I got the following pre-installed and configured.

  • Oracle Enterprise Linux 5
    • User oracle password oracle
    • User root password oracle.
  • Oracle Database XE
    • Pre-configured with SOA/BPM repository.
    • Set to auto-start on OS startup.
  • Oracle SOA Suite 11g PS2
    • Configured with a “collapsed domain”, all services (SOA/BAM/EM) running in AdminServer.
    • Listening on port 7001
  • Oracle BPM Suite 11g
    • Configured in same domain as SOA Suite.
  • Oracle JDeveloper 11g
    • With SOA/BPM extensions.


The VM by default uses NAT (Network Address Translation) for network access.  Make sure that the advanced settings for port forwarding allow access through the host to guest ports.  It should be pre-configured to forward requests on the following ports

Purpose Host Port Guest Port (VBox Image)
SSH 2222 22
HTTP 7001 7001
Database 1521 1521

Note that only one VirtualBox image can use a given host port, so make sure you are not clashing if it seems not to work.

What’s Left to Do?

There is still some customization of the environment that may be required.

If you need to configure a proxy server as I did then for the oracle and root users to set up an HTTP proxy

  • Added “export http_proxy=http://proxy-host:proxy-port” to ~oracle/.bash_profile and ~root/.bash_profile
  • Added “export http_proxy=http://proxy-host:proxy-port” to /etc/.bashrc
  • Edited System->Preferences to set Network Proxy
  • In Firefox set Preferences->Network->Connection Settings to “Use system proxy settings”
  • In JDeveloper set Edit->Preferences->Web Browser and Proxy to required proxy settings

You may need to configure yum to point to a public OEL yum repository – such as http://public-yum.oracle.com.

If you are going to be accessing the SOA server from outside the VirtualBox image then you may want to set the soa-infra Server URLs to be the hostname of the host OS.


Once I had the machine configured how I wanted to use it I took a snapshot so that I can always get back to the pristine install I have now.  Snapshots are one of the big benefits of putting a development environment into a virtualized environment.  I can make changes to my installation and if I mess it up I can restore the image to a last known good snapshot.

Hey Presto!, Ready to Go

This is the quickest way to get up and running with SOA/BPM Suite.  Out of the box the download will work, I only did extra customization so I could use services outside the firewall and browse outside the firewall from within by SOA VirtualBox image.  I also use yum to update the OS to the latest binaries.

So have fun.

Join the discussion

Comments ( 5 )
  • Alex Friday, May 27, 2011
    I downloaded the SOA appliance including the VirtualBox and Extensions.
    It simply doesn't boot after I imported it in VBox.
    It stops with a message saying:
    - Memory for crash kernel (0x0 0x0) not within permissible range
    I gave to this VM 3 GB of RAM, since I have 8 GB on my machine.
    Any ideas how this issue can be solved?
  • Tomas Thoms H. Tuesday, July 5, 2011

    Hi, I have the same problem trying to start the SOA appliance with VirtualBox. It simply doesn't start with the same message.

    Any special settings should i apply?

    Thanks, Tomas.

  • Antony Tuesday, July 5, 2011

    Very strange, the "Memory for crash kernel (0x0 0x0) not within permissible range" occurs on all my Linux VMs and does not seem to cause any problems. I run an 8GB machine and just tried downloading the VM again and starting it in the default 2GB VM. It seems to be running fine.

    I am running VirtualBox 4.0.8 on Windows 7 64-bit. I have also run the image on OEL 5 with no problems.

    Did you load the VBox extensions?

  • Tomas Thoms H. Tuesday, July 5, 2011

    Yes, is installed. With a colleague discovered some interesting about that, and of course, solutioning the trouble. In VirtualBox the user must check the "Enable IO APIC" handler before VM starting. That's all and worked well.

  • Sid Monday, March 19, 2012


    I have installed oracle pre-built VM on my machine and is running fine.

    1. Can you please me what is the password for SYSTEM user for the oracle XE that is installed in the oracle VM appliance.

    2. Can I run my SOA programs with root as user (linux user)? Currently I am running it from oracle user.

    Looking forward to your reply.



Please enter your name.Please provide a valid email address.Please enter a comment.CAPTCHA challenge response provided was incorrect. Please try again.