Installing Eclipse for OSB Development

OSB provides 2 methods for OSB development, the OSB console, and Eclipse. This post deals with a typical development environment with OSB installed on a remote server and the developer requiring an IDE on their PC for development. As at Eclipse is only IDE supported for OSB development. We are hoping OSB will support JDeveloper in the future.

To get the download for Eclipse use the download WebLogic Server with the Oracle Enterprise Pack for Eclipse, e.g. Oracle WebLogic Server 11gR1 (10.3.4) + Coherence + OEPE - Package Installer (wls1034_oepe111161_win32.exe).

To ensure the Eclipse version is compatible with your OSB version I recommend using the Eclipse that comes with the supported WLS server, e.g. OSB you would install WLS 10.3.4+oepe.

The install is a 2 step process, install the base Eclipse, then install the OSB plugins. In this example I'm using the install for windows, your versions may differ.
  1. You need to download 2 programs, WebLogic Server with the oepe plugin for your OS, and the Oracle Service Bus which is generally generic. Place these files in a directory of your choice.

  2. Start the executable

  3. I create a new Oracle Home for this installation as it don't want to impact on my JDeveloper install or any other Oracle products installed on my machine.

  4. Ignore the support / email notifications

  5. Choose a custom install as we only want to install the minimum for Eclipse. If you really want you can do a typical and install everything.

  6. Deselect all products then select the Oracle Enterprise Pack for Eclipse. This will select the minimum prerequisites required for install.

  7. As I'm only going to use this home for OSB Development I deselect the JRockit JVM.

  8. Accept the locations for the installs.

  9. If running on a Windows environment you will be asked to start a Node Manger service. This is optional. I have chosen to ignore.

  10. Select the user permissions you require, I have set to default.

  11. Do a last check to see if the values are correct and continue to install.

  12. The install should start.

  13. The install should complete successfully. I chose not to run the Quick Start.

  14. Extract the OSB download to a location of your choice and double click on the setup.exe. You may be asked to supply a correct java location. Point this to the java installed in your OS. I'm running Windows 7 so I used the 64bit version.

  15. Skip the software updates.

  16. Set the OSB home to the location of the WLS home installed above

  17. Choose a custom install as all we want to install is the OSB Eclipse Plugins.

  18. Select OSB IDE.

  19. For the rest of the install screens accept the defaults.

  20. Start the install

  21. There is no need to configure a WLS domain if you only intend to deploy to the remote server. If you need to do this there are other sites how to configure via the configuration wizard.

  22. Start Eclipse to make sure the OSB Plugin has been created. In the top right drop down you should see OSB as an option.

  23. Connecting to the remote server, select the Server Tab at the bottom

  24. Right-click in that frame and select Server.

  25. Chose the remote server version and the hostname

  26. Provide and name for your server if necessary, and accept the defaults

  27. Enter connection details for the remote server

  28. Click on the Remote server and it should validate stating its status.

    Now you ready to develop, Happy developing!


