Changes

</noinclude>

</noinclude>

== Introduction ==

== Introduction ==

This page provides additional detail for loading '''[[Sugar on a Stick/Pineapple|Pineapple]]''', 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 loading '''[[Sugar on a Stick/Quandong|Quandong]]''', the most stable, released version of Sugar on a Stick (SoaS), available at [[Sugar on a Stick/Downloads]], 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:

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

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

* Mount the 'SoaS.iso' image to reach the onboard livecd-iso-to-disk installation script:

* Mount the 'SoaS.iso' image to reach the onboard livecd-iso-to-disk installation script:

: {{Code|sudo mkdir /mnt/soas/}}

: {{Code|sudo mkdir /media/soas/}}

: {{Code|sudo mount /path/to/Fedora-16-x86_64-Live-SoaS.iso /mnt/soas/}}

: {{Code|sudo mount /path/to/Fedora-17-x86_64-Live-SoaS.iso /media/soas/}}

:: (mount: warning: /mnt/soas/ seems to be mounted read-only.)

:: (mount: warning: /media/soas/ seems to be mounted read-only.)

* Change the working directory to the LiveOS folder on the SoaS.iso mount:

* Change the working directory to the LiveOS folder on the SoaS.iso mount:

: {{Code|cd /mnt/soas/LiveOS}}

: {{Code|cd /media/soas/LiveOS}}

* Execute {{Code|./livecd-iso-to-disk --help}} for usage details. (The file is already executable.)

* Execute {{Code|./livecd-iso-to-disk --help}} for usage details. (The file is already executable.)

/dev/sda2    ext4    20G  12G  7.5G  61% /var/tmp

/dev/sda2    ext4    20G  12G  7.5G  61% /var/tmp

/dev/sda2    ext4    20G  12G  7.5G  61% /home

/dev/sda2    ext4    20G  12G  7.5G  61% /home

/dev/loop0 iso9660    443M 443M     0 100% /mnt/soas

/dev/loop0 iso9660    509M 509M     0 100% /media/soas

/dev/sdc1    vfat    3.8G  4.0K  3.8G  1% /media/MyUSBdiscMountPoint

/dev/sdc1    vfat    3.8G  4.0K  3.8G  1% /run/media/MyAccount/MyUSBdiscMountPoint

</pre>

</pre>

* Unmount the drive,<br>

* Unmount the drive,<br>

: {{Code|sudo umount /media/MyUSBdiscMountPoint}}

: {{Code|sudo umount /run/media/MyAccount/MyUSBdiscMountPoint}}

* Then check to see that the partition is marked as bootable,<br>

* Then check to see that the partition is marked as bootable,<br>

* Run {{Code|livecd-iso-to-disk}} as the root user, making sure to pass the correct USB device node name and to set overlay and home size appropriately, depending on the target USB device storage capacity.

* Run {{Code|livecd-iso-to-disk}} as the root user, making sure to pass the correct USB device node name and to set overlay and home size appropriately, depending on the target USB device storage capacity.

: {{Code|sudo ./livecd-iso-to-disk --reset-mbr --overlay-size-mb '''500''' --home-size-mb '''900''' --delete-home --unencrypted-home /path/to/SoaS.iso /dev/sd'''c'''1}}

:<div style="padding: 1em; border: 1px dashed #2F6FAB; background-color: #FBFBFB; margin: 1em 0px 1em 0em; font-family: Courier;">./livecd-iso-to-disk --reset-mbr --overlay-size-mb '''500''' --home-size-mb '''900''' --delete-home --unencrypted-home '''/path/to/source'''.iso /dev/sd'''?'''1</div>

:: (In the above example, the /path/to/SoaS.iso may be substituted with /dev/loop0, as this is the loop device that the mount command chose.)

:: (In the above example, the {{Code|'''/path/to/source'''.iso}} may be substituted with {{Code|/dev/loop0}}, as this is the loop device that the mount command chose.)

:: {{Highlight|'''Note''': Additional USB or SD devices may be loaded from a running ''Sugar on a Stick'' image that was loaded with the livecd-iso-to-disk script downloaded after 15 February 2011 (but not those installed by other methods) by running this command from a root user Terminal window:}}

