VMware

VMware (Workstation, Player, Server) is a commercial virtualization system that emulates hardware resources allowing one computer to host a number of x86 architecture-compatible operating systems. The Player and Server versions are distributed free of charge (gratis). It runs on either Win32 or Linux host machines, allowing one to run Sugar images within the virtual machine. A Mac version is also available, VMWare Fusion, however this is not provided free of charge. A free 30-day evaluation is available, and free licenses are available for academic instruction and research use.

Software applications, such as the Sugar platform, may be deployed as VMware Virtual Appliances, which are one or more virtual machines pre-built, packaged, installed, updated, maintained, and managed as a unit.

Pre-built SUGAR appliances

• KDE4 with Soas-strawberry Appliance
• Fedora 11-Sugar-EDU-spin Appliance
• sugarVM.zip (sugar only Appliance
• Fedora11EDUspin_XFCE

and others (look at READ ME files for each Appliance first) [1]

• openSUSE-EDU-sugar-vmx files: [2]

Minimum 4-GB USB/SD required

• Start right up after decompression of .zip files
• Using VMware Player (free download)

• please test these applications

Building a virtual appliance

from a live.iso file (No Persistence)

• Make a new Appliance in VMware Workstation (30-day, free evaluation license) with (minimal) hard disk.
• Set XXX-live.iso as CD in VMware Workstation with a 0.1 GB hard disk.
• Boot and run VMware Workstation, then shut down.
• Copy contents of the new Appliance in the VMware directory to a USB flash drive.
• Copy XXX-live.iso file to the same USB drive.
• Open this copied Appliance on the USB drive with VMware Workstation, and edit the location of the live.iso file to point to one on the USB stick, then close it.
• Start VMware Player (free downwload) and open this Appliance from the USB drive, or any other VMware Player on any PC.

  this appliance is just like a boot CD—it has no persistence—the system image is treated as a read-only file. (You are running the .iso image with VMware Player.) The appliance file size is only slightly larger than the .iso file.

Boot this Appliance from a USB boot drive/stick (see below)

• The system can be run on any PC without changing or accessing its primary hard disk.
• Use it to run Soas .iso images on PCs lacking a CD-ROM reader but with a USB port.
• Run Sugar on unbootable PC's using a VMware Player application

Appliances with Persistence

• VMware Workstation 6.5.2 with Fedora-11-i386-netinst.iso

http://mirrors.fedoraproject.org/publiclist/Fedora/11/i386/
http://fedora.osuosl.org/linux/releases/11/Fedora/i386/iso/
Fedora 11 DVD does not include Sugar Desktop

• Settings for VMware Workstation:
  1. Create a new virtual machine
  2. Typical
  3. Installer disk image file:(Fedora-11-i386-netinst.iso)
  4. Linux
  5. Other linux 2.6xx kernel 8-GiB disk
  6. Max Disk Size (GB) 8.0
  7. Split disk into 2-GiB files
  8. 512 kB memory.
• Net install with network connection
• Use entire disk
• De-select Gnome Desktop
• Customize now
• Select Sugar Desktop (Only selection entered)
• Set a root password (sugarroot?) and time zone
• When finished (about 45 min on ??-kbyte/s cable)
• Reboot, set user password (sugaruser?), shut down.
• Clone and save clone on Desktop and use to load on 4-GiB SD or USB or make DVD (3.2-Gib files)

  See note below to remove the Sugar user information and make the image ready for a new first user login. Original passwords for root and user (sugarroot/sugaruser?) entered during the install will remain and are needed for login & administration. This is required so that copies will have different identities.

Method to remove Sugar user information (from Dave Bauer VirtualBox/Preparing_a_disk_image).

1. Open Terminal
2. Terminal
3. rm -rf ~/.sugar (if distributing image)
4. su -
5. shutdown -h now

Alternatives

• Fedora-edu Nightly-Composes-(latest versions of F12(rawhide) Gnome & Sugar) [3]

(enter liveinst in terminal to install to VMworkstation disks or USB)

• SUSE Sugar Spin:(see section below)
• Soas2 .iso installed to a VM Hard disk see (F11 below)

Comments

• Run on free VMplayer loaded on any PC with 512 kB of memory (256 kB required for VMplayer).
• ADVANTAGE: No need to boot USB stick on problem machines.
• Same machine can be used by a succession of students with their own copy of Sugar.
• Students can take USB/SD drives home and run them on their own PCs.
• Disadvantage: Have to install VMplayer on PCs

Two virtual machines on different PCs, each running NAT on same network, seem to cause "collisions" in jabber (Neighborhood View gets depopulated on both ???).

• Logon screen allows user to switch session types:
  • KDE
  • Sugar
  • Failsafe

Two stick alternative

• Install VMware Player on a 2-GiB USB/SD boot stick
• Install the Sugar platform in a virtual appliance on a second 4-GiB or larger stick.

This allows VMware Player to be used by multiple students without rebooting the PC.

One 8-GiB stick with 2 partitions

Ubuntu 9.04 has a "USB Startup Disk Creator". I used a 8-GiB USB stick with 2 partitions to run a VMware Player Appliance on the Same Stick VMware Player WILL install on Ubuntu or Fedora 10, but NOT on F11 at this time. METHOD:

• In PC running Ubuntu 9.04 (or running in VMware Workstation 6.5.2.)

Start partition manager

• Delete existing partitions on USB [/dev/sdb?]

  (BE CAREFUL TO BE LOOKING AT the USB drive and not your Hard Disk.)

• Create a FAT16 2-GiB Primary Partition, set boot flag, and label it Ubuntu
• Exit partition manager
• Run USB Startup Disk Creator
• Create USB, select: /dev/sdb1 "Ubuntu"
• Select "Other" and find Ubuntu 9.04.iso (not live install) previously downloaded to Desktop
• Create live usb on first partition.
• Start partition manager again

  (BE CAREFUL TO BE LOOKING AT the USB drive and not your Hard Disk.)

• Create a FAT32 primary partition with the remaining, unformatted space on the USB drive, set boot flag, and label VM_Apps
• Exit Partition Manager

Remove and reinstall USB stick

• Two USB icons will appear
• Copy VM Appliance into VM_Apps

Re-boot PC with USB stick

• Start Firefox and download VMplayer (free) Linux xxxx.bundle
• Place .bundle file in /tmp
• su - command in /tmp
• Enter password for root
• Install bundle in /tmp ( ./ command as administrator. )

Run VMware Player

• Start VMware Player
• Choose VM_apps Icon and open VM Appliance file
• Choose Gnome or Sugar as login, enter password

  Initial Password for Sugar = sugaruser (change user name and password in live user)

  Passwoord for root = sugarroot

Have Fun (Fedora 11 0.93 0.84-2)

• Thus, with one 8-GiB USB stick loaded with Ubuntu 9.04 and VMware Player, plus the Appliance, a Student can carry the OS and a full copy of GNOME Desktop and Sugar on a single USB stick.
• It is complicated to make, but simple to use and it works.

Host operating systems

Windows XP SP2

Loads and runs VMware virtual machine in Windows XP SP2 {tested on a Dell 2350 Tower and EeePC1000 }

Appliance (packaged virtual machine) runs from USB Stick & Hard Disk on VMPlayer or VMWorkstation

Ubuntu 8.04 and 9.04

VMware Workstation 6.5.2 can make virtual machine image files in Ubuntu. VMware Player will run these virtual appliances. The appliance can be distributed by copying to a DVD or a 4-GiB SD or USB drive or by downloading prebuilt VMPlayer Appliances from Sugar Labs [[4]] or other server.

Fedora 11

VMware Player will not load in Fedora 11 beta or Fedora Preview loaded with shell command; One gets "Unable to modify kernel" error and quits.

Soas-Strawberry.iso

installed to VM Hard Disk

adapted from:
http://co.sugarlabs.org/go/Sugar_en_CM
http://wiki.sugarlabs.org/go/VMWare/Preparing_a_disk_image

• VMware Workstation 6.5.2
• Linux Redhat 5 8GB in 2GB
• Soas .iso as CD (I used Soas-Strawberry.iso for this install)
• 1024 memory
• Bridged Networking
• start VM
• select SUGAR name and color
• start SUGAR terminal:

su -
yum install anaconda
enter command:  liveinst
(enter language, time, location root pswd)
/dev/sda1
custom 
/dev/sda1  ext3  /      balance remaining
{Installer will reformat drive;install bootloader; transfer files}

• IMPORTANT must shutdown and restart to get out of live user and start on 8GB HD as root or run out of space for the following:

(Do normal Installation, shutdown and change VM CD to use physical drive-autoselect.)
*Power On Virtual Machine
*configuration setup
*log in as root (with password entered in installation)
 yum install @kde-desktop 
 yum install sugar-emulator 
 yum install system-switch-displaymanager
*StartX
*Go to User manager and enter new user
*edit /etc/initab id:3 to id:5 (to get graphic login)
*Log out of root and log in as New User
*Add sugar to KDE Menu in Education {command: sugar-emulator}
*Start sugar-emulator and log in with sugar user name and color

• HAVE FUN

with gnome-desktop I was unable to install gdm due to plymouth dependency errors 

SUGAR Installed this way in a VM Appliance Works in this initial attempt but needs some more work-

 Please add to this if you have a better solution.

This VM Application can be cloned in VMware Workstation and copied to a USB stick and run with VMware Player.

• UNTESTED: This same procedure should work for a normal HARD DISK INSTALL

Soa3-20090807.iso PRELIMINARY INSTALL FOR TESTING ONLY

Download link: [5]

1. Method used for this Install to Hard disk:

• (#sugar from session on 08/08/2009 with <sdziallas>)
• <<In sugar terminal as root>>

* yum install gparted
* yum install wget 
* wget http://www.filteredperception.org/downloads/TESTING/zyx-liveinstaller-0.1.10-1.i386.rpm
* rpm -Uvh zyx-liveinstaller-0.1.10-1.i386.rpm
* zyx-liveinstaller

• Grapical Installer Starts

* gparted
*8GB unallocated
*Make new partition (All of it;that just creates the partition scheme, you can create the partitions afterwards)

=====Create new Partitions=====:

* 1 GB ext3 for /boot
* 4 GB ext3 for /
* 1 GB swap 

(Partition #1 ext3 /boot 996.22 MiB/Partition #2 ext3 / 3.91 Gib/Partition #3 linux-swap 996.22)

• cancel partitioner (hit X in Right top corner)
• zyx-live installer behind in window
• select the data and boot partitions and start install.

Fedora Nightly Composes

http://alt.fedoraproject.org/pub/alt/nightly-composes/education/

• EXPERIMENTAL latest version of F12 (rawhide)
• Use as a Live CD or as a 4-GB Appliance for VMware Player.
• 0.86 Sugar and Gnome Desktop.
• It installs nicely in the normal manner with liveinst or anaconda from terminal
• dd install works but need to add selenix=0 to boot line or disable selenix in gnome before use.

• See the procedure above to make a VMplayer on a USB boot stick run this latest version of the Sugar platform as an Appliance.

Fedora 10

• VMplayer can be loaded in Fedora 10 and used to run a VMplayer Appliance of Sugar platform based on Fedora 11.
• The Sugar platform included in Fedora 10 is not the current version.

openSUSE

• http://en.opensuse.org/Sugar

(See: nubae and cyberorg on #irc #sugar #opensuse-edu for details.)

SUSE is building and hosting appliances at these sites for downloading.

Live CD

with a very large number (~50) of activities

• http://education.opensuse.org/download/ISOs/
• http://download.opensuse.org/repositories/Education/images/iso/
• Newest versions of live .iso can be installed to USB/SD with dd command:

dd if=openSUSE-Sugar-live-unstable.i686-0.2.0-Build5.1.iso of=/dev/sd(x)* bs=4k
104704+0 records in
104704+0 records out
428867584 bytes (429 MB) copied, 34.6956 s, 12.4 MB/s
* be careful to use correct device or you can wipe your hard disk!

Installation to hard disk

Sugar terminal:

su -

yast2 live-installer

add user

yast2 users

change networking

yast2 lan

wireless networking

yast2 lan

• su -
• yast2 lan
• need to switch networking out of network manager; edit and add wireless wlan wireless wlan0; and enter info on encrypted or open, and if WEP, SSID plus WEP Key information.
• select wired interface>edit>general>activate device>never
• ok
• yast2 lan (2nd time) select manage with Network Manager
• ok
• Reboot USB/SD
• Go to drop down box on network and delete network history. Be sure to have radio box checked.
• Reboot again, On F1 neighborhood should see circles for wireless network connections.
• Mouse over the one you want to use and enter passwords if requested on drop down box
• On reboot, to get wireless connection to connect, you may have to enter the following in terminal:

su -
rcnetwork restart

Mult-User Sugar Appliance

• yast2 users
• Add User ie: Student1, student2
• advanced>autologon no password (if you want no passwords )
• yast2 lan
• disconnect network manager
• configure interface
• restart

To switch users (Students) log out from Sugar and you are presented
with a list of users to connect to.

Prebuilt Sugar Appliance

http://education.opensuse.org/download/ISOs/ (in .zip .vmx and.tar.bz2 formats)

http://download.opensuse.org/repositories/Education/images/ (.raw format for USB Sticks)

• Run on VMware Player or VirtualBox after decompressing.

Instructions

Important, for all openSUSE Appliances:

openSUSE-Sugar-0.1.0-Build2.26.1.vmx
no password req to start
Password(root)=sugaruser
====================================
To reset SUGAR ENTIY:
(Clear out name, color, and Sugar Journal contents)
       <sugar terminal>
	rm -rf ~/.sugar
	su -
	password:sugaruser
	shutdown -h now
	restart sugar

INSTRUCTIONS ***VERY IMPORTANT!***
======================================
when you open this VM Appliance with VMPlayer for first time:
	use "I moved it"
	NO NOT click "I Copied it"
	Doing so generates a 2nd MAC id for the network card and leaves it as eth0
	not configured  (It will not work)
	clearing the /.sugar entity (see above) does not affect Mac address
	Nor does changing the color or name on the sugar control panel.

***** ALSO Do the following Right away after opening sugar for the first time:*****
*<sugar terminal>
	su -
 	Password:xxx (see above)
	yast2 sysconfig
	System>Sysconfig>Enable Sysconfig>(NO)
		(this locks out network reconfig)
	exit, shutdown, restart
 **(This seems to stop the autoconfiguration of openSUSE on restart)**

---

IF F1 Neighborhood is not connecting:

Try this First to start Network Manager:

• <sugar terminal>

su - password:xxx rcnetwork restart

=============
NETWORKING FIX:
	(Networking Fix for loss of F1 Neighborhood:)
	<sugar terminal>
	su-
	Password:xxx (see above)
	yast2 lan 
	switch to non-Network Manager control
	Delete other network cards 
	configure DHCP 4 with hardware and eth0
	exit 

once you get networking to work;
	*<sugar terminal>
	su -
	Password:xxx (see above)
	yast2 lan
	select Network Manager
	exit
		(change to network manager for wireless configration)
then:
	*<sugar terminal>
	su -
 	Password:xxx (see above)
	yast2 sysconfig
	System>Sysconfig>Enable Sysconfig>(NO)
		(this locks out network reconfig)
	exit, shutdown, restart

Image USB/SD Drives

• Details on how to use uncompresses raw file: http://en.opensuse.org/Disc_image_howtos

Latest .raw file: http://download.opensuse.org/repositories/Education/images/

• Extract raw file

Unmount the USB first, then from terminal:

 sudo dd if=/home/suse/"myappliance".raw of=/dev/sdb bs=4k

Typical Imaging Session

With raw file on ~/Desktop (BE CERTAIN your USB is sdb (the volume ID). (DO NOT use sdb1, the first partition ID). Change, if different.

XXXX:~/Desktop/$ sudo dd if=openSUSE-Sugar-liveUSB-unstable.i686-0.0.3-Build4.17.raw of=/dev/sdb bs=4k
[sudo] password for XXXX:
 463360+0 records in
 463360+0 records out
1897922560 bytes (1.9 GB) copied, 195.168 s, 9.7 MB/s

Resources

• http://www.vmware.com/
• OLPC:VMware