Emulator image files

Other virtual machines

This is a quick guide to the locations of various forms of Sugar software that can run in QEMU emulation or VMware or VirtualBox virtualization.

You can download installation images (.iso files) for Linux distributions that support Sugar and create your own bootable images with Sugar installed.

See VirtualBox, VMware, or QEMU for more information on how to run an image, and Supported systems for more information on what is available.

wikipedia: Comparison of platform virtual machines - Very nice comparison of features of Virtual Machines platforms

VirtualBox

These appliances were built using VirtualBox 4 and may not work on VirtualBox 3.x.
Use Oracle VM VirtualBox 3.2_10.8-64453 or later. Some appliances have multiple hard disc controllers and the earlier Sun VirtualBox 3.1 version does not support them. Upgrade to version 4.x.

Download: http://www.oracle.com/technetwork/server-storage/virtualbox/downloads/index.html

• VirtualBox-4.0 is OSE version until you add: Oracle VM VirtualBox Extension Pack
• Support for Windows, Mac OS X, Solaris, and GNU/Linux

• VMware Workstation xxx.vmdk Hard Disks will work as "existing Disks" in VirtualBox
• VirtualBox Manual
• VBoxManage command line tool for VirtualBox for advanced users

• When making a new VM, to clear the Sugar Journal of old entries and to avoid identity conflicts among copies of the VM, enter the command rm -rf ~/.sugar in the Terminal activity. Then shutdown the VM. This will clear all Learner information on the VM and let you start with a fresh install. Skipping this will result in collisions in the Neighborhood view of the Jabber network between separate copies of the appliance. Verify the presence of the .sugar directory by entering ls -a in Terminal.
• When cloning a customized VM, in order to keep the Journal and installed .xo Activities, use rm ~/.sugar/default/owner.key* in the Sugar Terminal, and then shutdown the VM. This leaves the Journal entries and removes only the previous Learner's identity key files.
  

Trisquel-5.0-sugar

RECOMMENDED

• Sugar Desktop ONLY

Trisquel 5.0 is based on the previous Ubuntu release, 11.04 Natty Narwhal.

Sugar 0.94.1

• More Info: TOAST
• download and import 2 files:
  1. http://people.sugarlabs.org/Tgillard/Trisquel_5-Sugar-disk1.vmdk 540M
  2. http://people.sugarlabs.org/Tgillard/Trisquel_5-Sugar.ovf 12K

autologon

starts at color selection

use <==(Back) to change name

Auto logon

enter password on restart

User = sugar

password = sugaruser

4-GB Virtual Box hard disc

English and English keyboard

USA-Los Angeles (Pacific timezone)

Sugar on a Stick v3 Mirabelle

Sugar 0.88.0

firstboot has not yet run; so a new user name and password will be set for the gdm login on startup for the first time

How Built:

root=sugarroot

8-GB Virtual Box hard disc

English and English keyboard

USA-Los Angeles (Pacific timezone)

download and import 2 files:

http://download.sugarlabs.org/images/VirtualBox/Fedora-13-i686-Live-SoaS-sugaruser.vmdk 533M
http://download.sugarlabs.org/images/VirtualBox/Fedora-13-i686-Live-SoaS-sugaruser.ovf   12K

• Note1: Use Oracle VM VirtualBox 3.2_10.8-64453 or later. Some appliances have multiple hard disc controllers and the earlier Sun VirtualBox 3.1 version does not support them. On a Mac this did not work with VirtualBox 4.0 for me. VirtualBox 3.2.12 was fine [1]
• Note2: All appliances were built on a MacBook Air with Oracle VM VirtualBox (3.2.10-r66523) and then tested on a Ubuntu installation on an Acer Aspire One Netbook imported into VirtualBox (3.2.10 r66523).
• Note3: Set the control panel Frame "Edge" slider to far left for easier access to the Sugar Frame.

• VMware Player Version

Soas-v3-Mirabelle.zip Download

Sugar on a Stick v4 Mango Lassi

NOT Recomended for use with jabber.sugarlabs.org

Sugar 0.90.1

Note Sugar 0.90.x is buggy, use a version of SoaS with the 0.88.1 version.

user=sugar

password=sugaruser

root=sugarroot

How Built:

8-GB VirtualBox hard disc

English and English keyboard

USA-Los Angeles (Pacific timezone)

download and import 2 files:

http://download.sugarlabs.org/images/VirtualBox/Fedora-14-i686-Live-SoaS-2.ovf 12K
http://download.sugarlabs.org/images/VirtualBox/Fedora-14-i686-Live-SoaS-2-disk1.vmdk  606M

had to modify the .ovf to get the image running on a X60 with ubuntu maverick:

http://people.sugarlabs.org/dogi/virtualbox/Fedora-14-i686-Live-SoaS-2.1.ovf 12K

• Note, this appliance has 1024x768 display resolution as VirtualBox extensions were compiled into the kernel.

To Update Sugar

