Installation Instructions: ODPi Sandbox with VirtualBox

Chloe Jackson edited this page Sep 29, 2015 · 1 revision

Overview

The ODPi Sandbox is delivered as a virtual appliance (http://hortonassets.s3.amazonaws.com/ODP/ODP_Sandbox.ova). The virtual appliance (indicated by an .ovf or .ova extension in the filename) runs in the context of a virtual machine (VM), a piece of software that appears to be an application to the underlying (host) operating system (OS), but that looks like a bare machine, including CPU, storage, network adapters, and so forth, to the operating system and applications that run on it.

This document describes importing the ODPi Sandbox virtual appliance into VirtualBox.

Prerequisites

To use the ODPi Sandbox with VirtualBox the following requirements need to be met:

Oracle VirtualBox installed

Host Operating Systems

Hardware (The newer the hardware the better)

More information for hardware requirements for VirtualBox can be found here https://www.virtualbox.org/wiki/End-user_documentation

ODPi Sandbox virtual appliance for VirtualBox

Download the correct virtual appliance file for your environment from http://hortonassets.s3.amazonaws.com/ODP/ODP_Sandbox.ova​ file extension for a virtual appliance for VirtualBox should be .ova

Procedure

The steps provided describe how to import the ODPi Sandbox virtual appliance into VirtualBox. The screenshots displayed are taken from a Mac OS X machine running the VirtualBox 4.3.x software.

  1. Open the Oracle VM VirtualBox Manager

    You can do so by double clicking the icon:

    ![]
    (https://lh4.googleusercontent.com/MmhFOtc0cXQBLxmivhKnLvlAQiVmGjPVXaeH9Fo8MtUY7motfHHvO2v_qzhag3Hg7lY7QTOE63faOzHQpU7eaBI3Nxr73u-eocKmRe7ETGJFbWYL4s7rbmw90JpZlmNCc3i_NkGZtcnbTKXG)

    On a Mac OS X machine, by default the application is installed within the Applications folder, hence the icon to
    launch the application can be found there.

    The Oracle VM VirtualBox Manager window opens.

  1. Open the Preferences dialog window.

    Select VirtualBox->Preferences… from the menu bar while the Oracle VM VirtualBox Manager application is in focus.

    ![] (https://lh5.googleusercontent.com/t4Se7iSrMdMNfPe49JKO7AiAid4sioxLuKXOvAJgAsDHsxTD9Mw5W_EUcOi23c_pf_9jOPmlpysDv6dexxihPTL_x6fLyXoo4UcQOcRrKWvrDk1tjiKp8bO_62Ps9INQbOgRuCET68B9NFpG)

  2. Uncheck Auto-Capture Keyboard within the Preferences dialog window.

Select the Input icon button from the top of the window first to get to the window containing the Auto-Capture Keyboard checkbox.

![] (https://lh4.googleusercontent.com/P5EFp_RVgshnTVahSyacdsw75pyrT9uWdojpBUBjdd_jCuVv9apWxXIiMxpFwcdaMx9zY4TMELlmZcMQmxjZMnGhS3P0-o0TjwPn8Y9n6aIRTX5FXDHJd3H86cRVkk8SXg4hrpM3NdpwW0Vm)

Click the OK button once done. This will close the Preferences window.

  1. Open the Import Appliance window.

    Select File->Import Appliance… from the menu bar while the Oracle VM VirtualBox Manager application is in focus.

The Appliance to Import dialog window will then display allowing to select the virtual appliance to import.

  1. Click on the folder icon

that will open a file dialog window. Select the virtual appliance file that you downloaded as a prerequisite. After selecting the file click the Open button.

Application settings are now displayed.

  1. Modify Appliance Settings as needed.

    Within the Appliance Settings section you may wish to allocate more RAM to the virtual appliance. Setting 8GB of RAM to the ODPi Sandbox virtual appliance will improve the performance. Make sure you have enough physical RAM on the host machine to make this change. To make the change, click on the specific value to modify and make your edits. Once finished configuring, click Import.

Progress of the Import

  1. Once the import finishes, you are brought to the main Oracle VM VirtualBox Manager screen. From the left hand pane, select the appliance you just imported and click the green Start arrow.

A console window opens and displays progress bar for bootup.

Once the virtual machine fully boots up, the console displays the login prompt.

Note: If you would like to access the shell as root, login: root, password hadoop.

  1. Open your browser and go to http://127.0.0.1:8080 and get the Ambari login prompt.

User: admin

Password: admin

Enter those credentials and click “Sign In”. You should be greeted with the Ambari dashboard where you can see the services that are running in your singled node ODPi sandbox.

That’s it, you now have a running ODPi single node cluster.