2 Installing the Oracle JDeveloper Software

Follow the steps pertinent to your operating system to install the Oracle JDeveloper software.

Note:

The Oracle JDeveloper software installation described here does not enable you to develop SOA or Business Process Management applications.

To install a version of JDeveloper pre-configured for SOA Suite or Business Process Management Suite applications, see Introducing the Quick Start Distributions in Oracle Fusion Middleware Installing SOA Suite and Business Process Management Suite Quick Start for Developers.

2.1 Understanding the Oracle JDeveloper Installation Types

The installation steps depend on the Oracle JDeveloper distribution and installer you are using.

Note:

The installation types described here do not support SOA extensions. To install a version of JDeveloper pre-configured for SOA Suite or Business Process Management Suite applications, see Introducing the Quick Start Distributions in Oracle Fusion Middleware Installing SOA Suite and Business Process Management Suite Quick Start for Developers.

You should have obtained the appropriate installer for your operating system as described in Understanding and Obtaining the Oracle JDeveloper Distributions. Depending on what distribution and installer you are using, the type of installation you will perform differs:

  • If you are installing the Oracle JDeveloper Java distribution, all you need to do is unzip the files. This process is covered in Installing the JDeveloper Java Distribution.

  • If you are using a platform-specific installer for Oracle JDeveloper Studio, the JDK version specific to this Oracle JDeveloper installation is installed automatically.

  • If you are going to run the generic installer for Oracle JDeveloper Studio, ensure that the following prerequisites are met:

2.2 Installing Oracle JDeveloper Studio

You can install Oracle JDeveloper Studio on Linux, UNIX, Mac OS X, and Windows operating systems.

Note:

The Oracle JDeveloper Studio installation described here cannot be used to develop SOA Suite or Business Process Management Suite applications. See Understanding the Oracle JDeveloper Installation Types for details.

2.2.1 Starting the Oracle JDeveloper Studio Installation Program

The steps to launch the Oracle JDeveloper Studio installation program depend on the type of installer you are using.

Using the Generic Installer

To start the generic (platform-independent) installation program:

  1. Sign in to the host system.

    Be sure the user account you use for installing Oracle JDeveloper has the required privileges. For more information, see Selecting an Installation User in Oracle Fusion Middleware Planning an Installation of Oracle Fusion Middleware.

  2. Verify that a certified JDK already exists on your system by running java -version from the command line. At the time of publication, the certified JDK for 12c (12.2.1.1) was 1.8.0_77. For more information, see the appropriate certification document on the Oracle Fusion Middleware Supported System Configurations page.

  3. Go to the directory where you downloaded the generic installation program.

  4. Launch the installation program by running the java executable from the JDK directory on your system:

    • (Linux, UNIX, and Mac OS X) /home/Oracle/Java/jdk1.8.0_77/bin/java —jar fmw_12.2.1.2.0_jdev_suite_generic.jar

    • (Windows) C:\home\Oracle\Java\jdk1.8.0_77\bin\java -jar fmw_12.2.1.2.0_jdev_suite_generic.jar

    Be sure to replace the JDK location in these examples with the actual JDK location on your system.

Using the Platform-Specific Installer

To start the platform-specific installation program:

  1. Sign in to the host system.

    Be sure the user account you use for installing Oracle JDeveloper has the required privileges. For more information, see Selecting an Installation User in Oracle Fusion Middleware Planning an Installation of Oracle Fusion Middleware.

  2. Go to the directory where you downloaded the platform-specific installation program.

  3. Launch the installer by running the following command:

    • (Linux, UNIX, and Mac OS X) ./jdev_suite_122120_linux64.bin

    • (Windows) jdev_suite_122120_win64.exe

Note:

You can also launch the installer in silent mode using a saved response file instead of launching the installer screens. For more about silent or command line installation, see Using the Oracle Universal Installer in Silent Mode in Oracle Fusion Middleware Installing Software with the Oracle Universal Installer.

When the installation program appears, you are ready to begin the installation. See the next topic for a description of each installation program screen.

2.2.2 Navigating the Installation Screens

The installer shows a series of screens where you verify or enter information.

The following table lists the order in which installer screens appear. If you need additional help with an installation screen, click Help.

Table 2-1 Oracle JDeveloper Install Screens

Screen Description

Installation Inventory Setup

On UNIX operating systems, this screen opens if this is the first time you are installing any Oracle product on this host. Specify the location where you want to create your central inventory. Make sure that the operating system group name selected on this screen has write permissions to the central inventory location.

For more information about the central inventory, see Understanding the Oracle Central Inventory in Installing Software with the Oracle Universal Installer.

This screen does not appear on Windows operating systems.

Welcome

This screen introduces you to the product installer.

Installation Location

Use this screen to specify the location of your Oracle home directory.

The JDeveloper component should always be installed in a new Oracle home. The only component in the Oracle installer that can be installed into an existing Oracle home is the Application Development Framework (ADF), if ADF has not already been installed by other Oracle Fusion Middleware products.

Ensure that the name of the directory does not contain spaces. For example, do not use C:\Program Files as the Oracle home.

For more about Oracle Fusion Middleware directory structure, see Understanding Directories for Installation and Configuration in Oracle Fusion Middleware Planning an Installation of Oracle Fusion Middleware.

Prerequisite Checks

This screen verifies that your system meets the minimum necessary requirements.

If there are any warning or error messages, refer to Verifying Your System Requirements for Installing Oracle JDeveloper.

Installation Summary

Use this screen to verify the installation options you selected. If you want to save these options to a response file, click Save and provide the location and name of the response file. Response files can be used later in a silent installation situation.

