Installation/VirtualBox

Introduction

Running through a virtual machine (in this case Virtualbox) allows you to use Paparazzi from many different operating systems, including Windows. It is also good way to 'get your feet wet' with Paparazzi without having to get things up and running yourself.

Installation

1. Download the Virtualbox installer for your host OS from https://www.virtualbox.org/wiki/Downloads and install.
   1. If you plan to program autopilots, also download the VirtualBox Extension Pack on the same page. This gives the virtual Linux machine access to your computer's USB ports.
2. Download the Paparazzi virtual machine hard disk image from a secret location. Decompress the file to a convenient place - a good place is a folder called 'VirtualBox VMs' in your user folder (Linux, MacOS) or the My Documents folder (Windows).
3. Open Virtualbox
4. To enable USB support, install the VirtualBox Extension Pack by going to File->Preferences and clicking Extensions. Hit the 'add package' button widget (diamond w yellow triangle) on the right and choose the Extension Pack file. Click OK to close settings.
5. Choose 'Add..' from the Machine menu and choose the file 'Ubuntu 12 64bit.vbox' from inside the Ubuntu 12 64bit folder you downloaded in step 3.
6. A new VM should appear in the left column of the VM manager.
7. Hit the big green start arrow and it should start booting. If you are running Virtualbox in Windows, MAKE SURE TO READ THE POPUPS that tell you about which key lets you jump OUT of the virtual machine - otherwise you can be 'stuck' inside since Windows hides Virtualbox the menu bar.
   1. In Windows 7, the default host key to 'escape' from Linux is the right CTRL key, so you press for example rctrl-C to toggle scaled view on/off, rctrl-F to toggle fullscreen, etc.
8. For now you don't want to be in either of those modes since it hides the Virtualbox menu bar - so if it says its entering scaled mode, follow the directions to exit it. You should now see a grey menubar along the top that has Machine, View, Devices, and Help menus.
9. Once the machine is booted up, log in with the username 'pprz' and password 'password'.
10. Once at the desktop, choose 'Install Guest Additions' from the Devices menu. Note that this is a host OS menu, not the virtual Linux OS. If you can't find this menubar, see the steps above for toggling the view.
11. Click Run on the box that comes up to install guest additions - this is driver software that allows the Linux install run faster on your specific machine.

Troubleshooting

1. (Linux/Windows host OS) If you receive an error stating that VT-x/AMD-V hardware acceleration is not operational, you may need to turn on those feature(s) in your computer's BIOS. Refer to the manual for your motherboard and look for directions relating to virtualization. For example, here is the setting in the Award BIOS.