: {{Highlight|'''Note''': Additional USB or SD devices may be loaded from a running ''Sugar on a Stick'' image that was loaded with the livecd-iso-to-disk script (but not those installed by other methods) by running this command in the Terminal Activity as a root user:}}

:: {{Code|/mnt/live/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb '''500''' --home-size-mb '''900''' --delete-home --unencrypted-home /dev/sr0 /dev/sd'''?'''1}}

:<div style="padding: 1em; border: 1px dashed #2F6FAB; background-color: #FBFBFB; margin: 1em 0px 1em 0em; font-family: Courier;">/run/initramfs/live/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb '''500''' --home-size-mb '''900''' --delete-home --unencrypted-home /run/initramfs/livedev /dev/sd'''?'''1</div>

: The ''livecd-iso-to-disk'' installation method has other 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).

: The ''livecd-iso-to-disk'' installation method has other 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).

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

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

<pre>

<pre>

[LiveOS]$ sudo ./livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 900 --delete-home --unencrypted-home /media/SoaS/Fedora-16-x86_64-Live-SoaS.iso /dev/sdc1

[LiveOS]$ sudo ./livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 900 --delete-home --unencrypted-home /media/SoaS/Fedora-17-x86_64-Live-SoaS.iso /dev/sdc1

Verifying image...

Verifying image...

/media/SoaS/Fedora-16-x86_64-Live-SoaS.iso:  5fb3054f09478a6ae12e2384c2e0142d

/media/SoaS/Fedora-17-x86_64-Live-SoaS.iso:  470134baa7e48085595243e53b55d41e

Fragment sums: f772712c38fa22679ddadffa69fea8a9c64e85db24c7a3eec3ca7aa324af

Fragment sums: 7de3e14f3d5aa991343fa35bdfe3a1db59d578db95a844a63d22de789de1

Fragment count: 20

Fragment count: 20

Press [Esc] to abort check.

Press [Esc] to abort check.

Copying live image to target device.

Copying live image to target device.

squashfs.img

squashfs.img

   447225856 100%  56.88MB/s    0:00:07 (xfer#1, to-check=0/1)

   512344064 100%  43.04MB/s    0:00:11 (xfer#1, to-check=0/1)

sent 447280525 bytes  received 31 bytes  52621241.88 bytes/sec

sent 512406681 bytes  received 31 bytes  44557105.39 bytes/sec

total size is 447225856 speedup is 1.00

total size is 512344064 speedup is 1.00

osmin.img

osmin.img

         8192 100%    0.00kB/s    0:00:00 (xfer#1, to-check=0/1)

         8192 100%    0.00kB/s    0:00:00 (xfer#1, to-check=0/1)

500+0 records in

500+0 records in

500+0 records out

500+0 records out

524288000 bytes (524 MB) copied, 62.769 s, 8.4 MB/s

524288000 bytes (524 MB) copied, 5.1728 s, 101 MB/s

Initializing persistent /home

Initializing persistent /home

900+0 records in

900+0 records in

900+0 records out

900+0 records out

943718400 bytes (944 MB) copied, 384.582 s, 2.5 MB/s

943718400 bytes (944 MB) copied, 152.195 s, 6.2 MB/s

Formatting unencrypted /home

Formatting unencrypted /home

mke2fs 1.41.14 (22-Dec-2010)

mke2fs 1.42.3 (14-May-2012)

Filesystem label=

Filesystem label=

OS type: Linux

OS type: Linux

32768, 98304, 163840, 229376

32768, 98304, 163840, 229376

Writing inode tables: done                             

Writing inode tables: done                             

Creating journal (4096 blocks): done

Creating journal (4096 blocks): done

Writing superblocks and filesystem accounting information: done

Writing superblocks and filesystem accounting information: done

tune2fs 1.42.3 (14-May-2012)

tune2fs 1.41.14 (22-Dec-2010)

Setting maximal mount count to -1

Setting maximal mount count to -1

Setting interval between checks to 0 seconds

Setting interval between checks to 0 seconds