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 preconfigured for SOA Suite or Business Process Management Suite applications, see Introducing the Quick Start Distributions in Oracle Fusion Middleware Installing Oracle SOA Suite and Business Process Management Suite Quick Start for Developers.

• Understanding the Oracle JDeveloper Installation Types
  The installation steps depend on the Oracle JDeveloper distribution and installer you are using.
• Installing Oracle JDeveloper Studio
  You can install Oracle JDeveloper Studio on Linux, UNIX, Mac OS X, and Windows operating systems.
• 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.

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 preconfigured for SOA Suite or Business Process Management Suite applications, see Introducing the Quick Start Distributions in Oracle Fusion Middleware Installing Oracle SOA Suite and Business Process Management Suite Quick Start for Developers.

You must obtain the appropriate installer for your operating system as described in Understanding and Obtaining the Oracle JDeveloper Distributions. Depending on the distribution and installer you are using, the type of installation you 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 plan to run the generic installer for Oracle JDeveloper Studio, ensure that the following prerequisites are met:

  • The required JDK must be installed.

    Identify what JDK versions are certified for JDeveloper 12c (12.2.1.4.0) on your operating system by using this site: http://www.oracle.com/technetwork/developer-tools/jdev/documentation/index.html

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

  • To streamline the installation process, the JDK that you wish to use with the product must be the one that you use to start the installer program. Make sure that the desired JDK is the first one in your systems PATH environment variable, or reference it explicitly on the command line.

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.

• Starting the Oracle JDeveloper Studio Installation Program
  The steps to start the Oracle JDeveloper Studio installation program depend on the type of installer you are using.
• Navigating the Installation Screens
  The installer shows a series of screens where you verify or enter information.
• Customizing Oracle JDeveloper on Startup
  You can customize Oracle JDeveloper Studio on startup using options on the Installation Complete screen of the installer.
• Verifying the Oracle JDeveloper Studio Installation
  After you complete the installation of Oracle JDeveloper Studio, verify that the installation was successful.

Starting the Oracle JDeveloper Studio Installation Program

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

Note:

If you are downloading the generic installer for Oracle JDeveloper Studio, rename the V998598-01.jar file to V998597-012.jar. If you are downloading specifically for the Linux X86-64 platform, rename the V998596-01.zip file to V998595-01-2.zip. For the Windows platform, change the file name from V998594-01.zip to V998593-01-2.zip.

If the installation fails to complete, check the log file for the expected file name and ensure that you have renamed the file correctly.

When the installation program appears, you are ready to begin the installation. For a description of each installation program screen, see Navigating the Installation Screens.

You can use one of the following procedures to install Oracle JDeveloper Studio:

• Using the Generic Installer
  
• Using the Platform-Specific Installer
  
• Using the Generic Installer in Silent Mode
  

Using the Generic Installer

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

1. Sign in to the host system.

   Be sure that the user account you use for installing Oracle JDeveloper has the required privileges. See Selecting an Installation User in Oracle Fusion Middleware Planning an Installation of Oracle Fusion Middleware.

2. Verify that a certified JDK 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.4.0) was 1.8.0_211. See the appropriate certification document on the Oracle Fusion Middleware Supported System Configurations page.
3. At the command line, navigate to the directory where you downloaded the generic installation program.

   Note:

   After you have downloaded the generic installer, ensure that you rename the V998598-01.jar file to V998597-012.jar before you start the installation program.
4. Start the installation program by running the java executable file from the JDK directory on your system:
   • (Linux, UNIX, and Mac OS X) /home/Oracle/Java/jdk1.8.0_211/bin/java -jar V998597-01.jar
   • (Windows) C:\home\Oracle\Java\jdk1.8.0_211\bin\java -jar V998597-01.jar

Replace the JDK location in these examples with the actual JDK location on your system.

Note:

You can also start the installer in silent mode by using a saved response file instead of using the installer screens. See Using the Generic Installer in Silent Mode.

Using the Platform-Specific Installer

To start the platform-specific installation program:

