Cloudera Tutorials

Optimize your time with detailed tutorials that clearly explain the best way to deploy, use, and manage Cloudera products. Login or register below to access all Cloudera tutorials.

Cloudera named a leader in 2022 Gartner® Magic Quadrant™ for Cloud Database Management Systems Get the report

Ready to Get Started?




As of January 31, 2021, this tutorial references legacy products that no longer represent Cloudera’s current product offerings.

Please visit recommended tutorials:



This tutorial walks through the general approach for installing the Hortonworks Sandbox (HDP or HDF) onto VirtualBox on your computer.



Import the Hortonworks Sandbox

Start by importing the Hortonworks Sandbox into VirtualBox: https://www.cloudera.com/downloads/hortonworks-sandbox.html?utm_source=mktg-tutorial

  • Open VirtualBox and navigate to File -> Import Appliance. Select the sandbox image you downloaded and click Open.

You should end up with a screen like this:

Appliance Settings

Note: Make sure to allocate at least 10 GB (10240 MB) of RAM for the sandbox.

Click Import and wait for VirtualBox to import the sandbox.

Start the Hortonworks Sandbox

Once the sandbox has finished being imported, you may start it by selecting the sandbox and clicking "Start" from the VirtualBox menu.


A console window opens and displays the boot process. This process take a few minutes. When you see the following screen, you may begin using the sandbox.


Welcome to the Hortonworks Sandbox!

Enable Connected Data Architecture (CDA) - Advanced Topic


  • A computer with minimum 22 GB of RAM dedicated to the virtual machine
  • Have already deployed the latest HDP/HDF sandbox
  • Update virtual machine settings to minimum 22 GB (22528MB)

Hortonworks Connected Data Architecture (CDA) allows you to play with both data-in-motion (CDF) and data-at-rest (HDP) sandboxes simultaneously.

HDF (Data-In-Motion)

Data-In-Motion is the idea where data is being ingested from all sorts of different devices into a flow or stream. While the data is moving throughout this flow, components or as NiFi calls them “processors” are performing actions on the data to modify, transform, aggregate and route it. Data-In-Motion covers a lot of the preprocessing stage in building a Big Data Application. For instance, data preprocessing is where Data Engineers work with the raw data to format it into a better schema, so Data Scientists can focus on analyzing and visualizing the data.

HDP (Data-At-Rest)

Data-At-Rest is the idea where data is not moving and is stored in a database or robust datastore across a distributed data storage such as Hadoop Distributed File System (HDFS). Instead of sending the data to the queries, the queries are being sent to the data to find meaningful insights. At this stage data, data processing and analysis occurs in building a Big Data Application.

Update Virtual Machine Memory

VirtualBox Manager -> Settings


System -> Motherboard -> Base Memory -> OK


Run Script to Enable CDA

The sandbox comes prepackaged with the script needed to enable CDA. Assuming you have already deployed the HDP sandbox, you need to SSH into Sandbox VM using password hadoop:

  • Issue command: ssh root@sandbox-hdp.hortonworks.com -p 2200

Note: if you originally deployed HDF sandbox, replace sandbox-hdp with sandbox-hdf in the ssh command above.

  • Run bash script:
cd /sandbox/deploy-scripts/
sh enable-vm-cda.sh

The script output will be similar to:


Further Reading

Your form submission has failed.

This may have been caused by one of the following:

  • Your request timed out
  • A plugin/browser extension blocked the submission. If you have an ad blocking plugin please disable it and close this message to reload the page.