Sugar Labs - User contributions [en]

Category:Live USB

2010-07-25T07:55:32Z

CyberOrg: install instruction for suse

<noinclude>{{TOCright}}
</noinclude>

'''This is a collection of Live USB Sugar distributions'''

[[Sugar on a Stick]] is the main Sugar Labs project page.

See [[Sugar on a Stick#Project Principles|Project Principles]] and [[Sugar on a Stick/Resources]] for a description of the technical and educational goals of the project.
* '''Sugar on a Stick creation kit''' http://people.sugarlabs.org/sdz/creation-kit/
* '''Customization-guide''' http://people.sugarlabs.org/sdz/customization-guide/
* [[Sugar on a Stick/Installation/Variations|'''Experimental installation variations''']] (Fedora-based installs: '''LiveUSB / Liveinst''' (Anaconda) / '''Virtualizations''' (VirtualBox / VMware / QEMU)

==Live USB distributions==

:* '''Fedora; How_to_create_and_use_Live_USB''' [http://fedoraproject.org/wiki/How_to_create_and_use_Live_USB]

:* [[Sugar on a Stick]] is a Fedora-based [[LiveOS image]] installation.
:* openSUSE-Sugar-Live [http://download.opensuse.org/repositories/Education/images/iso/] (dd to USB/SD), to install on hard disk, add "liveinstall" at the boot menu. '''also:http://en.opensuse.org/Live_USB_stick http://wiki.opensuse.org/SDB:Live_USB_stick'''
:* openSUSE-Edu-live-Li-f-e (Server)'''http://news.opensuse.org/2010/07/17/opensuse-edu-li-f-e-11-3-available-now/ [http://wiki.opensuse.org/openSUSE:Education-Li-f-e]''' with Sugar (dd to 4GB USB/SD):[http://en.opensuse.org/Live_USB_stick][http://lizards.opensuse.org/2009/08/13/cliced-hybrids/]
:* F11-Live-Edu F12:[http://torrent.fedoraproject.org/spins/Fedora-12-i686-Live-Edu.torrent] (dd to USB/SD [no persistence] or liveinst from root terminal [persistent]) Live USB of Gnome and Sugar Desktops
:* Trisquel-Edu [http://trisquel.info/download] (Live USB) [http://trisquel.info/en/wiki/how-create-liveusb] Trisquel 2.2
:* [[Trisquel On A Sugar Toast]], Trisquel-Sugar [http://trisquel.info/en/trisquel-sugar] Download: [http://devel.trisquel.info/] script for USB with persistence: [http://devel.trisquel.info/live-usb.sh] Trisequel 3.0, see notes.
:* Unetbootin [http://unetbootin.sourceforge.net/] windows and linux live usb creator[https://fedorahosted.org/liveusb-creator/]
:* Ubuntu-Sugar-Remix '''experimental''' not fully working at this time [https://wiki.ubuntu.com/UbuntuSugarRemix].iso burned to CD can be installed to USB or imported into Virtualbox with ovf file and then transfer vdi HD to a stick.Downloads:[http://people.sugarlabs.org/dfarning/]

==Notes==

# f12 and opensuse-edu now distribute a dual mode live.iso of Sugar-Desktop which boots into sugar as a CD or can be used to dd write to a USB/SD "stick". (Persistence is a work in progress on these.) [[Sugar on a Stick/Linux/openSUSE]], [http://lizards.opensuse.org/2009/04/28/whats-behind-lzma-compressed-livecds/], [http://git.berlios.de/cgi-bin/gitweb.cgi?p=kiwi;a=blob;f=modules/KIWILinuxRC.sh;h=6591ab5125df730800bf3dc3dde9ce875183568c;hb=HEAD], [http://alt.fedoraproject.org/pub/alt/nightly-composes/education/]
# Sugar from multiple distros is available [http://people.sugarlabs.org/Tgillard/] as a VMware Player or Virtualbox "Appliance", which can be stored on a USB/SD "Stick", and thus is transportable with (persistence) from PC to PC.
# There are "full installs" (non-compressed file structure) of Sugar, Sugar+Gnome, and Sugar+KDE on larger (4-GB+) USB Sticks, which are available for download [http://people.sugarlabs.org/Tgillard/] in compressed form, which can be expanded and written to a bootable USB/SD device with a dd command in several minutes.
# most live f12-f13 distros can be installed as a '''full install to HD/USB/SD'''. This requires a 4GB USB/SD for Blueberry v2, Mirabelle v3' or 8GB USB/SD for Gnome-sugar [http://spins.fedoraproject.org/edu/] Use command "livinst" in root terminal. These produce a normal install with Persistence.
===Trisquel notes===
: from Rubén Rodríguez Pérez on [http://www.mail-archive.com/soas@lists.sugarlabs.org/msg00025.html SoaS list]:

:* Trisquel-Edu (Live USB)
:* Trisquel-Sugar 3.0 RC (has usb-creator available as command in terminal for persistent USB)

: I will further explain the differences:
:# We are including the Sugar packages in both our 2.2 LTS version (where you can find the Trisquel Edu edition), and in our new 3.0 STS version. All our live Sugar images will be based on the STS one, as it will provide better hardware support.
:# Trisquel Edu, which is a GNOME based educational system, can run Sugar as an alternate environment, or serve it via LTSP. The Edu edition (like the Pro one) is only available in the 2.2 LTS version of the distro. It will be the recommended version for large Sugar-on-Trisquel deployments.

Category:Live USB

2010-07-24T05:16:39Z

CyberOrg: /* Live USB distributions */

<noinclude>{{TOCright}}
</noinclude>

'''This is a collection of Live USB Sugar distributions'''

[[Sugar on a Stick]] is the main Sugar Labs project page.

See [[Sugar on a Stick#Project Principles|Project Principles]] and [[Sugar on a Stick/Resources]] for a description of the technical and educational goals of the project.
* '''Sugar on a Stick creation kit''' http://people.sugarlabs.org/sdz/creation-kit/
* '''Customization-guide''' http://people.sugarlabs.org/sdz/customization-guide/
* [[Sugar on a Stick/Installation/Variations|'''Experimental installation variations''']] (Fedora-based installs: '''LiveUSB / Liveinst''' (Anaconda) / '''Virtualizations''' (VirtualBox / VMware / QEMU)

==Live USB distributions==

:* '''Fedora; How_to_create_and_use_Live_USB''' [http://fedoraproject.org/wiki/How_to_create_and_use_Live_USB]

:* [[Sugar on a Stick]] is a Fedora-based [[LiveOS image]] installation.
:* openSUSE-Sugar-Live [http://download.opensuse.org/repositories/Education/images/iso/] (dd to USB/SD), works well (11/04/2009) '''also:http://en.opensuse.org/Live_USB_stick http://wiki.opensuse.org/SDB:Live_USB_stick'''
:* openSUSE-Edu-live-Li-f-e (Server)'''http://news.opensuse.org/2010/07/17/opensuse-edu-li-f-e-11-3-available-now/ [http://wiki.opensuse.org/openSUSE:Education-Li-f-e]''' with Sugar (dd to 4GB USB/SD):[http://en.opensuse.org/Live_USB_stick][http://lizards.opensuse.org/2009/08/13/cliced-hybrids/]
:* F11-Live-Edu F12:[http://torrent.fedoraproject.org/spins/Fedora-12-i686-Live-Edu.torrent] (dd to USB/SD [no persistence] or liveinst from root terminal [persistent]) Live USB of Gnome and Sugar Desktops
:* Trisquel-Edu [http://trisquel.info/download] (Live USB) [http://trisquel.info/en/wiki/how-create-liveusb] Trisquel 2.2
:* [[Trisquel On A Sugar Toast]], Trisquel-Sugar [http://trisquel.info/en/trisquel-sugar] Download: [http://devel.trisquel.info/] script for USB with persistence: [http://devel.trisquel.info/live-usb.sh] Trisequel 3.0, see notes.
:* Unetbootin [http://unetbootin.sourceforge.net/] windows and linux live usb creator[https://fedorahosted.org/liveusb-creator/]
:* Ubuntu-Sugar-Remix '''experimental''' not fully working at this time [https://wiki.ubuntu.com/UbuntuSugarRemix].iso burned to CD can be installed to USB or imported into Virtualbox with ovf file and then transfer vdi HD to a stick.Downloads:[http://people.sugarlabs.org/dfarning/]

==Notes==

# f12 and opensuse-edu now distribute a dual mode live.iso of Sugar-Desktop which boots into sugar as a CD or can be used to dd write to a USB/SD "stick". (Persistence is a work in progress on these.) [[Sugar on a Stick/Linux/openSUSE]], [http://lizards.opensuse.org/2009/04/28/whats-behind-lzma-compressed-livecds/], [http://git.berlios.de/cgi-bin/gitweb.cgi?p=kiwi;a=blob;f=modules/KIWILinuxRC.sh;h=6591ab5125df730800bf3dc3dde9ce875183568c;hb=HEAD], [http://alt.fedoraproject.org/pub/alt/nightly-composes/education/]
# Sugar from multiple distros is available [http://people.sugarlabs.org/Tgillard/] as a VMware Player or Virtualbox "Appliance", which can be stored on a USB/SD "Stick", and thus is transportable with (persistence) from PC to PC.
# There are "full installs" (non-compressed file structure) of Sugar, Sugar+Gnome, and Sugar+KDE on larger (4-GB+) USB Sticks, which are available for download [http://people.sugarlabs.org/Tgillard/] in compressed form, which can be expanded and written to a bootable USB/SD device with a dd command in several minutes.
# most live f12-f13 distros can be installed as a '''full install to HD/USB/SD'''. This requires a 4GB USB/SD for Blueberry v2, Mirabelle v3' or 8GB USB/SD for Gnome-sugar [http://spins.fedoraproject.org/edu/] Use command "livinst" in root terminal. These produce a normal install with Persistence.
===Trisquel notes===
: from Rubén Rodríguez Pérez on [http://www.mail-archive.com/soas@lists.sugarlabs.org/msg00025.html SoaS list]:

:* Trisquel-Edu (Live USB)
:* Trisquel-Sugar 3.0 RC (has usb-creator available as command in terminal for persistent USB)

: I will further explain the differences:
:# We are including the Sugar packages in both our 2.2 LTS version (where you can find the Trisquel Edu edition), and in our new 3.0 STS version. All our live Sugar images will be based on the STS one, as it will provide better hardware support.
:# Trisquel Edu, which is a GNOME based educational system, can run Sugar as an alternate environment, or serve it via LTSP. The Edu edition (like the Pro one) is only available in the 2.2 LTS version of the distro. It will be the recommended version for large Sugar-on-Trisquel deployments.

Category:Live USB

2009-11-22T14:37:04Z

CyberOrg: change link

This page, and the notion that we should have a category for Live USB projects, is under discussion on the [http://lists.sugarlabs.org/listinfo/soas SoaS list]. There is a Sugar Labs [[Decision panels/SOAS|Decision Panel]] commissioned to review this topic. Join the conversation on the mailing list, if you would like to participate or know more.

This directory of Live USB Sugar distribution efforts. Sugar Labs has worked most, for both development and deployment, with [[Sugar on a Stick]]. People are, of course, encouraged and free to work on whatever they would like!

See [[Sugar on a Stick#Project Principles|Project Principles]] and [[Sugar on a Stick/Resources]] for a description of the technical and educational goals of the project.

''Note: Each of these projects should probably have its own page marked with the [[:Category:Live USB]] category, but for now here is a list.''

===Fedora Notes on How to Create a Live USB from a LiveCD===

http://fedoraproject.org/wiki/FedoraLiveCD/USBHowTo

* Sebastian Dziallas is calling the coming iteration of the project he is working on Sugar on a Stick, Blueberry [http://www.mail-archive.com/sugar-devel@lists.sugarlabs.org/msg08994.html]; the name of the overall project is Sugar on a Stick.
* Other distributions:
** openSUSE-Sugar-Live [http://download.opensuse.org/repositories/Education/images/iso/] (dd to USB/SD)+(2nd partition for persistence)[http://en.opensuse.org/Live_USB_stick] [http://lizards.opensuse.org/2009/08/13/cliced-hybrids/], works well (11/04/2009)
** openSUSE-Edu-live-Li-f-e (Server) [http://en.opensuse.org/Education/Live] with Sugar (dd to 8GB USB/SD)+(2nd partition for persistence)Script to automatically make 2nd partition:[http://en.opensuse.org/Live_USB_stick][http://lizards.opensuse.org/2009/08/13/cliced-hybrids/]
** F11-Live-Edu [http://spins.fedoraproject.org/torrents//Fedora-11-i686-Live-Edu.torrent] (dd to USB/SD [no persistence] or liveinst from root terminal [persistent]) Live USB of Gnome and Sugar Desktops
** Trisquel-Edu [http://trisquel.info/download] (Live USB) [http://trisquel.info/en/wiki/how-create-liveusb] Trisquel 2.2
** [[Trisquel On A Sugar Toast]], Trisquel-Sugar [http://trisquel.info/en/trisquel-sugar] Download: [http://devel.trisquel.info/] script for USB with persistence: [http://devel.trisquel.info/live-usb.sh] Trisequel 3.0, see notes.
** Sugar Tree [http://sugaronastick.com/beta-testing/making-a-stick-of-sugar/], [http://www.sugaronastick.com/wp-content/isos/soas-st-20091004-ss.iso]

==Notes==

# F12 and opensuse-edu now distribute a dual mode live.iso of Sugar-Desktop which boots into sugar as a CD or can be used to dd write to a USB/SD "stick". (Persistence is a work in progress on these.) [[Sugar on a Stick/Linux/openSUSE]], [http://lizards.opensuse.org/2009/04/28/whats-behind-lzma-compressed-livecds/], [http://git.berlios.de/cgi-bin/gitweb.cgi?p=kiwi;a=blob;f=modules/KIWILinuxRC.sh;h=6591ab5125df730800bf3dc3dde9ce875183568c;hb=HEAD], [http://alt.fedoraproject.org/pub/alt/nightly-composes/education/]
# Sugar from multiple distros is available [http://people.sugarlabs.org/Tgillard/] as a VMware Player or Virtualbox "Appliance", which can be stored on a USB/SD "Stick", and thus is transportable with (persistence) from PC to PC.
# There are "full installs" (non-compressed file structure) of Sugar, Sugar+Gnome, and Sugar+KDE on larger (4-GB+) USB Sticks, which are available for download [http://people.sugarlabs.org/Tgillard/] in compressed form, which can be expanded and written to a bootable USB/SD device with a dd command in several minutes.
# most liveo F12 distros can be installed as a "full install" to USB/SD. This requires a 4GB USB/SD for soas04 or 8GB USB/SD for Gnome-sugar [http://alt.fedoraproject.org/pub/alt/nightly-composes/education/] Use command "livinst" in root terminal. These are a normal install with Persistence.
===Trisquel notes===
: from Rubén Rodríguez Pérez on SoaS list:

:* Trisquel-Edu (Live USB)
:* Trisquel-Sugar 3.0 RC (has usb-creator available as command in terminal for persistent USB)

: I will further explain the differences:
:# We are including the Sugar packages in both our 2.2 LTS version (where you can find the Trisquel Edu edition), and in our new 3.0 STS version. All our live Sugar images will be based on the STS one, as it will provide better hardware support.
:# Trisquel Edu, which is a GNOME based educational system, can run Sugar as an alternate environment, or serve it via LTSP. The Edu edition (like the Pro one) is only available in the 2.2 LTS version of the distro. It will be the recommended version for large Sugar-on-Trisquel deployments.

Sugar on a Stick/Linux

2009-08-06T05:55:05Z

CyberOrg: /* openSUSE Sugar-Desktop on a stick */

<noinclude>{{GoogleTrans-en}}{{TOCright}}</noinclude>
== Introduction ==
This page helps you to put your [[Sugar on a Stick]] image on a USB flash drive under Linux. If you have questions, trouble, or feedback, please let us know on the [[Talk:Sugar on a Stick|SoaS talk]] page. "Sugar on a Stick" is provided in a number of variants. If you can improve these instructions, please edit the page and do so!

== Put [[Sugar on a Stick/Installation/OLPC | SoaS on an OLPC XO-1]] ==
* See [[Sugar on a Stick/Installation/OLPC]] for booting an OLPC XO-1 with SoaS images.
== Full Fedora 11 Install of Sugar and XFCE Desktops to USB ==
Uses [[wikipedia:Logical_Volume_Manager_(Linux)|Logical Volume Manager (LVM)]] layer over the file structure on the USB flash drive. Other methods on this page install a LiveUSB image that uses a compressed file system ([[wikipedia:SquashFS|SquashFS]]) to hold the system and content.

THIS IS A WORK IN PROGRESS. Please make suggestions or improvements.

* Uses Fedora 11 Net Install CD,[http://mirrors.cat.pdx.edu/fedora/linux/releases/11/Fedora/i386/iso/] so best with a fast internet connection.
* USB 2.0 recommended or install would take a excessive time using USB 1.0
* Requires 4-GB USB drive. (Tested with Cruzer Micro USB Stick, an 8-GB Toshiba USB drive works faster.)
# Boot from CD
# Enter language, time, location, root user password
# Replace existing Linux system
# Review and modify partitioning layout
# edit LVM VolGroup
# delete LV_swap (needed to fit on 4GB stick and for reduced writes to USB)
# edit LV_root (Edit LVM and increase to max size on (/dev/sda*)
# size:(change to max shown)
# yes for no swap file
# Write changes to disk '''*NOTE: Be sure this is the USB drive, or you will ruin your hard disk installation on the host PC.'''
# install boot loader Fedora/dev/mapper/VolGroup-lv_root
# enable network interface (DHCP, IPv4)
# retrieve install informtion for Fedora 11-i386
# Select customize now
## sugar-desktop and XFCE desktop / deselect gnome-desktop
## deselect other unwanted applications in categories (Games, etc)
#: Installer will reformat drive; install bootloader; transfer 957 packages (about 2 hours)
#reboot
# Configuration setup (Graphical), add user and password on first boot
# Log in User
# Select xfce or Sugar on selection bar
*''' install gnome desktop with this technique and then when in gnome, use add/remove programs to install sugar from other desktops'''

*''' you get a 8GB USB that boots either gnome or sugar (8 GB Toshiba USB)'''

* This Works well....can switch back between desktops by logging off and back on.

*''' You can also do a hard disk install of SUGAR this way ''' (not tested yet)

*''' This procedure can be used with a Windows PC if it will boot from CD'''

====Download of USB.img file====
* '''This is a work in progress'''
* DOWNLOAD Link:[[http://people.sugarlabs.org/Tgillard/]]
* requires:
* Linux system with ability to decompress archive
* 4 GB or larger USB Stick
* Familiarity with dd commands in terminal (see below)

====Duplication of USB Sticks====

'''Caution if you purchase Sandisk cruzer micro 4 GB USB you have to use Windows machine to to start the U3 program and delete the hidden U3 directory'''

'''This will make the USB a full 4GB otherwise it will be too small to use dd to copy .img file'''
*U3 partition will not be removed by formating with Partition Manager

'''CAUTION VERY DANGEROUS IF NOT ENTERED CORRECTLY:'''

*Enter Terminal
su -
<password>
(Need to be ROOT or get permission denied)
*USB to be copied to MUST be larger for this to work (not all USB Sticks are exactly the same size)
* * be certain of /dev/sd(x) for your USB Stick ( I use partition editor in Ubuntu 9.04 to identify USB)
*Note that .img file on Desktop can be compressed for distribution.

*Example of sucessful clone session:
=====Make Image from USB:=====
*8GB Toshiba USB
root@xxxxx:/home/robert/Desktop# dd if=/dev/sda* of=USB8.img
15687680+0 records in
15687680+0 records out
8032092160 bytes (8.0 GB) copied, 421.146 s, 19.1 MB/s

=====use image to write USB Clone:=====
*4GB cruzer with U3 removed
root@xxxx:/home/robert/Desktop# dd if=USB4C2.img of=/dev/sdg bs=4k
986623+1 records in
986623+1 records out
4041211392 bytes (4.0 GB) copied, 595.509 s, 6.8 MB/s

== Put SoaS as a VMware appliance onto a VMware Player stick ==

[[VMware|These instructions]] will help you put a [[Sugar on a Stick#Downloading|SoaS image]] onto a USB
stick that boots into VMware Player that then runs a VMware Virtual Appliance containing a [[Sugar on a Stick#Downloading|SoaS image]].

== openSUSE Sugar-Desktop on a stick ==

* The openSUSE version is a .raw image that is burned to a stick by the dd command. It creates a usb stick that boots sugar-desktop with 55 applications.

* '''This is a persistent live image on a stick''' (a file system is created on the stick on first boot)

* Installation of openSUSE.raw file to USB/SD: [[VMware#Image USB/SD Drives]]

* Download Link for .raw files:[[http://download.opensuse.org/repositories/Education/images/]]

* Details http://en.opensuse.org/Sugar

== Put SoaS onto a stick using Fedora and Ubuntu ==

This is known to work in Fedora and Ubuntu.

First, start downloading a SoaS <tt>.iso</tt> image from the [[Sugar on a Stick#Downloading|images]] table, then return here.

A program called UNetBootin available at http://unetbootin.sourceforge.net/ does all this magic for you... or you can do the magic yourself:

* Make sure you have the ''syslinux'' package installed on the operating system that you will use to prepare the Live USB image. It is recommended that you also have the ''isomd5sum'' package installed. The ''cryptsetup'' package is another option potentially used by the "livecd-iso-to-disk" installation script. (On Ubuntu, <code>sudo apt-get install syslinux isomd5sum cryptsetup</code> will install the packages. They are also available through the Synaptic Package Manager.)
: (On Gentoo, one needs to uncomment 'SAMPLE FILE' in /etc/mtools/mtools.conf to make syslinux work.)
:*''syslinux'' is needed to set up booting on the FAT file system of the USB disc or Live CD.
:*''isomd5sum'' is needed for the recommended verification step, which checks that the .iso file is complete after its travels. If there is a problem with the .iso file, the script will exit and provide a failure message. The verification step can be bypassed by using the <code>--noverify</code> option.
:*''cryptsetup'' is only needed for the option to provide password protection and encryption for the persistent /home/liveuser folder. It is not necessary if one applies the recommended <code>--unencrypted-home</code> option. The <code>--unencrypted-home</code> option is preferred because the reduced overhead improves robustness with the compressed ''squashfs'' file system employed by the Live USB deployment.
* Plug in a 1GB or larger USB stick into your computer.
* Download the installation script: http://download.sugarlabs.org/soas/releases/livecd-iso-to-disk.sh (23 June 2009).

* Check the USB device. In the example below the device is /dev/sdb:
: <tt>'''df -h'''</tt>
Filesystem Size Used Avail Use% Mounted on
/dev/sda1 19G 7.0G 11G 40% /
tmpfs 1.5G 0 1.5G 0% /lib/init/rw
varrun 1.5G 96K 1.5G 1% /var/run
varlock 1.5G 0 1.5G 0% /var/lock
udev 1.5G 2.9M 1.5G 1% /dev
tmpfs 1.5G 104K 1.5G 1% /dev/shm
lrm 1.5G 2.0M 1.5G 1% /lib/modules/2.6.27-11-generic/volatile
/dev/sdb1 996M 913M 84M 92% /mnt/myUSBdisc

* Unmount the drive,<br>
: <tt>sudo umount /dev/sd''b1''</tt>

* Then check to see that the partition is marked as bootable,<br>
: <tt>sudo fdisk '''-l'''</tt> ''<----that's a lowercase letter 'L' for the '''l'''ist option.''
You should see output that looks like this:
Disk /dev/sdb: 1047 MB, 1047265280 bytes
255 heads, 63 sectors/track, 127 cylinders
Units = cylinders of 16065 * 512 = 8225280 bytes
Disk identifier: 0x0008325f
.
Device Boot Start End Blocks Id System
/dev/sdb1 * 1 127 1020096 6 FAT16
The '*' under the Boot column is what you want to see.
: If not, then
:* For Ubuntu 8.10, menu: System -> Administration -> Partition Editor (GParted).
::# Select your USB device (/dev/sd''b'' for the rest of these instructions),
::# then your partition (/dev/sd''b1''),
::# then menu: Partition -> Manage Flags,
::# check the boot box,
::# and Close to mark the partition as bootable.

:* For Fedora,
::# <tt>parted /dev/sd''b''</tt>
::# toggle 1 boot
::# quit

* Also, check to see that you do not already have an existing boot loader (such as [[wikipedia:GNU GRUB|GRUB]]) in the [[wikipedia:Master boot record|MBR]] of your stick. (If you have not previously used this stick as a live boot, you can skip this step.) To be sure that the USB stick's MBR is wiped clean, overwrite it completely using:
: <tt>dd if=/dev/zero of=/dev/sd''b'' bs=446 count=1</tt>
:: (Actually, that didn't work for me. But this did:
::: <tt>lilo -M /dev/sd''b''</tt>
:::It put in a standard MBR that boots whichever partition has been called bootable. It does not install [[wikipedia:LILO (boot loader)|LILO]] as such.)
* Change mode to make the script executable.
: <tt>chmod +x livecd-iso-to-disk.sh</tt>
* Run it as root, making sure to pass the correct USB device and to set overlay and home size appropriately, depending on the stick size.
: <tt>sudo ./livecd-iso-to-disk.sh --overlay-size-mb 300 --home-size-mb 160 --delete-home --unencrypted-home soas-strawberry.iso /dev/sd''b1''</tt>
::The ''livecd-iso-to-disk'' installation has the advantage over the ''liveusb-creator'' installation method by allowing a persistent /home/liveuser folder with the <tt>--home-size-mb ''NNN''</tt> option. This feature would allow you to update the OS image while keeping the user files (by running the script against your existing installation but <u>leaving out</u> the --home-size-mb NNN option).
::* The <code>--delete-home</code> option is used to avoid an error message while requesting both a new home (with <code>--home-size-mb</code>) and a persistent home (indirectly with <code>--unencrypted-home</code>). You wouldn't use the --delete-home option on an upgrade of the operation system only.
:Depending on the size of your USB stick, you may have to decrease <code>--overlay-size-mb</code> and <code>--home-size-mb</code> values (for example, for a 1-GB stick, use 200 for each).
:* If you get an error about udevinfo, you have the new version of udev where "udevadm info" is the proper command. :Create an executable file called udevinfo somewhere in your path with the following contents:
:::<code>#!/bin/bash</code><br>
:::<code>udevadm info $*</code>
:* Watch out for errors in the output of the script, the script seems to ignore them! (and say all is fine on the last line).

===Transcript===

$ sudo ./livecd-iso-to-disk.sh --overlay-size-mb 300 --home-size-mb 160 --delete-home --unencrypted-home Soas2-200906211228.iso /dev/sdb1
Verifying image...
/home/walter/Desktop/Soas2-200906211228.iso: 9f1aa3c7a19dd9c68d1047d681f703c6
Fragment sums: f5ddb7deb26b6474bd59be9f57b6c7abcd624e1ccc682ddf664ba73da4ed
Fragment count: 20
Checking: 100.0%

The media check is complete, the result is: PASS.

It is OK to use this media.
Copying live image to USB stick
Updating boot config file
Initializing persistent overlay file
300+0 records in
300+0 records out
314572800 bytes (315 MB) copied, 88.7551 s, 3.5 MB/s
Initializing persistent /home
160+0 records in
160+0 records out
167772160 bytes (168 MB) copied, 48.1191 s, 3.5 MB/s
Formatting unencrypted /home
mke2fs 1.41.4 (27-Jan-2009)
Filesystem label=
OS type: Linux
Block size=1024 (log=0)
Fragment size=1024 (log=0)
40960 inodes, 163840 blocks
8192 blocks (5.00%) reserved for the super user
First data block=1
Maximum filesystem blocks=67371008
20 block groups
8192 blocks per group, 8192 fragments per group
2048 inodes per group
Superblock backups stored on blocks:
8193, 24577, 40961, 57345, 73729

Writing inode tables: done
Creating journal (4096 blocks): done
Writing superblocks and filesystem accounting information: done

This filesystem will be automatically checked every 28 mounts or
180 days, whichever comes first. Use tune2fs -c or -i to override.
tune2fs 1.41.4 (27-Jan-2009)
Setting maximal mount count to -1
Setting interval between checks to 0 seconds
Installing boot loader
USB stick set up as live image!

== What's next? ==

After you've created your stick, it's time to [[Sugar_on_a_Stick#Boot|boot your stick]] and [[Sugar on a Stick/Getting Involved | test]] it out. Please also [[Sugar on a Stick/Getting Involved/Testing | report]] your observations.

[[Category:HowTo]]

Sugar on a Stick

2009-08-06T05:21:21Z

CyberOrg:

<noinclude>{{ Translations | [[Sugar_on_a_Stick|english]] | [[Sugar_on_a_Stick/lang-es|español]] | [[Sugar_on_a_Stick/lang-fr|français]]}}{{GoogleTrans-en}}{{TeamHeader|Sugar on a Stick|home=Project Home|xbgColor=ffe792|join_label=Get Involved}}</noinclude>
{| class="wikitable"
|<div style="font-size: 1.5em; background: #ffffff; padding: 10px;" align=center>The v1 Strawberry release of Sugar on a Stick is [[Sugar_on_a_Stick/Strawberry| here]]!</div>
== Introduction ==

Sugar Labs offers ubiquitous access to Sugar in a USB (Universal Serial Bus) flash memory drive (stick). The Sugar on a Stick project gives children access to ''their'' Sugar on any computer in their environment with just a USB memory stick. Taking advantage of the Fedora LiveUSB, it's possible to store everything you need to run Sugar on a single USB memory stick (minimum size 1GB). This small USB device can boot into the Sugar learning platform on different computers at home, at school, or at an after-school program, bypassing the software on the those computers. In fact, Sugar on a Stick will work even if the computer does not have a hard-drive. With Sugar on a Stick, the learning experience is the same on any computer: at school, at home, at the library, or an after-school center.

For general questions, please see the [[/FAQ|Frequently Asked Questions (FAQ) page for Sugar on a Stick]].

You can learn more from [http://www.xconomy.com/boston/2009/02/05/sugar-beyond-the-xo-laptop-walter-bender-on-olpc-sucrose-084-and-sugar-on-a-stick/ Walter Bender's interview with Xconomy], [http://www.olpcnews.com/software/sugar/sugar_on_a_stick_netbooks.html Wayan Vota's video] and [http://www.flickr.com/photos/curiouslee/sets/72157613785006745/ Mike Lee's pictures].
|<span class="plainlinks">[{{fullurle:Sugar on a Stick/Strawberry}} {{filepath:SugarLabs3x.jpg}}]</span>
|}
{| class="wikitable"
|<div align=left><span class="plainlinks">[{{fullurle:Development Team/Release/Releases/Sucrose/0.84}} http://wiki.sugarlabs.org/images/thumb/3/30/Soas-1.png/180px-Soas-1.png]</span>
|
'''What's exactly on the Stick''': The Fedora version contains a compressed copy of Fedora 11 that will boot, run in memory, and maintain changes on a USB flash drive with a standard FAT16 or FAT32 partition. The files coexist with other files the user may have or put on the disk. Different types of configurations are being designed to offer the options to run virtualizations or emulations and to use virtual machines on existing computers, saving the Sugar Home folder (the learner's work) on the Stick for use at another workstation. See our [[Sugar on a Stick/Resources| resources page]] for more information.</div>
|}
{{TOCright}}
== Project [[Sugar on a Stick/Goals|Goals]] ==

Please contribute to this page [[Sugar on a Stick/Goals]].

* Sugar on a Stick as 1-to-1 computing in an elementary school
* Sugar on a Stick to empower middle- and high-school students to help test, and learn computing platforms as learning tools
* Sugar on a Stick for learning conferences to let people try Sugar and collaborate with other conference participants

'''''Would you like to help?'''''... Sugar Labs is entirely volunteer run. Please '''[[/Getting Involved| get involved]]'''.

== Getting Sugar on a Stick ==
Follow the instructions below to download a copy.

'''Requirements:'''
: You'll need a USB flash drive, with a size of at least 1 GB to install space for saving your work and changes to the system.
: (The download is a CD-ROM disc image .iso file (380 MiB) that could be burned to and booted from a CD drive like a LiveCD—but no work or changes will be saved after shutdown.)

'''Notes:'''
: ''Sugar on a Stick v1 Strawberry'' has been announced for immediate availability on June 24 and is ready for download. For more instructions and the latest information, please refer to the [[Sugar_on_a_Stick/Strawberry| release notes]].
{{:Sugar on a Stick/Downloads}}
=== Create Your Stick ===

Please select your operating system below to get further instructions.

{| class="wikitable:
|<span class="plainlinks">[{{fullurl:Sugar_on_a_Stick/Windows}} {{filepath:Windows.gif}}]</span>||<span class="plainlinks">[{{fullurl:Sugar_on_a_Stick/Mac}} {{filepath:Apple.gif}}]</span>||<span class="plainlinks">[{{fullurl:Sugar_on_a_Stick/Linux}} {{filepath:Penguin.png}}]</span>||    ||'''Virtual machines:'''   You can also run SoaS in a virtual machine. Sugar Labs volunteers are experimenting with [[VirtualBox]], [[VMware]], and [[QEMU]]. Virtual machines emulate computer hardware resources in software and allow your to install and run disc images from different operating systems on a single computer.
|}

=== Boot ===

To boot SoaS on an XO-1 look here: [[Sugar on a Stick/Installation/OLPC]]

If you have an older machine or you just want things to immediately work without fussing with the BIOS, you can burn a "Boot Helper" CD using the .iso below. This will start the boot from the CD, then read files from the USB stick: http://download.sugarlabs.org/soas/releases/soas-boot.iso

Note that when you use this method your USB stick must have the label FEDORA. Name the stick FEDORA '''before''' running liveusb-creator. In Windows, you can rename a disc in the file manager properties window. This ensures the persistent overlay will be used when booting with the "Boot Helper" CD.

On most modern computers its possible to set the target computer's BIOS to boot from USB so you don't need a CD at all! Unfortunately this is slightly different on each computer. Explore the setup screen for your system (press Esc or F1 while the computer is booting). If you can't figure it out, search Google for information on your computer model's BIOS.

=== Use ===

Once your stick boots, you'll find yourself in your own Sugar environment, ready to play and learn.
{| class="wikitable"
|-
|<span class="plainlinks"> [http://flossmanuals.net/Sugar http://wiki.sugarlabs.org/images/4/40/Sugarlabs_mainpage_07.png]</span>
| For a guide on how to use Sugar, see the [http://en.flossmanuals.net/sugar FLOSSmanuals Sugar Learners' Guide].
[[olpc:Keyboard_shortcuts|Keyboard shortcuts]] also lists some of the Sugar keyboard shortcuts on a PC keyboard.<br>
'''See also some hard-to-find or hidden features'''—[[The undiscoverable]].
|}

Let us know how it goes!

===[[/Subpages| Subpages]]===

== openSUSE flavor of SoaS ==

Get the openSUSE SoaS from [http://en.opensuse.org/Sugar here].

[[Category:Project]]

Sugar on a Stick

2009-08-06T05:20:06Z

CyberOrg: add openSUSE soas info

<noinclude>{{ Translations | [[Sugar_on_a_Stick|english]] | [[Sugar_on_a_Stick/lang-es|español]] | [[Sugar_on_a_Stick/lang-fr|français]]}}{{GoogleTrans-en}}{{TeamHeader|Sugar on a Stick|home=Project Home|xbgColor=ffe792|join_label=Get Involved}}</noinclude>
{| class="wikitable"
|<div style="font-size: 1.5em; background: #ffffff; padding: 10px;" align=center>The v1 Strawberry release of Sugar on a Stick is [[Sugar_on_a_Stick/Strawberry| here]]!</div>
== Introduction ==

Sugar Labs offers ubiquitous access to Sugar in a USB (Universal Serial Bus) flash memory drive (stick). The Sugar on a Stick project gives children access to ''their'' Sugar on any computer in their environment with just a USB memory stick. Taking advantage of the Fedora LiveUSB, it's possible to store everything you need to run Sugar on a single USB memory stick (minimum size 1GB). This small USB device can boot into the Sugar learning platform on different computers at home, at school, or at an after-school program, bypassing the software on the those computers. In fact, Sugar on a Stick will work even if the computer does not have a hard-drive. With Sugar on a Stick, the learning experience is the same on any computer: at school, at home, at the library, or an after-school center.

For general questions, please see the [[/FAQ|Frequently Asked Questions (FAQ) page for Sugar on a Stick]].

You can learn more from [http://www.xconomy.com/boston/2009/02/05/sugar-beyond-the-xo-laptop-walter-bender-on-olpc-sucrose-084-and-sugar-on-a-stick/ Walter Bender's interview with Xconomy], [http://www.olpcnews.com/software/sugar/sugar_on_a_stick_netbooks.html Wayan Vota's video] and [http://www.flickr.com/photos/curiouslee/sets/72157613785006745/ Mike Lee's pictures].
|<span class="plainlinks">[{{fullurle:Sugar on a Stick/Strawberry}} {{filepath:SugarLabs3x.jpg}}]</span>
|}
{| class="wikitable"
|<div align=left><span class="plainlinks">[{{fullurle:Development Team/Release/Releases/Sucrose/0.84}} http://wiki.sugarlabs.org/images/thumb/3/30/Soas-1.png/180px-Soas-1.png]</span>
|
'''What's exactly on the Stick''': The Fedora version contains a compressed copy of Fedora 11 that will boot, run in memory, and maintain changes on a USB flash drive with a standard FAT16 or FAT32 partition. The files coexist with other files the user may have or put on the disk. Different types of configurations are being designed to offer the options to run virtualizations or emulations and to use virtual machines on existing computers, saving the Sugar Home folder (the learner's work) on the Stick for use at another workstation. See our [[Sugar on a Stick/Resources| resources page]] for more information.</div>
|}
{{TOCright}}
== Project [[Sugar on a Stick/Goals|Goals]] ==

Please contribute to this page [[Sugar on a Stick/Goals]].

* Sugar on a Stick as 1-to-1 computing in an elementary school
* Sugar on a Stick to empower middle- and high-school students to help test, and learn computing platforms as learning tools
* Sugar on a Stick for learning conferences to let people try Sugar and collaborate with other conference participants

'''''Would you like to help?'''''... Sugar Labs is entirely volunteer run. Please '''[[/Getting Involved| get involved]]'''.

== Getting Sugar on a Stick ==
Follow the instructions below to download a copy.

'''Requirements:'''
: You'll need a USB flash drive, with a size of at least 1 GB to install space for saving your work and changes to the system.
: (The download is a CD-ROM disc image .iso file (380 MiB) that could be burned to and booted from a CD drive like a LiveCD—but no work or changes will be saved after shutdown.)

'''Notes:'''
: ''Sugar on a Stick v1 Strawberry'' has been announced for immediate availability on June 24 and is ready for download. For more instructions and the latest information, please refer to the [[Sugar_on_a_Stick/Strawberry| release notes]].
{{:Sugar on a Stick/Downloads}}
=== Create Your Stick ===

Please select your operating system below to get further instructions.

{| class="wikitable:
|<span class="plainlinks">[{{fullurl:Sugar_on_a_Stick/Windows}} {{filepath:Windows.gif}}]</span>||<span class="plainlinks">[{{fullurl:Sugar_on_a_Stick/Mac}} {{filepath:Apple.gif}}]</span>||<span class="plainlinks">[{{fullurl:Sugar_on_a_Stick/Linux}} {{filepath:Penguin.png}}]</span>||    ||'''Virtual machines:'''   You can also run SoaS in a virtual machine. Sugar Labs volunteers are experimenting with [[VirtualBox]], [[VMware]], and [[QEMU]]. Virtual machines emulate computer hardware resources in software and allow your to install and run disc images from different operating systems on a single computer.
|}

=== Boot ===

To boot SoaS on an XO-1 look here: [[Sugar on a Stick/Installation/OLPC]]

If you have an older machine or you just want things to immediately work without fussing with the BIOS, you can burn a "Boot Helper" CD using the .iso below. This will start the boot from the CD, then read files from the USB stick: http://download.sugarlabs.org/soas/releases/soas-boot.iso

Note that when you use this method your USB stick must have the label FEDORA. Name the stick FEDORA '''before''' running liveusb-creator. In Windows, you can rename a disc in the file manager properties window. This ensures the persistent overlay will be used when booting with the "Boot Helper" CD.

On most modern computers its possible to set the target computer's BIOS to boot from USB so you don't need a CD at all! Unfortunately this is slightly different on each computer. Explore the setup screen for your system (press Esc or F1 while the computer is booting). If you can't figure it out, search Google for information on your computer model's BIOS.

=== Use ===

Once your stick boots, you'll find yourself in your own Sugar environment, ready to play and learn.
{| class="wikitable"
|-
|<span class="plainlinks"> [http://flossmanuals.net/Sugar http://wiki.sugarlabs.org/images/4/40/Sugarlabs_mainpage_07.png]</span>
| For a guide on how to use Sugar, see the [http://en.flossmanuals.net/sugar FLOSSmanuals Sugar Learners' Guide].
[[olpc:Keyboard_shortcuts|Keyboard shortcuts]] also lists some of the Sugar keyboard shortcuts on a PC keyboard.<br>
'''See also some hard-to-find or hidden features'''—[[The undiscoverable]].
|}

Let us know how it goes!

== openSUSE flavor of SoaS ==

Get the openSUSE SoaS from [http://en.opensuse.org/Sugar here].

===[[/Subpages| Subpages]]===

[[Category:Project]]