VirtualBox
VirtualBox is an x86 virtualization system available as either GPL or commercial software. It runs on either Win32 or Linux host machines, allowing you to run OLPC images within the virtual machine. The following instructions are for VirtualBox OSE (Open Source Edition), which is available in packages in many Linux distributions. You can also download it and its documentation from the VirtualBox.org] Web site.
Sugar on a Stick
These are instructions for using a copy of Sugar on a Stick, configured to run in a VirtualBox® virtual appliance (a virtual machine disc image ready to run in the VirtualBox host application).
- Download http://www.sugarlabs.org/static/soas/soas-beta-1.zip (dated: 20 April 2009)
- Unzip the file you just downloaded and remember where you put it - you'll get a .vdi file.
- Follow the instructions below to get and configure the VirtualBox host application.
Please be aware of the fact that this is still beta quality and not at all ready for production use. You might want to create your own VirtualBox disc image from another snapshot or iso disc file. Instructions to do so are located here, VirtualBox/Preparing_a_disk_image.
You can also convert .img image files from qemu formats, such as qcow2, to vmdk format, which VirtualBox can open. The qemu-img command usually detects the source image format automatically.
$ qemu-img convert -O vmdk file.img file.vmdk
Install VirtualBox
OS X
- Download VirtualBox for OS X from here, http://www.virtualbox.org/wiki/Downloads
- Install it by opening the DMG.
- Follow the instructions in the window
- Double click VirtualBox.mpkg
- If you see a warning about running a program from the internet click OK to run it.
- click continue until you see the license popup, click Agree.
- Choose location to install, probably something like Macintosh HD then click Continue.
- Click Continue, then Install. Enter password if required.
- Now you can run VirtualBox by opening the Applications folder and double clicking on the icon.
Windows
- Download from http://www.virtualbox.org/wiki/Downloads.
Linux
- See http://www.virtualbox.org/wiki/Linux_Downloads
- For Ubuntu, it is available in Synaptic Package Manager, once you add the the URI, distribution & components to your 3rd-party software sources or enter the following in your /etc/apt/sources.list.
deb http://download.virtualbox.org/virtualbox/debian <distribution> non-free
- Install dkms, as well, so upgrades will update the kernel modules.
Ubuntu 8.04 Hardy: Use downloaded file from link above, Synaptic does not load Virtual Box that works [satellit 05/08/2009]
Setup a Virtual Machine for Sugar on a Stick
- In VirtualBox click New
- Click Next
- Enter a name "Sugar"
- Operating System: choose Linux
- Version: choose Fedora
- Click Next
- For memory leave 256 MB
- Click Next
- Virtual Hard Disk click Existing
- A new window pops up
- Click Add button in the toolbar
- Browse to the location where you extracted the .vdi disk image
- Click Open
- Click Select
- Click Next
- Click Finish
- Select Sugar on the left
- Click Start in the toolbar
- After a minute or two you should see the Sugar screen asking for you name
- Enter your name
- Click Next.
- From now on you can start VirtualBox and start the "Sugar" virtual machine
Mounting Drives
Hard Drives
When booting from a CD image, with a hard drive image attached, you can mount the hard drive by creating an empty directory to mount it on. The form of the command is
$ mount -t ext3 /dev/sda1 /mnt/drive
for the first hard drive. The mount point can be anywhere you have permission to create a directory, although /mnt and ~/mnt are the usual choices.
This gives you a place to save files that cannot be written to CDs.
USB
USB access is not available in the Open Source Edition of VirtualBox.
In order to access USB storage devices, the user must have access to the usbfs file system. The permissions for usbfs can be changed by editing the /etc/fstab file.
For example, most Linux distributions have a user group called usb or similar, of which the current user must be a member. To give all users of that group access to usbfs, make sure the following line is present in /etc/fstab:
# 85 is the USB group none /proc/bus/usb usbfs devgid=85,devmode=664 0 0
Replace 85 with the group ID that matches your system (search /etc/group for "usb" or similar).
After this, you should be able to mount real USB drives in the normal manner.
In order to access a directory on your real hard drive, VirtualBox needs the Guest Additions installed.
Mount the VBoxGuestAdditions.iso file
Change to the directory where your CD-ROM drive is mounted and execute as root:
sh ./VBoxLinuxAdditions-x86.run
In a 64-bit Linux guest, use VBoxLinuxAdditions-amd64.run instead.
After this installation, you can create a share in the VirtualBox GUI, and mount it in somewhat the normal way, but with the vboxsf file system type.
mount -t vboxsf [-o OPTIONS] sharename mountpoint