Proactive insights, news and tips from Oracle WebLogic Server Support. Learn Oracle from Oracle.

WebLogic Server 14 in Eclipse IDE for Java EE Developers

Stephen Felts

This article describes how to integrate WebLogic Server running on Java SE 11 in the latest supported version of Eclipse IDE for Java EE Developers with Oracle Enterprise Pack for Eclipse (OEPE)

You need to start by getting all of the pieces - Java SE Development Kit, WebLogic Server, Eclipse IDE, and Oracle Enterprise Pack for Eclipse.

Go to https://www.oracle.com/java/technologies/javase-jdk11-downloads.html to download Java SE Development kit (neither WLS nor Eclipse come with it).  Java SE 8 is also supported with WLS but we want to use the latest features.  Accept the license agreement, download the binary file, and install it on your computer.  Set your JAVA_HOME to the installation directory and add $JAVA_HOME/bin to your PATH.  On Windows, this would look like

set PATH=d:\java-11\bin;%PATH%
set JAVA_HOME=d:\java-11

Next get and install a copy of WebLogic Server (WLS).  The latest versions of WLS that are currently supported in OEPE are WLS (Java SE 8 or 11 and Java EE 8) and WLS (Java SE 8 and Java EE 7). Go to the standard WLS download page at Oracle Fusion Middleware Software Downloads  and download the Generic Installer for  If you are running on Windows, your command window to run the jar command will need to be running as the Administrator. 

unzip fmw_14.
java -jar fmw_14.

You can take all of the default values.  You will need to specify an installation directory.  You might want to install the examples.  On the last page, make sure the “Automatically Launch the Quickstart Configuration Wizard” is clicked to create the domain so we can use it in this procedure. 

In the Configuration Wizard, take the defaults.  You may want to change the domain directory. Enter a password and click on Create.

Download “Eclipse IDE for Java EE Developers” from http://www.eclipse.org/downloads/eclipse-packages/ and unzip it.  The latest version that OEPE has been tested with is 2020-06. 

unzip eclipse-jee-2020-06-R-win32-x86_64.zip

Change to the Eclipse installation directory and run eclipse.

Select a directory as a work space and optionally select to use this as the default.  You can close the Welcome screen so we can get to work.

If you are running behind a firewall and need to configure a proxy server to download files from an external web site, select the Preferences menu item under the Window menu, expand the General node in the preferences tree and select Network Connections, change the drop-down to Manual, edit the http and https entries to provide the name of the proxy server and the port.

There are several ways to install OEPE.  For this article, we will install OEPE from within Eclipse. Use this procedure to install OEPE from a repository in the Oracle Technology Network.  From the Eclipse main menu, select Help, and then Install New Software. 

Click Add to add a new update site.  Enter the "Name" Oracle and enter the "Location" http://download.oracle.com/otn_software/oepe/ .  Then click "Add".

In the software list, select the subcomponents you want (Documentation, ADF, MAF, and/or Tools), and then click Next.  The following figure expands on the available tools.

Confirm information presented on the Install Details, and then click Next. Review licenses on the Review Licenses page and click Finish. The installation will continue in the background.  Click on the progress bar in the lower right order to wait for it to complete.  Eventually it will complete and ask if you want to restart Eclipse.   Eclipse needs to restart to adopt the changes. 

Click on the Windows menu item, select Show View, and select the Servers view.

 Click on the link “No servers are available.  Click this link to create a new server”, expand Oracle, and select Oracle WebLogic Server.  If you want to access the server remotely, you will need to enter the computer name; otherwise using localhost is sufficient for local access.  Click Next.

On the next screen, browse to the directory name where you installed WLS and then select the wlserver subdirectory (i.e., WebLogic home is always the wlserver subdirectory under the installation directory).  Eclipse will automatically put in the value of JAVA_HOME for the “Java home” value.  Click Next.

On the next screen, browse to the directory where you created the domain using the WLS Configuration Wizard (you can also click on the button to select from known domains).  Click Next and Finish.

You can double-click on the new server entry that you just created to bring up an overview window for the server. 

Click on “Open launch configuration” to configure any options that you want while running the server and then click OK.

Back in the server view, right click on the server entry and select "Start" to boot the server.

A Console window will open to display the server log output and eventually you will see that the server is in RUNNING mode.

That covers the logistics of getting everything installed to run WLS in Eclipse.  Now you can create your project and start your development.  Let’s pick a Dynamic Web Project from the "File" -> "New" options.

The project will automatically be associated with the server runtime that you just set up.  For example, selecting a dynamic web project will display a window like the following where the only value to provide is the name of the project.

There are many tutorials on creating projects within Eclipse, once you get the tools set up.

Join the discussion

Comments ( 3 )
  • Tomas Ericson Thursday, February 11, 2021
    I noticed an issue with adding a remote server, the add server wizard complains about password not being set despite being set, this is preventing the Finish button to be activated. However, the issue is not there with the latest eclipse, eclipse-jee-2020-12-R. I'm on Mac.
  • Gordon Allen Wednesday, March 3, 2021
    When trying to install the Oracle tools on Eclipse 2020-09 on a Mac, I get the error: No repository found containing: osgi.bundle,org.jboss.tools.common.jaxb,3.15.100.v20210112-1443. The Install New Software quits after the error. Tried just the Oracle WebLogic tools and all the tools as well, but the result is the same. Any ideas?
  • Mudit J Friday, March 5, 2021
    Tried adding the server installation, the window is stalled at Define a weblogic Runtime and not going further
Please enter your name.Please provide a valid email address.Please enter a comment.CAPTCHA challenge response provided was incorrect. Please try again.