Fastest way to a Virtual Machine with JDeveloper 12.1.3 and Oracle Database XE 11gR2 – on Ubuntu Linux 64 bit

1

In a previous article I have explained in quite a bit of detail how to create the Vagrant and Puppet scripts for stamping out a Virtual Box VM with Oracle Database XE 11gR2 and JDeveloper 12.1.3 (with ADF 12.1.3) on top of Ubuntu (64bit Linux): http://technology.amis.nl/2014/07/29/creating-automated-jdeveloper-12-1-3-oracle-xe-11gr2-environment-provisioning-using-vagrant-and-puppet/. If you want to learn a little more about Vagrant and Puppet, that might be an interesting read. However, if you do not need to go into the mechanics, and just want to get going as quickly as possible with a VM with said contents, the article you are reading now is what you need. Following the shortest route to a running VM – that is all we care about. Not about what has gone into the scripts and tools we indirectly make use of.

The process can be visualized like this:

image_thumb.png

The steps are (described for Windows 7 – but basically the same on any platform):

1. Download Vagrant

Download the installer for Vagrant from https://www.vagrantup.com/downloads.html (the latest version at the time of writing is 1.6.3)

image

For Windows this is a simple Windows installer (154 MB):

SNAGHTML95b7ff9

2. Install Vagrant on your local file system

Run the msi file downloaded in the previous step:

SNAGHTML96c5310

And click your way through the simple, straightforward and well known steps:

SNAGHTML96cb79c

SNAGHTML96cc717

SNAGHTML96cd9ad

SNAGHTML96cecb0

SNAGHTML96d00db

SNAGHTML96d277e

After clicking finish – the installation is complete.

A little unfortunate: you have to restart your system for the installation to be really done:

SNAGHTML96dea7e

After the restart, you can verify the success of installing Vagrant by opening a command line and typing: vagrant -v:

image

3. Download Oracle Virtual Box

Download the VirtualBox installer from http://www.oracle.com/technetwork/server-storage/virtualbox/downloads/index.html – the latest version at the time of writing is 4.3.1.4. Note: you need to download for the host platform (in this article that is Windows) not the guest OS.

image

SNAGHTML95e4af5

4. Install Oracle VirtualBox

Run the exe file downloaded in the previous steps:

SNAGHTML972e705

Click your way through the installer – the steps are self guided:

SNAGHTML9733c36

SNAGHTML9734ff4

SNAGHTML9735f9e

SNAGHTML973712b

SNAGHTML973822b

SNAGHTML9739241

Acknowledge the following question that pops up several times:

image

SNAGHTML974b433

 

5. Download the Oracle Database XE installer

Download the Oracle Database XE installer from Oracle Database 11gR2 XE – note: in this case we need the version for Linux 64 because the database will be installed into the Guest aka the VM, running 64 bit Linux:

image

SNAGHTML9621075

6. Download JDeveloper installer for Linux from Oracle Technology Network

Download the JDeveloper installer from Oracle JDeveloper 12.1.3 for Linux 64 bit

image

Again, because this software is installed into the Guest VM, we need to download the Linux installer – not the installer for the [Windows] host.

SNAGHTML963bbe0

7. Download the Vagrant and Puppet configuration files from GitHub

You can download the requires files from GitHub in a ZIP-archive using: https://github.com/lucasjellema/adf-12-1-3-vm/archive/master.zip or you can use Git (related tools) and clone the repository at https://github.com/lucasjellema/adf-12-1-3-vm.git.

We’ll assume a simple download as ZIP file:

SNAGHTMLc35fd

Extract the content from the zip file to any directory you fancy, for example c:\temp:

image

8. Move the installation resources for JDeveloper and Oracle Database XE to staging directory

Copy the installation resources for JDeveloper and Oracle Database XE – that were downloaded in steps 5 and 6 to the files directory under the adf-12-1-3-vm-master directory

image

9. Create the VM using Vagrant

Open a command line window and navigate to the adf-12-1-3-vm-master directory that was extracted from the GIT zip archive.

Type:

vagrant up

this will fire off Vagrant, based on the Vagrantfile you extracted from the GIT zip archive

image

The first time, the base box precise64 is not yet locally available, so it will be downloaded. This file is around 300 MB, so this action will take a while – depending on your internet connection.

Note that this step will run completely automatically – no manual intervention is required. Just sit back and relax for the next 15-20 minutes and your VM will be baked for you.

image

In VirtualBox, the new VM will be listed:

image

10. Run the VM with VirtualBox

Log in to the VM as vagrant/vagrant.

SNAGHTML265466

Note: you will be able to access APEX in a browser – either running inside the VM (at http://localhost:8080/apex) or in the host, thanks to port forwarding: http://127.0.0.1:8888/apex. To login to the (internal) administration page for APEX, use admin/oracle as the credentials.

Run JDeveloper: to run JDeveloper, click on the top icon on the desktop and type jdev as search string. The JDeveloper icon appears. (note: you can drag the icon to the launcher bar on the left)

Click it and JDeveloper is started.

image

The launch image is shown:

image

You have to reply to familiar dialogs:

image

image

and finally JDeveloper’s IDE appears.

image

Perhaps create database connection

Show the Resources window (using the menu entry under Windows) and add a new IDE Connection of type Database:

image

Configure the database connection – easy enough with username and password equal to wc and the default values for Driver, Hostname and SID equal to the ones we need. Press Test Connection to enjoy the success message. Then press OK to close the dialog.

image

In the Connections Navigator, you can verify which database objects have been created in the final stages of the provisioning actions (a few tables and one user defined type):

image

Run Integrated WebLogic Server

image

Configure the WebLogic Server details:

image

And press OK to create the domain:

image

In this case, the domain configuration took very long (over 30 minutes) – I hope that does not prove typical. Note: a second attempt required about 13 minutes – more reasonable.

After creating the domain, the Integrated WLS is started:

image

And in the local Firefox browser, the Administration Console can be opened.

image

Note: The WebLogic Console can also be accessed in a browser running on the host: using http://127.0.0.1:7501/console, you will be able to access the console – and of course other applications running on the Integrated WebLogic Server.

Summary

The Virtual Machine is not ready in a flash. First you have to perform five downloads and two installations. This takes time – but very little manual intervention. Note that two downloads and the two installations are one time only: Oracle VirtualBox and Vagrant can be reused many times, for different VMs. The downloads of the Oracle Database installer and the JDeveloper installer are unavoidable. Once all files are downloaded and a simple archive is expanded, you only have to type a simple command line instruction and the actual installation is done for you.

I have not exactly timed the whole process – as I was writing the article while going through the motions. Of course the exact timing depends on your network speed. My guess would be:

  • Download time: 40-60 minutes (no manual intervention required once started)
  • Vagrant VM creation time: 15 minutes ( no manual intervention required once started)
  • Manual actions (installations, explode archive, move files, run Vagrant): 5-10 minutes

Your personal investment is about 15 minutes. Once Vagrant and Oracle VirtualBox are installed, the effort is reduced to less than 10 [and close to 5]minutes.

Share.

About Author

Lucas Jellema, active in IT (and with Oracle) since 1994. Oracle ACE Director for Fusion Middleware. Consultant, trainer and instructor on diverse areas including Oracle Database (SQL & PLSQL), Service Oriented Architecture, BPM, ADF, Java in various shapes and forms and many other things. Author of the Oracle Press book: Oracle SOA Suite 11g Handbook. Frequent presenter on conferences such as JavaOne, Oracle OpenWorld, ODTUG Kaleidoscope, Devoxx and OBUG. Presenter for Oracle University Celebrity specials.

1 Comment

Leave a Reply