Changes

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

<noinclude>{{TOCright}}

</noinclude>

== Introduction ==

== Introduction ==

This page provides additional detail for installing the most stable, released version of Sugar on a Stick (SoaS), '''[http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso]''' on a USB flash storage device using GNU/Linux.

This page provides additional detail for installing '''[[Sugar on a Stick/Mirabelle|Mirabelle]]''', the most stable, released version of Sugar on a Stick (SoaS), available at [http://spins.fedoraproject.org/soas/#downloads this download site], onto a USB/SD flash storage device using GNU/Linux.

: To explore a variety of '''experimental''' options for putting a [[What is Sugar?|Sugar]] image on a USB or SD flash drive under GNU/Linux, see the following pages:

: To explore a variety of '''experimental''' options for putting a [[What is Sugar?|Sugar]] image on a USB or SD flash drive under GNU/Linux, see the following pages:

If you have questions, trouble, or feedback, please let us know on the [[{{TALKPAGENAMEE}}|discussion]] page. If you can improve these instructions, please edit the page and do so!

If you have questions, trouble, or feedback, please let us know on the [[{{TALKPAGENAMEE}}|discussion]] page. If you can improve these instructions, please edit the page and do so!

*Also See this reference for details:[http://fedoraproject.org/wiki/How_to_create_and_use_Live_USB#Graphical_Method_-_Windows_or_Linux]

* See this reference for more background details: [[fedora:How to create and use Live USB#Graphical Method - Windows or Fedora]]

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

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

This is known to work in Fedora and Ubuntu.

This is known to work in Fedora and Ubuntu.

First, download a SoaS-2-blueberry {{Code|.iso}} image from  [[http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso], then return here.

First, download a SoaS-Mirabelle {{Code|.iso}} image from  http://spins.fedoraproject.org/soas/#downloads, then return here.

<!-- ::<small>(A program called UNetBootin available at http://unetbootin.sourceforge.net/ does all this magic for you... or you can do the magic yourself:)</small>

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

* 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}} will install the packages. They are also available through the Synaptic Package Manager.)

* 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}} will install the packages. They are also available through the Synaptic Package Manager.)

:: <small>(On Gentoo, one needs to uncomment 'SAMPLE FILE' in /etc/mtools/mtools.conf to make syslinux work.)</small>

:: <small>(On Gentoo, one needs to uncomment 'SAMPLE FILE' in /etc/mtools/mtools.conf to make syslinux work.)</small>

:*''[[wikipedia:dm-crypt|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}} option. The {{Code|--unencrypted-home}} option is preferred because the reduced overhead improves robustness with the compressed ''[[wikipedia:SquashFS|SquashFS]]'' file system employed by the Live USB deployment.

:*''[[wikipedia:dm-crypt|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}} option. The {{Code|--unencrypted-home}} option is preferred because the reduced overhead improves robustness with the compressed ''[[wikipedia:SquashFS|SquashFS]]'' file system employed by the Live USB deployment.

* Plug in a 1-GB or larger USB stick into your computer.

* Plug in a 1-GB 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).<br>(See [[fedora:Livecd-iso-to-disk.pod]] for usage details.)<br>(You will execute this script several steps below.)

* Download the installation script: http://bit.ly/livecd-iso-to-disk.<br>(See [[fedora:Livecd-iso-to-disk.pod]] for usage details.)<br>(You will execute this script several steps below.)

* Check the USB device name. In the example below, the '''s'''torage '''d'''evice is /dev/sdb and filesystem partition on that device is /dev/sdb1:

* Check the USB device name. In the example below, the '''s'''torage '''d'''evice is /dev/sdb and filesystem partition on that device is /dev/sdb1:

: <tt>'''df -h'''</tt>

: {{Code|df -h}}

  Filesystem            Size  Used Avail Use% Mounted on

  Filesystem            Size  Used Avail Use% Mounted on

  /dev/sda1              19G  7.0G  11G  40% /

  /dev/sda1              19G  7.0G  11G  40% /

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.

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.