Sugar on a Stick/Linux: Difference between revisions

Line 3:

</noinclude>

== Introduction ==

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.

This page provides additional detail for installing '''[[Sugar on a Stick/Mango Lassi|Mango Lassi]]''', 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:

Line 16:

This is known to work in Fedora and Ubuntu.

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

First, download a SoaS {{Code|.iso}} image from http://spins.fedoraproject.org/soas/#downloads, 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:)

Line 80:

* 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.

: {{Code|sudo ./livecd-iso-to-disk.sh --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home /path/to/SoaS.iso /dev/sd''b1''}}

:: ~~'''Note:''' With the soas-2-blueberry.iso, leave out the 3 options for a separate persistent home.~~ The ~~script will complete successfully, but the new installation startup process will have trouble finding the home folder and fail to complete.~~

:: The ''livecd-iso-to-disk'' installation method has advantages over the ''liveusb-creator'' method by allowing the creation of a separate, persistent /home/liveuser folder with the <tt>--home-size-mb ''NNN''</tt> option. This feature avoids consumption of the write-once persistent overlay for Activity storage (see [[LiveOS image]]) and allows one to update the OS image while keeping the user files (by running the script against your existing installation but leaving out the --home-size-mb NNN option).

~~:: Normally, 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 leaving out the --home-size-mb NNN option).

::* The {{Code|--delete-home}} option is used to avoid an error message while requesting both a new home (with {{Code|--home-size-mb}}) and a persistent home (indirectly with {{Code|--unencrypted-home}}). 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}} and {{Code|--home-size-mb}} values (for example, for a 1-GB stick, use 300 for the overlay and 175 for the home folder).

@@ Line 3: / Line 3: @@
 </noinclude>
 == Introduction ==
-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.
+This page provides additional detail for installing '''[[Sugar on a Stick/Mango Lassi|Mango Lassi]]''', 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:
@@ Line 16: / Line 16: @@
 This is known to work in Fedora and Ubuntu.
-First, download a SoaS-Mirabelle {{Code|.iso}} image from  http://spins.fedoraproject.org/soas/#downloads, then return here.
+First, download a SoaS {{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>
@@ Line 80: / Line 80: @@
 * 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.
 : {{Code|sudo ./livecd-iso-to-disk.sh --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home /path/to/SoaS.iso /dev/sd''b1''}}
-:: '''Note:''' With the soas-2-blueberry.iso, leave out the 3 options for a separate persistent home.  The script will complete successfully, but the new installation startup process will have trouble finding the home folder and fail to complete.
+:: The ''livecd-iso-to-disk'' installation method has advantages over the ''liveusb-creator'' method by allowing the creation of a separate,  persistent /home/liveuser folder with the <tt>--home-size-mb ''NNN''</tt> option. This feature avoids consumption of the write-once persistent overlay for Activity storage (see [[LiveOS image]]) and allows one 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).
-:: Normally, 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}} option is used to avoid an error message while requesting both a new home (with {{Code|--home-size-mb}}) and a persistent home (indirectly with {{Code|--unencrypted-home}}). 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}} and {{Code|--home-size-mb}} values (for example, for a 1-GB stick, use 300 for the overlay and 175 for the home folder).