CDH 3 Demo VM installation on Mac OS X using VirtualBox

Categories: Guest Hadoop

The first task is to ensure that your system is up-to-date.

This procedure has been tested on the following configuration:

  • Fully up-to-date Snow Leopard 10.6.7
  • Update or install Oracle VM VirtualBox for Mac OS X to version 4.0.8 (Virtualbox 4.0.8-71778-OSX)


  • The browser used is Safari.
  • The Demo VM has been downloaded to the default download location for Safari (i.e. the “Downloads” folder within the users home directory).
  • The Demo VM will be run from the Downloads folder.

Step 1: Download the Cloudera demo virtual machine from the ?Downloads? area of the Cloudera web site.

Downloading Cloudera's Hadoop Demo VM Screenshot

Click on the ?Download? link beside the ?Virtual Machine? section.

The file should automatically start to download. It will be saved to your ?Downloads? folder.

Step 2: Once the file has downloaded you now need to decompress it. The file that the virtual machine is contained within is a bz2 archive (specifically a bzip2 compressed archive) and can be decompressed with the finder.

Navigate to the ?Downloads? section, and either double-click on the file or right click on the file and then select ‘Open With/Archive Utility (Default). This will start the decompression/unarchiving process.

Unzipping Cloudera's Hadoop Demo VM Archive Screenshot

Step 3: When the archive utility has finished, there will be a folder named cloudera-demo-0.3.7. The contents of which are shown below:

Folder Contents Screenshot

Step 4: Start VirtualBox and create a new VM by clicking the ?New? button. The following is the first dialog for the new virtual machine.

New VM (Virtual Machine) Welcome Screen

Step 5: Once you click on the ?Continue? button you are presented with the following dialog.

New Virtual Macine Name and Operating System Capture Screenshot

Step 6: Give the new virtual machine a name, in this example we?ll be using ?Cloudera-CDH3?.

For Operating System and Version select ?Linux? and ?Ubuntu?.

Name New Virtual Machine

Step 7: Increase the base memory to 1024 MB (if possible) for better performance.

Increase the Base Memory Screenshot

Step 8: In this step we need to select the training VM file we just downloaded and extracted. Click on the second radio button ?Use existing hard disk? and then click on the file folder icon with the green ^ on the right hand side of the drop down.

Please Note: The contents of the drop down on your system will be different than that displayed here.

Cloudera's Demo Virtual Hard Disk Screenshot

Navigate to the folder where the demo VM is located, in this example it should be in the ?Downloads? folder of the user and called ?cloudera-demo-0.3.7?.

Virtual Hard Disk Selection

Step 9: Click the ?Continue? button and the following dialog is now displayed and it shows a summary of the choices made so far.

Summary of New Virtual Machine

Step 10: Click the ?Done? button to finish the creation of the virtual machine in VirtualBox 4. The following shows the newly created cloudera-CDH3 VM in the VirtualBox manager screen.

Finish Creating New Virtual Machine Screenshot

Step 11: Start the virtual machine. When the Demo VM launches you should be presented with the following login.

Virtual Machine Login

Step 12: Finally, once you have successfully logged into the Demo VM, the image below is the initial view that you should see.

Virtual Machine Running

About the author:

John Zanchetta heads up an integration test team in the mobile telecommunications space and is experimenting with CDH from a number of different perspectives. He has been hacking in various technology pools for the past ~20+ years. John can be contacted at johnzan at gmail dot com.


One response on “CDH 3 Demo VM installation on Mac OS X using VirtualBox

  1. Nate


    Thank you for this article.

    For OS X on my iMac running 10.7.3, I ended up selecting Ubuntu 64 bit, rather than the Ubuntu (32 bit?) option in VirtualBox and the instance loaded up like a charm.

    Thanks again!