VirtualBox Starting DVDK Virtual Machine

From DAVE Developer's Wiki
Jump to: navigation, search
Info Box
VirtualMachine.png Applies to DVDK

This page describes the basic procedure to start the DVDK virtual machine in VirtualBox.


200px-Emblem-important.svg.png We assume that the VirtualBox package is already installed in the user's host machine 200px-Emblem-important.svg.png

Starting the Virtual Machine[edit | edit source]

The virtual machine image can be provided either in a .vbox file or a .ova file. The first is a plain virtualbox VM file, while the second is a virtual application exported in Open Virtualization Format (OVF). Please find below the instructions for both cases.

Using a .vbox file[edit | edit source]

  1. Decompress the DVDK compressed archive on your file system. You should see two files, with .vbox extension (the virtual machine definition) and .vdi extension (the actual virtual machine):

    Dvdk decompressed.png

  2. Start the Oracle VM VirtualBox Manager

    Screenshot-Oracle VM VirtualBox Manager.png

  3. Click on Machine and select Add

    VirtualBox Manager Add.png

  4. Navigate your file system and select the .vbox file previously decompressed


Using a .ova file[edit | edit source]

200px-Emblem-important.svg.png Due to file system limitation, the OVA file may be delivered as a splitted compressed 7zip archive. In this case, use 7zip compressor to rassemble the original compressed .7z file (for example, see here). 200px-Emblem-important.svg.png


200px-Emblem-important.svg.png By default, released OVA files require host CPU's hardware virtualization extensions such as Intel VT-x and AMD-V. If these extension are disabled at BIOS level, VirtualBox can't run imported virtual machine. Two options are available to solve this issue:
  1. enable such extensions at host machines's BIOS level
  2. disable the use of such extensions in the virtual machine configuration; to do that, please open Settings->System->Acceleration box in the VirtualBox Manager. Please note that this reduces the performances of the virtual machine significantly.
200px-Emblem-important.svg.png


  1. Start the Oracle VM VirtualBox Manager

    Screenshot-Oracle VM VirtualBox Manager.png

  2. Click on File and select "Import Appliance", then click on "Open Virtual Application":

    Import-ova-01.png

  3. Navigate your file system and select the .ova file provided with the development kit:

    Import-ova-01b.png

  4. Click "Next" and on the next window click on "Import"

    Import-ova-02.png

Launching the VM[edit | edit source]

  1. Now that the virtual machine is ready, launch it by clicking on the start icon:

    Import-ova-03.png

  2. VirtualBox will open three message windows like the following, you can click "Ok" to close them

    VirtualBox Info.png

  3. When the boot process is completed, you can login into the Ubuntu system

    VirtualBox Login.png

    with the credentials provided with the development kit (you can find them into the README file contained in the dvdk folder of the kit distribution).

Guest Additions Update[edit | edit source]

Once logged in, the system could suggest to update the Virtualbox Guest Additions package. You can follow the on-screen instructions to easily install the updated package.

Next Steps[edit | edit source]

  1. Check if your keyboard layout matches the Ubuntu keyboard settings. You can change the keyboard layout selecting System->Preferences->Keyboard from the top panel menu.
  2. Configure the Virtual Machine network interface: VirtualBox Network Configuration