For more information about silent or command line installation, see Using the Oracle Universal Installer in Silent Mode in Installing Software with the Oracle Universal Installer.

Click Install to begin the installation.

Installation Progress

This screen shows the installation progress.

When the progress bar reaches 100% complete, click Finish to dismiss the installer, or click Next to see a summary.

Installation Complete

This screen appears when the installation is complete. Review the information on this screen.

For more information about customizing Oracle JDeveloper using the Installation Completed screen, see Customizing Oracle JDeveloper on Startup.

For more information about the installation screens that appear while installing Oracle JDeveloper, see Oracle Universal Installer Installation Screens in Oracle Fusion Middleware Installing Software with the Oracle Universal Installer.

2.2.3 Customizing Oracle JDeveloper on Startup

You can customize Oracle JDeveloper Studio on startup using options on the Installation Complete screen of the installer.

Figure 2-1 Options to Customize Oracle JDeveloper Installer

Description of Figure 2-1 follows
Description of "Figure 2-1 Options to Customize Oracle JDeveloper Installer"

The following table describes the options in the Next Steps section of the Installation Complete screen:

Table 2-2 Options to Customize Oracle JDeveloper on Startup

Option Description and Action

Start JDeveloper with Default Settings

Select if you want to start Oracle JDeveloper using the default settings. All your Oracle JDeveloper projects will be saved in this default location.

Customize Settings and Then Start JDeveloper

Select to do the following:

  • Change the location where Oracle JDeveloper projects are saved

  • Change the location where Oracle JDeveloper user preferences are saved

  • Identify the file types to be associated with Oracle JDeveloper (Windows only)

Finish Installation without Starting JDeveloper

If the box to launch JDeveloper after quitting the installation wizard is checked, uncheck it. Click Finish to quit the installation wizard without starting Oracle JDeveloper.

Note:

  • During installation, a file called product.conf is created in your home directory by default. This will contain your JDeveloper preferences. Old preferences will carry over to new installations of JDeveloper unless you delete this file.

  • On Windows systems, if you are deinstalling your current version of Oracle JDeveloper to install a newer version, Oracle recommends that you reboot your system after you deinstall the software and before you begin a new installation of the software.

2.2.4 Verifying the Oracle JDeveloper Studio Installation

After you complete the installation of Oracle JDeveloper Studio, verify it was successful.

To verify that Oracle JDeveloper Studio installed successfully, you can compare the directory structure created on your to the expected directory structure shown in the following table.

Table 2-3 Directory Description for Oracle JDeveloper Home

Directory or File Description

JDeveloper Home

This directory is the Oracle home that contains the binary files and configuration files that are required to run Oracle JDeveloper.

coherence

This directory contains the Coherence product files.

em

This directory contains files used by Oracle Enterprise Manager Fusion Middleware Control.

inventory

This directory contains information about the components, feature sets, and patches installed in this Oracle JDeveloper home directory.

registry.xml

This file is located in the inventory directory. It contains the location and versions of all components currently registered with this Oracle Jdeveloper installation. Whenever you add a new plug-in or add-on, the information gets updated in this file.

jdeveloper

This directory contains the files that are needed to run the Oracle JDeveloper application. It also contains files that can be used to modify the application settings.

OPatch

This directory contains OPatch and supported files. OPatch is a tool used to patch Oracle Fusion Middleware software.

oracle_common

This directory contains the binary and library files required for Oracle Enterprise Manager Fusion Middleware Control and Java Required Files (JRF).

oraInst.loc

You may not see this file on an Windows installation. This file contains information about the inventory location of the installation.

oui

This directory contains files used by the Oracle Universal Installer, including the deinstaller program. If you need to run the Oracle Universal Installer again after the product is installed, you should do so from this directory.

wlserver

This directory contains the WebLogic Server product files.

For Windows distributions with the MAF extension installed, you may also see a folder called cfgtoollogs. This directory contains the log files for your installation and configuration transactions.

2.3 Installing the JDeveloper Java Distribution

JDeveloper Java does not require an installer. To install the Oracle JDeveloper Java distribution, all you need is an unzip tool.

You can download a free, cross-platform unzip tool, Info-Zip, available at: http://www.info-zip.org/.

Caution:

Ensure that the directory that in which you install Oracle JDeveloper does not contain spaces. For example, do not use C:\Program Files as the installation directory.

To install Oracle JDeveloper from jdev-java-122120.zip:

  1. Obtain the required JDK.

    Identify what JDK versions are certified for this release of JDeveloper on your operating system using this site: http://www.oracle.com/technetwork/developer-tools/jdev/documentation/index.html

    Obtain a certified version of JDK from the following location on OTN: http://www.oracle.com/technetwork/java/javase/downloads/index.html

  2. Unzip jdev-java-122120.zip to the target directory.

    Note:

    In this guide, in the context of the Java Edition, JDEV_HOME is used to represent the directory of the installation. For example, if you unzipped jdev-java-122120.zip into C:\jdev_install\, then JDEV_HOME refers to C:\jdev_install.

2.3.1 Specifying the JDK Location for JDeveloper Java

When you start the Java edition of Oracle JDeveloper for the first time, the jdev script prompts you to provide the location of your JDK installation if it cannot locate it.

When prompted, enter the path to the Java executable file. For example:

  • (Linux, UNIX, and Mac OS X) /home/Oracle/Java/jdk1.8.0_77/bin.

  • (Windows) C:\home\Oracle\Java\jdk1.8.0_77/bin.