Emulator image files

2013-02-01T13:51:40Z

Rogelio Mita: /* 75px|link=VirtualBoxVirtualBox */

<noinclude>[[Category:Virtual machine or platform emulator]]</noinclude>
{{Split|discuss={{TALKPAGENAME}}#Please maintain these pages}}
==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: '''[[wikipedia:Comparison_of_platform_virtual_machines|Comparison of platform virtual machines]]''' - Very nice comparison of features of Virtual Machines platforms
===[[File:VirtualBox.png|75px|link=VirtualBox]]'''[[VirtualBox]]'''===

{{Note/note||These appliances were built using VirtualBox 4 and may not work on VirtualBox 3.x.<br>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: [http://www.oracle.com/technetwork/server-storage/virtualbox/downloads/index.html 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'''
* [http://www.virtualbox.org/manual/ VirtualBox Manual]
* [http://www.virtualbox.org/manual/ch08.html VBoxManage command line tool for VirtualBox] for advanced users

'''Importing VM:'''
* Mac OS X: "File" -> "Import Apppliance..." + "open appliance"... + select the .ovf file.

{{Note/note|
* '''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 {{Code|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 {{Code|ls -a}} in Terminal.
* '''When cloning a customized VM''', in order to keep the Journal and installed .xo Activities, use {{Code|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.}}

{{:Sugar on a Stick/Quandong/Virtual machines}}

{{:Trisquel On A Sugar Toast/Virtual machines}}

====[[File:Gnome_icon.png]]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)

===='''openSUSE-Sugar-11.3'''====
: Reference links: [http://download.opensuse.org/repositories/Education/images/iso/openSUSE-Sugar-11.3.i686-1.0.0-Build6.3.iso openSUSE-Sugar-11.3.i686-1.0.0-Build6.3.iso] Uploaded 26 September 2010<br>
:'''download and import 3 files''':openSUSE_sugar.ovf [http://people.sugarlabs.org/Tgillard/openSUSE_sugar.ovf openSUSE_sugar.ovf] [http://people.sugarlabs.org/Tgillard/openSUSE_sugar.mf openSUSE_sugar.mf] [http://people.sugarlabs.org/Tgillard/openSUSE-Sugar-11.3.vmdk 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.
*# copy-paste the xxxx.vmdk file from /(User)/Virtualbox/HardDisks/xxxx.vmdk to a Folder on an external USB HD
*# 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)
# Very Slow - Fedora-13-Soas/VB 3.2.12 on Windows XP SP2/ EeePC 1000HE 12/26/2010 satellit
# Very Slow - Trisquel-3-sugar/VB 3.2.12 on Windows XP SP2/ EeePC 1000HE 12/26/2010 satellit
# Acceptable- Fedora-13-Soas/VB 4.0 on Ubuntu 10.10 /hp Pavillion Turion 64x2 laptop 12/26/2010 satellit
# Acceptable- Trisquel-3-sugar/VB 4.0 on Ubuntu 10.10 /hp Pavillion Turion 64x2 laptop 12/26/2010 satellit

===='''Join IRC for Help'''====

* '''[http://webchat.freenode.net/?randomnick=1&channels=sugar&prompt=1 Join Sugar chat room for Help in English]'''
*'''[http://webchat.freenode.net/?randomnick=1&channels=sugar-es&prompt=1 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 [[Sugar_Creation_Kit#Floss_Manuals| 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]
:[http://www.virtualbox.org/manual/ Oracle VM VirtualBox online Manual]
:[http://download.virtualbox.org/virtualbox/UserManual.pdf UserManual.pdf]

====Extension Pack====
:[http://www.oracle.com/technetwork/server-storage/virtualbox/downloads/index.html Oracle VM VirtualBox Extension Pack] '''Personal Use License'''
::All Platforms (Windows, Mac OS X, Solaris and Linux)
* '''Personal Use Licensed not OSE'''

==='''[[VMware]] Player'''===
[https://www.vmware.com/tryvmware/?p=player&lp=default Download VMware Player (free)]

* VMware Player appliance of soas-v3-Mirabelle
:Compressed in .zip file
:[http://people.sugarlabs.org/Tgillard/Soas-v3-Mirabelle.zip 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
:[http://download.sugarlabs.org/images/vmplayer/Trisquel3.zip download]
::User=sugar
::Password=sugaruser

* VMware Player appliance Trisquel-4+sugar (NEW) 01/05/2011
:Compressed in .zip file
:[http://download.sugarlabs.org/images/vmplayer/Trisquel-4-sugar-VMPlayer.zip download]
::User=sugar
::Password=sugaruser

* VMware Player appliance Sugar on a Stick v2 (Blueberry)
:[http://people.sugarlabs.org/Tgillard/Blueberry-vmx.txt Read this first.]
:[http://people.sugarlabs.org/Tgillard/Blueberry-vmx.tar.gz download]

* VMware Player appliance of openSUSE-Sugar
:[[VMware#openSUSE |Read this first.]]
:[http://sourceforge.net/projects/opensuse-edu/files/Sugar/openSUSE-Sugar-vmware-vmx.tar.bz2/download download]
:[[Talk:VMware#change_networking|networking help]]
:[http://old-en.opensuse.org/How_to_use_downloaded_SUSE_Studio_appliances how to use]

==='''[[QEMU]]'''===
:[[Sugar_Creation_Kit#QEMU_Virtualization|instructions, downloads]]

== Image installation tools ==
==='''[[Sugar_on_a_Stick/ZyX-LiveInstaller|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:
: {{Code|su}}
: {{Code|yum install zyx-liveinstaller gparted}}
: rpm: http://people.sugarlabs.org/Tgillard/zyx-liveinstaller-0.2.4-1.noarch.rpm

===[http://www.easyvmx.com 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

==Click for: [[Talk:Emulator image files|More Discussions]]==

==References==
* [[Mac OS X-Boot USB with VirtualBox]]
* [http://lists.laptop.org/pipermail/devel/2008-September/019643.html Tom van Overbeek describes how to run Sugar using QEMU]
* [https://fedoraproject.org/wiki/Features/BoxGrinder BoxGrinder: a set of tools used for building appliances (virtual machines)]
* [http://fedoraproject.org/wiki/Licensing Licensing-License types and info for exported Appliances-]

== Thanks ==

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

Sugar Labs - User contributions [en]

Emulator image files