VirtualBox

At the pilot school for SoaS in Boston all the teachers have apple laptops. We expect the most convenient way for the teachers to run Sugar will be as an emulation of their existing laptop.

These are instructions for using a copy of Sugar on a Stick configured to run in VirtualBox. It is a VirtualBox disk image created from SoaS-7 that allows saving changes and includes VirtualBox Guest Additions which allows 1024x768 resolution.

(See http://schools.sugarlabs.org/mod/forum/discuss.php?d=27 for a discussion of how the VirtualBox disk image was prepared.) --FGrose 21:17, 14 February 2009 (UTC)

First download the virtualbox disk image (19-December-2008) http://sugarlabs.org/static/soas-7-vbox.zip (md5sum 4f9f29cfc88d61e7686b872897840aae) then unzip this file and remember where you put it. While you are waiting for SoaS to download you can set up Virtual Box.

Install VirtualBox

OS X

1. Download VirtualBox for OS X from here, http://www.virtualbox.org/wiki/Downloads
2. Install it by opening the DMG.
3. Follow the instructions in the window
   1. Double click VirtualBox.mpkg
   2. If you see a warning about running a program from the internet click OK to run it.
   3. click continue until you see the license popup, click Agree.
   4. Choose location to install, probably something like Macintosh HD then click Continue.
   5. Click Continue, then Install. Enter password if required.
4. 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.

Setup a Virtual Machine for Sugar on a Stick

1. In VirtualBox click New
2. click Next.
3. Enter a name "Sugar"
4. Operating System: choose Linux
5. Version: choose Fedora
6. click Next.
7. For memory leave 256 MB then click Next.
8. Virtual Hard Disk click Existing
   1. a new window pops up
   2. click Add button in the toolbar
   3. browse to the location where you downloaded the disk image
   4. click Open
   5. click Select
9. click Next
10. click Finish
11. select Sugar in the left then click Start in the toolbar
12. after a minute or two you should see the sugar screen asking for you name. Enter your name and click Next.
13. From now on you can start VirtualBox and start the "Sugar" virtual machine.