After installing OEPE from here (, I don't see the "Oracle Service Bus" perspective. Is there an additional update for that I need to install? I do, however, see the server configuration and was able to configure that but I'll need the perspective to be able to develop.


Posted by guest on August 09, 2011 at 12:31 AM GMT-11:00 #

I used the WebLogic Server OEPE, not the straight OEPE install. To get the right downloads go to the following link:

depending on your OSB version you will need to download the right software. If you are using the latest you need to go to the specific links, e.g.

- WebLogic Server: Oracle WebLogic Server 11gR1 (10.3.5) + Coherence + OEPE Package Installer
- Service Bus


Posted by James Taylor on August 14, 2011 at 08:29 AM GMT-11:00 #

I want to install wls1034_oepe111161_win32.exe. However I can not see a link from where I can download this exe.
I can see the weblogic server, Service bus installation seperately at Doi I have to do the below:
1.Install first the Oracle weblogic server(from
2. Install Service bus(
Would the eclipse comes pre-packaged in service bus.

Is there a way I can get the install file which contains all these?

Posted by guest on January 31, 2012 at 12:22 AM GMT-11:00 #

The links seemed to have changed a bit from onwards. Before all the middleware was in one place, now you need to go to the specific link. For OSB the link is

For a list of all the middleware products go here:


Posted by James Taylor on January 31, 2012 at 11:18 AM GMT-11:00 #

The first link( is not working.

Can you confirm that the below is the link to get the Oracle 11g OSB:

The problem with this is it has pre-requisites. I was hoping that I can install through a single install file(like you had suggested in your post. Surprisingly I can't find that install file on the Oracle site.)

Please suggest

Posted by guest on January 31, 2012 at 05:40 PM GMT-11:00 #

I think there is an issue with the full stop.

Unfortunately there isn't a one click install, this was the reason why I wrote the post.

Posted by James Taylor on February 02, 2012 at 02:49 PM GMT-11:00 #

Nice post. When I am trying to publish my OSB Configuration Project through Eclipse on remote box, I am not able to do so. How do we configure that?

Posted by guest on April 12, 2012 at 01:55 AM GMT-11:00 #

Are you able to show me if there are any errors?

Are you able to connect to the remote host - look at steps 24 -28.

Is there a firewall between yourself and the remote host, has the port been open.


Posted by James Taylor on April 12, 2012 at 06:51 AM GMT-11:00 #

I was able to follow 24-28 steps and load OSB Configuration Projects.

I dont think there is a firewall as well.

I am getting following error:

[WliSbTransports:381036]SMTP Ref Email Server does not exist.

Posted by Maulik on April 12, 2012 at 07:15 AM GMT-11:00 #

This doesn't look like a deployment problem to the remote server. It looks like you are using the email transport and haven't configured the email server correctly.

have a look at this link and see if it helps.


Posted by James Taylor on April 12, 2012 at 07:15 AM GMT-11:00 #


I want to install OSB and WLS on a Linux system. But, I want to install eclipse on my Windows machine to develop OSB projects. What do I need to install on Linux and Windows to make this happen?



Posted by Mo on May 15, 2012 at 12:39 AM GMT-11:00 #

If running on Linux or Mac you need to install the generic WLS as the oepe is not bundled. So the steps to get the OSB plugin are:

1. Install the WLS for Linux.
2. Download oepe for the OSB version you are running -
3. Upzip oepe into the WLS home into a directory oepe
4. Install OSB with the OSB IDE - Step 18


Posted by James Taylor on May 15, 2012 at 01:30 PM GMT-11:00 #

This post is all about having development on Windows and OSB on a remote server.

Therefore for the development environment follow these steps.

For Linux, just install WLS and OSB on top without the IDE.


Posted by James Taylor on May 15, 2012 at 01:46 PM GMT-11:00 #

Indeed, Oracle products' install process is still very cumbersome, fragmented, and poorly documented! I played with SOA suite few years ago and hated the whole process. Now, I thought things have gotten better. Here I am a PhD holder with 18 years of industrial experience and it took me 4 days just to install OSB/WLS/OEPE. And guess what, I'm not done yet.

One example, when you try to install OSB IDE on Windows, it does not accept your JRE path because it expects to have forward slashes (UNIX) not back slashes (Win). The message doesn't tell you anything about this requirement!

Posted by Mo on May 17, 2012 at 01:37 AM GMT-11:00 #

Sorry to hear that your Oracle experiences haven't been a fond one. I understand your comments around documentation this is why I write blogs like this to simplify them. Oracle documentation is has to cater for all types of deployments, therefore if you are unfamiliar with their products you really need to read them in their entirety. If you take shortcuts you will miss points.

Sorry to hear that it has taken 4 days to get installed and still not complete. I run workshops using these instructions, and I have people up and running within an hour. So I would be interested to know what issues you are facing.

To address your backslash issue, this is not an Oracle thing, but a java thing.

Good luck for the future


Posted by James Taylor on May 17, 2012 at 11:00 AM GMT-11:00 #

I have done the whole installation process and when I open "Oracle Enterprise for Eclipse" (from: Start -> All Programs -> Oracle Service Bus 11g - Home1) I do not see the Oracle Service Bus as an option as you do in step 22. Would you happen to know why that is? I would really appreciate your help! Thanks!

Posted by Albaraa on May 18, 2012 at 04:51 AM GMT-11:00 #

Did you complete step 18?

What was the executable you used for the WLS install in step 2? It should have had oepe in the name.


Posted by James Taylor on May 20, 2012 at 12:52 PM GMT-11:00 #

I actually figured it out, thanks for your help anyways. It was that I did not have administrative access on the certain laptop I was working on and the OSB directory installed (in the eclipse folder) needed admin all I had to do was get admin access and it worked thanks anyways!

Posted by Albaraa on May 21, 2012 at 10:59 AM GMT-11:00 #

James - this was a helpful post - I'm just struggling with a few finer points.

I installed OEPE-WLS-Indigo-installer and OSB_generic_11.1.1.6, in the steps you outlined above. That created a working Eclipse install, but I couldn't get it to connect to my server - which I figured out is at 10.3.5, and this local install is 10.3.6. Not knowing if I could figure out how to make that work, I deleted and tried with the oepe version (wls 10.3.5). But I can't find the compatible OSB ( to download. (OSB didn't work)

I can find matching files for 10.3.4 (OEPE, OSB Will a lower release level on my desktop solve my problem, or just create another?


Posted by guest on June 04, 2012 at 11:49 AM GMT-11:00 #

Sorry for the late reply.

It is important that the development environment matches the run-time environment although I doubt this is an issue with connection to the remote server. Do you know if there is a firewall between your development machine and the server version of OSB? If so make sure you have the weblogic port is open (default 7001) and the OSB port is open (defaul 8011)

To answer your questions here are the following links for the downloads



On the OEPE page you just work back from the top, e.g.OEPE = OSB, and OEPE = OSB


Posted by James Taylor on June 06, 2012 at 11:37 AM GMT-11:00 #

I have looked for OSB and it seems to be missing from OTN and eDelivery. Are you able to check on the server where OSB is installed and see if the media is still there?


Posted by James Taylor on June 06, 2012 at 11:48 AM GMT-11:00 #

My "server" is a virtualbox fully-configured image running on my Macbook-pro. It does have OSB installed. I'm remoting in via my work pc, which has been working fine for JDeveloper/BPEL tutorials.

I had resigned myself to creating a clean virtual image and loading 10.3.6 from scratch, but just realized that if I can get an eclipse client working within the existing Linux VM, that might be the quicker solution.

Thanks for your help,

Posted by Greg Wynne on June 06, 2012 at 12:18 PM GMT-11:00 #

Linux has a firewall turned on by default, this may be your issue, either turn the firewall off, or make sure the required ports are open.


Posted by James Taylor on June 06, 2012 at 12:22 PM GMT-11:00 #

Hi James,

Thanks for the wonderful step by step post

I am having an issue while trying to connect to my remote OSB server from my eclipse installed as per your instructions.

I am running the prebuilt Oracle VBox Images for SOA
downloaded from

configured them for SOA_OSB_DEV Domain

and started the servers which I am successfully able to launch from my local machine browsers

I have then installed OEPE from the oracle website [Oracle WebLogic Server 11gR1 (10.3.6) + Coherence - Package Installer]

And the installed the OSB using

Note: I only installed the OSB IDE as I do not want to configure the OSB Server on my machine but utilise the Remote server which is why I am using the Oracle provided Vbox images.

I have tried a few things I checked the firewalls on the remote liinux box and its disabled and so is the selinux.
Also disabled all firewalls on my machine

Can you please help and guide me what you think might be stopping me from connecting to the remote server?

PS: I am able to connect to another weblogic server[not osb] on a different Vbox image.
and I am able to connect to the weblogic application server from Jdeveloper on both the Vbox images including this one.


Posted by Nitin Aggarwal on October 04, 2012 at 11:12 PM GMT-11:00 #

Thanks James this is really helpful...

However I have noticed a lot of people including me had issues with connecting to the Oracle VM.

So, I have now published a post on my blog with the details of the problem and the solution for that.

Posted by Nitin Aggarwal on October 05, 2012 at 03:55 AM GMT-11:00 #

Seems strange.

Are you getting any error messages. Are you selecting the correct version of OSB when creating the connection.

You say that you have checked the firewall. What about port 8011. Not sure if this is required for deployment.

Also I assume you have the osb managed server started.


Posted by James on October 06, 2012 at 05:29 AM GMT-11:00 #

Hi James, just saw your comment now, I am using Oracle Weblogic Server 11gR1 (10.3.6), I can't paste the connection server screen shot here as the comment box wont allow me.

I do have the managed server started. I am not sure about port 8011 as I am not sure how to check that :).

The thing is it worked when I made the change in the config.xml on the server however when it comes to the actual client environments I am not sure if this will be an option to change the server settings.

Posted by Nitin on November 15, 2012 at 12:13 AM GMT-11:00 #

In step 25, is there an option to select 10.3.6, if not this can be your issue.

You can test if the firewall is open by using the command from the client machine

telnet remotehost 8011

Not sure what you mean by changing config.xml file.


Posted by James Taylor on November 22, 2012 at 01:59 PM GMT-11:00 #

Hi Sir,

I try to install(32-bit)OSB.

when i run the below command

C:\Users\veera_venkata_sathya\Desktop\Softwares\OSB\Disk1>setup.exe -jreLoc C:\Oracle\Middleware\jdk160_29

i am geting the error like

Starting Oracle Universal Installer...

Checking if CPU speed is above 300 MHz . Actual 3392 MHz Passed
Checking swap space: 0 MB available, 512 MB required. Failed <<<<
Checking monitor: must be configured to display at least 256 colors Higher than
256 . Actual 4294967296 Passed

Some requirement checks failed. You must fulfill these requirements before

continuing with the installation,

Continue? (y/n) [n]

when i select y,then again it shows like

Could not find the main Class : oracle.sysman.oio.OiocOneClickinstaller. Program will exit

can anyone plesae help ?

Posted by guest on October 23, 2014 at 10:08 PM GMT-11:00 #

Sorry for the late response. It looks like your environment has no swap configured. I'm not much of a windows man but this link may be able to provide help.


Posted by guest on November 11, 2014 at 03:22 PM GMT-11:00 #

Post a Comment:
  • HTML Syntax: NOT allowed

Discussions and Examples using Oracle Platform As a Service (PaaS) and Oracle Fusion Middleware. Some image links are broken when using Firefox, Safari, and Chrome. If you want to see the full image please use IE.


tumblr hit counter vistors, thanks for your support


« February 2017