Sugar update does not work in control panel

• In root sugar-terminal:

yum groupinstall sugar-desktop

(install 9 packages, Upgrade 10 packages) 02/02/2011 satellit

Sugar on a Stick v5 Coconut-RC3

sugar 0.92.1

this is the RC3 version; for testing only at this time

Nightly compose .iso no longer available

see this for a later (Beta).iso: http://wiki.sugarlabs.org/go/Community/Distributions/Fedora-SoaS#Soas-v5-Coconut_Beta

user=sugar

password=sugaruser

root=sugarroot

How Built:

liveinst in root terminal to VirtualBox HD

8-GB VirtualBox hard disc

English and English keyboard

USA-Los Angeles (Pacific timezone)

Cleared of Identity- starts at click to change color after gdm login

Etoys fixed so it starts

sub-menus work on activities

download and import 2 files:

http://download.sugarlabs.org/images/VirtualBox/Soas-v5_RC3_Live_CE.ovf  12.5KB
http://download.sugarlabs.org/images/VirtualBox/Soas-v5_RC3_Live_CE-disk1.vmdk  621 MB

• Login at gdm: sugaruser

TO UPDATE

sugar-terminal
su
password: sugarroot
yum update

• Problems: f1 Neighborhood does not see Jabber

f15-Gnome3-Ver3.0.0-Virtual Box-Appliance

• download these 2 files and import them:

http://download.sugarlabs.org/images/VirtualBox/F15-gnome3_Desktop_sugar_cl-disk1.vmdk

http://download.sugarlabs.org/images/VirtualBox/F15-gnome3_Desktop_sugar_cl.ovf

Starts in gnome3 fallback mode as VirtualBox does not support hardware acceleration

user=sugar

password=sugaruser

root=sugarroot

Cleared of sugar identity' starts on select color by clicking on XO icon

use <== arrow to write your custom name then ==> to finish

• Sugar-emulator is in Activities/Education/Sugar

enter user password for keychain (sugaruser) on time and cancel until pop-up finishes (this is a bug in keychain in f15)

Surf-115 is the browser as Browse-120 does not start (known bug)

f14-SoaS Mango Lassi

• download these 2 files and import them:

http://download.sugarlabs.org/images/VirtualBox/Fedora_14_SoaS.ovf

http://download.sugarlabs.org/images/VirtualBox/Fedora_14_SoaS-disk1.vmdk

user=sugar

password=sugaruser

root=sugarroot

• firstboot has not yet been run.

Sugar on a Stick 4 (Mango Lassi)

sugar: 0.90.1

• Bugs:

Control Panel/Software Update does not work.

Delay in start (edit to uncheck floppy disk)

Trisquel On A Sugar Toast

Older versions

Trisquel On A Sugar Toast/Virtual machines/Archive

openSUSE-Sugar-11.3

Reference links: openSUSE-Sugar-11.3.i686-1.0.0-Build6.3.iso Uploaded 26 September 2010

download and import 3 files:openSUSE_sugar.ovf openSUSE_sugar.ovf openSUSE_sugar.mf openSUSE-Sugar-11.3.vmdk

8-GB VirtualBox hard disc

English and English keyboard

USA-Los Angeles (Pacific timezone)

Autologin- user=sugar password=sugaruser

Ready to auto-configure to your hardware on first booting.

note choose /dev/sda2 when prompted to do so on first run

• Note: The above appliances were built on a MacBook Air with Oracle VM VirtualBox (3.2.10-r66523) then tested on a Ubuntu installation on an Acer Aspire One Netbook imported into VirtualBox (3.2.10 r66523)

Some Suggestions on Using VirtualBox

• Export your appliances to an external USB hard disk

  This functions like the Mac Application "Time Machine"

  Save each exported Appliance in a folder marked with the name and date of export.

  You can then import this Appliance to restore the state of the Appliance on that date.

• Run an Existing VirtualBox Appliance from an external USB Hard Drive

  Portable, Individual Copy for Student, Move between separate Computers.

  1. copy-paste the xxxx.vmdk file from /(User)/Virtualbox/HardDisks/xxxx.vmdk to a Folder on an external USB HD
  2. Menu: Machine>New>continue>Name>Operating System>Version/Memory/Continue>Use existing hard disk>[chose xxxx.vmdk on an External USB HD]> Start.

• Note Running from a USB Memory Stick Crawls, VERY slowly - not practical.

• Testing of appliance running from an external USB Hard Disk

Appears to depend on the Speed of the Host Machine: (needs farther testing)

1. Very Slow - Fedora-13-Soas/VB 3.2.12 on Windows XP SP2/ EeePC 1000HE 12/26/2010 satellit
2. Very Slow - Trisquel-3-sugar/VB 3.2.12 on Windows XP SP2/ EeePC 1000HE 12/26/2010 satellit
3. Acceptable- Fedora-13-Soas/VB 4.0 on Ubuntu 10.10 /hp Pavillion Turion 64x2 laptop 12/26/2010 satellit
4. Acceptable- Trisquel-3-sugar/VB 4.0 on Ubuntu 10.10 /hp Pavillion Turion 64x2 laptop 12/26/2010 satellit

