View source for VirtualBox Starting DVDK Virtual Machine

= Starting the Virtual Machine =

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 == 

# 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): <br><br>[[File: Dvdk decompressed.png|600px]]<br><br>
# Start the Oracle VM VirtualBox Manager <br><br>[[File: Screenshot-Oracle VM VirtualBox Manager.png|600px]]<br><br>
# Click on Machine and select Add <br><br>[[File: VirtualBox Manager Add.png|600px]]<br><br>
# Navigate your file system and select the .vbox file previously decompressed


== Using a .ova file == 
{{ImportantMessage|text=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 [http://www.techulator.com/resources/6601-How-split-join-files-using-7-zip-free-tool.aspx here]).}}

{{ImportantMessage|text=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:
#enable such extensions at host machines's BIOS level
#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'''.
}}


# Start the Oracle VM VirtualBox Manager <br><br>[[File: Screenshot-Oracle VM VirtualBox Manager.png|600px]]<br><br>
# Click on File and select "Import Appliance", then click on "Open Virtual Application": <br><br>[[File: import-ova-01.png|600px]]<br><br>
# Navigate your file system and select the .ova file provided with the development kit: <br><br>[[File: import-ova-01b.png|600px]]<br><br>
# Click "Next" and on the next window click on "Import" <br><br>[[File: import-ova-02.png|600px]]<br><br>

== Launching the VM ==
# Now that the virtual machine is ready, launch it by clicking on the start icon: <br><br>[[File:import-ova-03.png|600px]]<br><br>
# VirtualBox will open three message windows like the following, you can click "Ok" to close them<br><br>[[File:VirtualBox Info.png]]<br><br>
# When the boot process is completed, you can login into the Ubuntu system<br><br>[[File:VirtualBox Login.png|600px]]<br><br>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).