1. Sign in to the host system.

   Be sure that the user account you use for installing Oracle JDeveloper has the required privileges. See Selecting an Installation User in Oracle Fusion Middleware Planning an Installation of Oracle Fusion Middleware.

2. At the command line, navigate to the directory where you downloaded the platform-specific installation program.

   Note:

   After you have downloaded the platform-specific installer, ensure that you rename the file before you start the installation program, as given below:

   • For Linux X86-64, rename the file from V998596-01.zip to V998595-01-2.zip.
   • For Windows, rename the file from V998594-01.zip to V998593-01-2.zip.
3. Start the installer by running the following command:
   • (Linux, UNIX, and Mac OS X) ./V998595-01.bin
   • (Windows) V998593-01.exe

Using the Generic Installer in Silent Mode

To start the generic installation program in silent mode:

1. Create a Response file.
   1. Run your product graphical installer, as described in the product installation guide.
   2. For product installation, on the Installation Summary screen, click Save Response File to save the installation parameters to a response file.
      This sample shows the information that you can specify in a response file for a silent installation of JDeveloper.

      [ENGINE]
      
      #DO NOT CHANGE THIS.
      Response File Version=1.0.0.0.0
      
      [GENERIC]
      
      #Set this to true if custom installation must be done, all other required variables need to be provided. If this is set to true then variable "TYPICAL_TYPE" must be set to false as the variables are mutually exclusive.
      INSTALL_TYPE=Typical
      
      #Set this to true if you wish to skip software updates
      DECLINE_AUTO_UPDATES=true
      
      #The oracle home location. This can be an existing Oracle Home or a new Oracle Home
      ORACLE_HOME=

      To see other sample response files that can be used for silent installation, see Sample Response Files for Silent Installation and Deinstallation in Oracle Fusion Middleware Installing Software with the Oracle Universal Installer.

2. Set the ORACLE_HOME variable in the response file to the location of your Oracle home directory.
3. At the command line, navigate to the directory where you downloaded the generic installation program.

   Note:

   After you have downloaded the generic installer, ensure that you rename the V998598-01.jar file to V998597-012.jar before you start the installation program.
4. Start the installation program in silent mode using the saved response file by running the java executable file from the JDK directory on your system.
   • (Linux, UNIX, and Mac OS X) /home/Oracle/Java/jdk1.8.0_211/bin/java -jar V998597-01.jar -silent -responseFile <FULL_PATH>/<FILE_NAME>
   • (Windows) C:\home\Oracle\Java\jdk1.8.0_211\bin\java -jar V998597-01.jar -silent -responseFile <FULL_PATH>/<FILE_NAME>
   • Replace the JDK location in these examples with the actual JDK location on your system.
   • Replace <FULL_PATH> with the full path to the location of the response file.
   • Replace <FILE_NAME> with the name of the response file.

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

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. Install the JDeveloper component 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 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 that 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 for a silent installation. For more information about silent 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%, 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.

Customizing Oracle JDeveloper on Startup

You can customize Oracle JDeveloper Studio on startup using options on the Installation Complete screen of the 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 are saved in the 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 option to start 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. This file contains your JDeveloper preferences. Old preferences carry over to new installations of JDeveloper unless you delete this file.

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

Verifying the Oracle JDeveloper Studio Installation

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

To verify that Oracle JDeveloper Studio installed successfully, you can compare the directory structure created on your 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 in this file is updated.
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	This file contains information about the inventory location of the installation. You may not see this file on a Windows installation.
oui	This directory contains files used by the Oracle Universal Installer, including the uninstaller 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 directory called cfgtoollogs. This directory contains the log files for your installation and configuration transactions.

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, at: http://www.info-zip.org/.

Caution:

Ensure that the directory 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_122140.zip:

1. Obtain the required JDK.

   Use the following site to identify what JDK versions are certified for this release of JDeveloper on your operating system: 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_122140.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_122140.zip into C:\jdev_install\, then JDEV_HOME refers to C:\jdev_install.

• 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.

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_211/bin.

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