Join IRC for Help

• Join Sugar chat room for Help in English
• Sugar chat room in Español (with translations to English)

Pida ayuda a través de este canal #sugar-es Por favor, sea cortés y hacer sus preguntas.
Los voluntarios no pueden estar en línea todo el tiempo.
Sea paciente y permanecer conectado durante varios minutos para ver su respuest 

(utilizar la función de meeting para la traducción de estos artículos)

Ask for help on either of these channels.

Please be courteous and ask your questions.

Volunteers may not be on line all of the time. Be patient and stay connected for several minutes to see their answer.

• Read the Floss Manuals first!

References

http://www.virtualbox.org/manual/ch03.html#id2727661 [Configuring virtual machines]

http://www.virtualbox.org/manual/ch03.html#id321700 [USB Support]

Oracle VM VirtualBox online Manual

UserManual.pdf

Extension Pack

Oracle VM VirtualBox Extension Pack Personal Use License

All Platforms (Windows, Mac OS X, Solaris and Linux)

• Personal Use Licensed not OSE

VMware Player

Download VMware Player (free)

• VMware Player appliance of soas-v3-Mirabelle

Compressed in .zip file

Download

This appliance is ready to run "firstboot" (agree/user name/password/tz/etc)

sugarroot is the root password.

• VMware Player appliance Trisquel-3 (NEW) 01/05/2011

Compressed in .zip file

download

User=sugar

Password=sugaruser

• VMware Player appliance Trisquel-4+sugar (NEW) 01/05/2011

Compressed in .zip file

download

User=sugar

Password=sugaruser

• VMware Player appliance Sugar on a Stick v2 (Blueberry)

Read this first.

download

• VMware Player appliance of openSUSE-Sugar

Read this first.

download

networking help

how to use

QEMU

instructions, downloads

Image installation tools

ZyX-LiveInstaller

• ZyX-LiveInstaller allows you to install Sugar from either a booted Live USB device,
• or Live CD media to a system or external disk.
• It creates an exact copy of your running live CD as a traditional (Persistent) installation on your hard-disk (or removable media such as SD or USB storage devices.

This program can be useful for installing to a virtualized hard disk. It is not included in builds after soas-v2 Blueberry, so it must be downloaded and installed to use.

In a running SoaS Terminal session or console, execute the following commands:

su

yum install zyx-liveinstaller gparted

rpm: http://people.sugarlabs.org/Tgillard/zyx-liveinstaller-0.2.4-1.noarch.rpm

EasyVMX!

Make a VirtualBox or VMware Player appliance with a burned CD of your favorite xxx.iso

• http://www.easyvmx.com/ is a web site that builds a vmx file to your specifications (free).

Works fine, runs on most platforms, and has persistence after installation. (tested with Trisquel 4.0.1 DVD 12/24/2010 satellit)

Virtual Appliance that you create Can be opened with either VirtualBox or VMware Player

VirtualBox 4.0 Download (free): http://www.oracle.com/technetwork/server-storage/virtualbox/downloads/index.html

VMware Player download (free): http://www.vmware.com/tryvmware/

(Note:VMware Workstation not needed for VMware Player to create Virtual Appliance)

specified a 8 GB Hard Drive; name; and other parameters

downloaded, in browse, the Custom vmx file as a .zip file

Decompressed the .zip file

Insert the CD of your favorite xxx.iso

Open VirtualBox 4.0 or VMware Player and point it to this vmx file

In VirtualBox Settings/specify CD Player (/dev/sr0); Start

VMware Player starts CD automatically

• EXAMPLE: soas-i386-20100926.17.iso burned to a CD

Put soas-i386-20100926.17 CD in your CD Drive

CD boots in VirtualBox-4.0 or VMware Player application

Sugar Starts

• To install to EasyVMX Hard Disk:

Open Sugar-terminal:

su
liveinst
Anaconda installer opens
Initialize all disks
Install procedes normally
reboot
firstboot
Log in to user you specified

HINT: copy all of the EasyVMX Hard Disk Files on a 2 GB USB stick.

(note runs about 10x slower on a USB stick)

Example above created a 1.4 GB set of files'

Copy-Paste all files

Sugar on a Stick in VirtualBox or VMware Player Hard Disk format with persistence

Portable (Student can take home and run on home Computer)

Run it on different Platforms

References

• Mac OS X-Boot USB with VirtualBox
• Tom van Overbeek describes how to run Sugar using QEMU
• BoxGrinder: a set of tools used for building appliances (virtual machines)
• Licensing-License types and info for exported Appliances-

Thanks

Thanks for this work satellit_, emulators are a great way to develop and test stuff. --RafaelOrtiz 17:19, 13 April 2011 (EDT)