Menu
Download and install the Oracle 12c client for Windows at IU This is document agpr in the Knowledge Base. It also installs development tools that you can use to develop applications. I use it constantly to carry out queries and such on our corporate Oracle Database 12c we run on an Oracle Solaris 11 server. I'm using the same MBP as you, but with 10.11.2 El Capitan, with no issues. Edit: just reread your message. Oracle free download - Oracle 10g, Oracle Java, Oracle JDeveloper, and many more programs. Describes last-minute features and changes that are not included in the Oracle Database Documentation Library for Oracle Database 12c Release 2 (12.2). Database Client Installation Guide for IBM AIX on POWER Systems (64-Bit).
Update: May 14, 2019This article originally contained instructions for running Oracle 12c. The Docker image that was being used was deleted by the author and so was not usable. I have updated the instructions to work again, though the image it uses now runs Oracle 18c. If you need to run 12c specifically, you’ll need to look for instructions elsewhere. Some screenshots may now be out of date.
In this post, we will go through the steps of installing Oracle 12c in a Docker container and connect to the database using SQL Developer on a Mac. This is a much lighter way of running Oracle locally compared to running a full Windows virtual machine with VMWare or Virtualbox.
1. Install Docker
- If your Mac is newer than 2010
You can simply install “Docker for Mac”.Download and install “Docker for Mac” from here (You’ll have to create a quick account to download it. Annoying, I know)
You can simply install “Docker for Mac”.Download and install “Docker for Mac” from here (You’ll have to create a quick account to download it. Annoying, I know)
- If your Mac is 2010 or older
You can still run Docker, but there will be a few extra steps. You’ll install a tool called “Docker Toolbox” which includes everything you need.Download and install “Docker Toolbox” here.
You can still run Docker, but there will be a few extra steps. You’ll install a tool called “Docker Toolbox” which includes everything you need.Download and install “Docker Toolbox” here.
2. Pull Docker image
- Open the Terminal app and run the following. If you get no errors Docker is installed correctly and running.
- Pull the Oracle image by running
3. Create container
- First we create a directory outside the Docker container to store the database
- Then we create a new container with our downloaded image
This should return a long hash string.
Scripts are disabled!
- Open Kitematic and find the container we just created.
- Click the “Start” button. The first time you start the container, it will take a 5-10 minutes for the database to build. Just wait until the log reads: DATABASE IS READY TO USE!
Oracle Database 12c Download
4. Install SQL Developer
- Head to this page, click the Agree button and hit Download. You’ll have to create a quick account to continue through the download (very annoying, I agree).
- Unzip, drag the app into the Applications folder, and fire it up
5. Connect to Oracle database
- In SQL Developer, click the green plus button to create a new connection.
- If your Mac is 2010 or older: Get the IP address of your Oracle container by opening Kitematic and switching to the Settings and then Hostname / Ports. Use this in the next step for Hostname.
- The default credentials to connect are as follows:
- Connection Name: Whatever you want. I suggest “Docker - Oracle System”
- Username: system
- Password: Password1
- Hostname: localhost
- Port: 1521
- SID: xe
- When you’ve filled all that out, hit “Test”. If the message in the lower-left corner reads “Status: Success”, you’ve done it correctly. Hit Save and then Connect. If you didn’t get a success message, double-check your IP address and username/password combination.
6. Creating new databases
- In Oracle 12c, users and databases are essentially the same thing. So to create a new database, we’ll create a new user with the following SQL queries, assuming we want to create a database with name “SALES” and password “password”. Execute the following in a SQL worksheet
Change SALES to whatever database name you want
Potential Problems
IO Error: The Network Adapter could not establish the connection
This means that you are trying to connect with SQL Developer, but your Docker container is stopped. Open Kitematic, select your Oracle container, and click “Start”. When the logs read “Database ready to use. Enjoy! ;)”
This chapter describes how to install the Oracle JDeveloper Studio software.
This chapter contains the following sections:
2.1 Understanding the Oracle JDeveloper Installation Types
Before you run the generic installer, ensure that the following prerequisites are met:
- You must have the required JDK installed on your system. You can obtain the specific version of JDK from the following location on OTN:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
. - To streamline your installation process, the JDK you wish to use with the product should be the one you use to start the installer program. In that case, be sure the desired JDK is the first one in your system
PATH
, or reference it explicitly on the command line.Note:The JDK version specific to the Oracle JDeveloper installation is installed automatically when you use the platform-specific installer.
![Mac Mac](/uploads/1/3/4/6/134624637/589545298.jpg)
2.2 Installing Oracle JDeveloper Studio on Various Platforms
![Oracle Oracle](/uploads/1/3/4/6/134624637/623883032.jpg)
This section describes how to install Oracle JDeveloper Studio on various platforms.
It contains the following topics:
2.2.1 Starting the Installation Program
Depending on the type of installer you are using, you can begin the installation program in one of the following ways:
Launching the Generic Installer on Linux or UNIX Systems
To launch the platform-independent installer on your hosted Linux or UNIX machine, follow these steps:
- Log in to the host computer where you want to install Oracle JDeveloper.Be sure the user account you use for installing Oracle JDeveloper has the required privileges. For more information, see 'Selecting an Installation User' in Planning an Installation of Oracle Fusion Middleware.
- Ensure that a certified JDK exists on the system on which you are about to install Oracle JDeveloper.For more information, see the appropriate certification document for 12c (12.1.2) on the Oracle Fusion Middleware Supported System Configurations page.
- Go to the directory where you downloaded the installation program.
- Launch the installation program by invoking
java -jar
from the JDK directory on your system, as shown in the example below:For example:Be sure to replace/home/Oracle/jdk7_15/jdk1.7.0_15
in this example with the location of the JDK on your system.
When the installation program appears, you are ready to begin the installation. See Section 2.2.2 for a description of each installation program screen.
Launching the Generic Installer on Windows
To launch the platform-independent installer on your Windows machine, do the following:
- Log in to the host computer where you want to install Oracle JDeveloper.Be sure the user account you use for installing Oracle JDeveloper has the required privileges. For more information, see 'Selecting an Installation User' in Planning an Installation of Oracle Fusion Middleware.
- Ensure that a certified JDK exists on the system on which you are about to install Oracle JDeveloper. For more information, see the appropriate certification document for 12c (12.1.2) on the Oracle Fusion Middleware Supported System Configurations page.
- Using command prompt, navigate to the directory where you downloaded the installation program.
- Launch the installation program by invoking
java -jar
from the JDK directory on your system, as shown in the example below:For example:Be sure to replacehomeOraclejdk7_15jdk1.7.0_15
in this example with the location of the JDK on your system.
When the installation program appears, you are ready to begin the installation. See Section 2.2.2 for a description of each installation program screen.
Launching the Generic Installer on Mac OS
To launch the platform-independent installer on your Mac OS, follow the instructions listed in 'Launching the Generic Installer on Linux or UNIX Systems'.
Launching the Platform-Specific Installer
To launch the platform-specific installer on Linux, follow these steps:
- Log in to the host computer where you want to install Oracle JDeveloper.Be sure the user account you use for installing Oracle JDeveloper has the required privileges. For more information, see 'Selecting an Installation User' in Planning an Installation of Oracle Fusion Middleware.
- Navigate to the location where the platform-specific installer is located.
- Launch the installer by running the following command:
To launch the platform-specific installer on Windows, follow these steps:
- Log in to the host computer where you want to install Oracle JDeveloper.Be sure the user account you use for installing Oracle JDeveloper has the required privileges. For more information, see 'Selecting an Installation User' in Planning an Installation of Oracle Fusion Middleware.
- Using the command prompt, navigate to the location where the platform-specific installer is located.
- Launch the installer by running the following command:
When the installation program appears, you are ready to begin the installation. See Section 2.2.2 for a description of each installation program screen.
You can also launch the installer in silent mode to ensure that no configuration options are displayed during the installation process. For more information, see Section A.1, 'Installing Oracle JDeveloper Studio in Silent Mode'.
2.2.2 Navigating the Installation Screens to Install Oracle JDeveloper
Oracle 12c Client Install
The installation program displays a series of screens, in the order listed in Table 2-1.
If you need additional help with any of the installation screens, click the screen name.
Table 2-1 Oracle JDeveloper Install Screens
Screen | Description |
---|---|
This screen appears 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 introduces you to the product installer. | |
Use this screen to specify the location of your Oracle home directory. Ensure that the name of the directory that you choose does not contain spaces. For more information about Oracle Fusion Middleware directory structure, see 'Selecting Directories for Installation and Configuration' in Planning an Installation of Oracle Fusion Middleware. | |
This screen verifies that your system meets the minimum necessary requirements. If there are any warning or error messages, refer to Section 1.4. | |
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. | |
This screen allows you to see the progress of the installation. | |
This screen appears when the installation is complete. Review the information on this screen. You can use this screen to customize Oracle JDevleoper. For more information about customizing Oracle JDeveloper using the Installation Completed screen, see Section 2.2.3. |
For more information about the installation screens that appear while installing Oracle Jdeveloper, see 'Oracle Fusion Middleware Infrastructure Installation Screens' in Installing with Oracle Universal Installer.
2.2.3 Customizing Oracle JDeveloper on Startup
On completing the installation, the installer displays a list of options that you can use to proceed with the product that you have installed. You can customize Oracle JDeveloper using the options listed on the Installation Complete screen of the installer. See Figure 2-1.
Figure 2-1 Options to Customize Oracle JDeveloper Installer
Description of 'Figure 2-1 Options to Customize Oracle JDeveloper Installer'
To customize Oracle JDeveloper using the installation wizard, select one of the options listed in the Next Steps section of the Installation Complete screen. Table 2-2 describes the options that you see on the Installation Complete screen of the wizard:
Table 2-2 Options to Customize Oracle JDeveloper on Startup
Option | Description and Action |
---|---|
Start JDeveloper with Default Settings | Select this option 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 this option to do the following:
|
Finish Installation without Starting JDeveloper | Select this option to quit the installation wizard without starting Oracle JDeveloper. |
Note:
- If you are reinstalling the same version of Oracle JDeveloper after deinstalling it, the system directory from the previous installation, gets associated with the new installation by default. Therefore, to reinstall the same version of Oracle JDeveloper, you must either delete the previously created system directory first, or set a new user home directory after reinstallation, as described in Section 3.6, 'Setting the User Home Directory'.
- 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.
Oracle 12c Download
2.3 Verifying Your Installation
To verify that your installation was completed successfully, you can compare your directory structure to the one described in Table 2-3.
Table 2-3 describes the directory structure that will be created on your system at the end of your Oracle JDeveloper installation.
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. |
cfgtoollogs | This directory contains the log files for your installation and configuration transactions. |
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 | 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. |
2.4 Installing the JDeveloper Java Edition
The JDeveloper Java Edition does not require an installer. To install Oracle JDeveloper Java, you need 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 you install Oracle JDeveloper in, does not contain spaces. For example, do not use
C:Program Files
as the installation directory.To install JDeveloper from
jdevjava.zip
:- Obtain the required JDK from:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
. - Unzip
jdevjava.zip
to the target directory.Note:In this document, in the context of the Java Edition,JDEV_HOME
is used to represent the directory of the installation. For example, if you unzippedjdevjava.zip
intoC:jdev_install
, thenJDEV_HOME
refers toC:jdev_install
.