Home > Oracle Service Bus > Oracle Service Bus – Upgrade to OEPE

Oracle Service Bus – Upgrade to OEPE

Oracle recently released its Service Bus tool suite Oracle Enterprise Pack for Eclipse (OEPE) This Eclipse 3.6 Helios based version offers Oracle Coherence Tools and supports Weblogic Scripting Tools (WLST) via the PyDev Eclipse plugin. There are lots of other nice features added compared to

But how do you install it in an existing environment without reinstalling OSB afterwards?

Simply unzipping the downloaded zip file into a new folder within the middleware home does not work. You won’t be able to create Oracle Service Bus Configuration projects. Or, if you open existing projects you will miss the ability to add Service Bus projects to Service Bus Configuration projects (Eclipse tries to move one folder physically into another instead).

In fact, there is not much to do to get it working:

  1. Download OEPE

  2. Unzip it into your middleware home. Mine is located at D:\Oracle\Middleware so I unzipped it into D:\Oracle\Middleware\oepe11_1_1_6_0

  3. Create a file named oracle.osb.ide.link in the directory D:\Oracle\Middleware\oepe11_1_1_6_0\dropins\

  4. Open the file in a text editor an insert the following line:
    The path points to your OSB installation directory. Notice the forward slashes.

  5. Open the file D:\Oracle\Middleware\oepe11_1_1_6_0\eclipse.ini in a text editor

  6. Modify the memory arguments according to this:

  7. Add the following lines to the end of the file (adjust paths according to your environment):

That’s it. Start eclipse.exe. Some more tips probably ease your life:

  • Create a fresh Eclipse workspace.

  • This means all your runtime environments, servers and the like are gone. It’s vital to create the new ones with exactly the same names as they have got in the old workspace. Otherwise your OSB projects point to not existing resources and you will have a hard time getting everything back to work.

  • Import all the OSB projects into the new workspace.

  • If you have trouble with your existing Oracle Service Bus Configuration project, simply drop the old and create a new one. It is not much work to configure the target server and to add all the OSB projects to the OSB Configuration project via drag&drop.
  1. AD
    October 27, 2010 at 11:35 pm

    Mischa – Is there way to export the projects done using the ALSB console into Eclipse projects? I want to have a more control on versioning by using Eclipse instead of sbconsole. How can export the projects on sbconsole and import them as eclipse osb projects?

    • October 28, 2010 at 9:36 am

      This is pretty easy (I assume you are using OSB 11g, maybe it works for older versions too):
      – Export the projects with the OSB console (System Administration -> Export Resources)
      – In Eclipse (OEPE) create an OSB Configuration project
      – Right click on the Configuration project -> Import -> OSB Configuration JAR
      – Select the exported JAR, import it and you’re done

      • November 16, 2012 at 3:27 pm

        We have managed to use maven to improve our build and release process. Better forget about OSB Workstudio (or whatever is called) and learn how to design pipelines using a proper XML editor, once you understand the structure is pretty straightforward and you avoid a lot of pain.
        Plus, you can take full advantage of including your java class (saxon??)

  2. Khaleel
    December 7, 2010 at 3:17 pm

    I am getting the following error when I tried to create a connection to the server in the eclipse servers tab.
    The error is:
    An internal error occurred during: “Configure WLST Interpreter”.

    Also, if you have idea please help about one more issue in the default OEPE 3.5
    When I try to create the connection, the connection creates and the server starts running, but finally the servers tabl gets a unable to start the server. changes the status to STOPPED.
    Any help please. Urgent.

    • December 7, 2010 at 4:26 pm

      I think there’s something wrong with one of your paths (either in eclipse.ini or the system CLASSPATH variable or any other system variable).

      Maybe this helps too: http://forums.oracle.com/forums/thread.jspa?messageID=9161914&tstart=0

      When the configuration errors are fixed, your second error will be gone away too I hope…

    • Prashant
      December 20, 2010 at 6:47 pm

      Is anyone able to solve Internal Error related to “Configure WLST Interpreter” in OEPE

  3. Khaleel
    December 8, 2010 at 7:15 am


    I have reverified the settings in OEPE everything seems to be correct, but I have the same error as in the above forums. I have installed the

    Oracle XE 10.3 database for DEV_SOAINFRA

    Even I reinstalled, still I have the same issue.

  4. Khaleel
    December 8, 2010 at 9:49 am


    After doing lot of R&D I still not found the solution to connect the server from OEPE

    However I found a solution for the OEPE OEPE 3.5 issue.
    The solution is commenting with # to the following line in the drivers/etc/hosts file
    # localhost

    I suspect, its trying to use the t3 protocal which intern is linking to this.
    However, I have some more questions…
    1. I am not able to stop the server
    I hope there is some setup need to be done to the server to use HTTP protocal instead of t3 protocal. Do you have any suggestions.
    For more information about the issue, please look at


  5. tastd
    March 1, 2011 at 11:26 pm


    Is it possible to make the OEPE IDE sychronize changes made in the console, by me or other people? Now, if I (or someone else) makes a change in the console, the IDE never sees it and I’m afraid it will overwrite such changes with no warning.

  6. July 28, 2012 at 11:26 am

    I am having a lot of troubles trying to get OSB working on Windows 7 64bit Professional.
    I keep get in “The selected wizard could not be started.
    Plug-in “com.bea.alsb.ui” was unable to instantiate class “com.bea.alsb.ui.wizards.NewALSBContainerWizard”.
    com/bea/alsb/core/containers/exceptions/ContainerException” when trying to craete a new OSB project. My question is what are the different components required to get OSB functional and running on windows 7 ????… Thanks.

  7. Priya
    August 29, 2012 at 9:57 pm

    Hi, i followed all d steps u listed..but my eclipse ide doesnt show d option of opening an osb project..can u pls help?? priya

  8. Harsha
    September 10, 2012 at 7:42 am

    Hi Mischa

    I am a newbie in Oracle Middleware products. I am trying to learn OSB. I have downloaded the following versions of softwares:
    OSB –
    WebLogic – 10.3.5
    SOA Suite –

    I have faced a lot of issues while installing OSB IDE with the above version. Then according to your blog, I have downloaded oepe-helios-all-in-one- Unzipped it in the Middleware home and labelled the directory as oepe. After that I have installed OSB and I could install the OSB IDE successfully after this. When I checked in the dropin directiry, the link file was already present and it was pointing to the right OSB directory. When I checked eclipse.ini file, all the directories, ie. wls home, middleware home and others were poiniting correctly.

    Now when I tried to create a OSB project I am facing with the following error:

    An error has occurred. See error log for more details.

    It would be great if you could help me with this request.

    Thanks in advance.

    With Warm Regards

    • September 12, 2012 at 9:10 am

      There seems to be a common misconception about versioning. This post is about OEPE, not about OSB The version of OEPE which is delivered with OSB is OEPE (as far as I know).

      To solve your problem, make a fresh install with the bundled WLS+OEPE and then install the OSB.

  1. No trackbacks yet.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s

%d bloggers like this: