Sugar on a Stick/Linux: Difference between revisions

</noinclude>

== Introduction ==

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

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

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

* 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% /home

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

</pre>

* Unmount the drive,<br>

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

{{:Sugar on a Stick/Linux/bootable device}}

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

: If the command fails telling you that /dev/sd'''?'''1 does not exist, try using the command for /dev/sd'''?''' (the name of the device) and not for /dev/sd'''?'''1 (the name of the partition), like this:

: If the command fails returning a complaint about the filesystem not being mounted, '''and''' you can afford to '''loose all data on the USB device''', you can try reformatting the USB device filesystem:

{{Note/warning|Warning|The command described here will ask for a confirmation and will '''destroy''' all pre-existing data on your USB device.<br>

See also [[olpc:How_to_Damage_a_FLASH_Storage_Device|How to Damage a FLASH Storage Device]] for a discussion of why using the factory format is preferred.}}

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

{{Note/note|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:}}

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

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

<pre>

Verifying image...

Fragment count: 20

Press [Esc] to abort check.

Copying live image to target device.

squashfs.img

osmin.img

Updating boot config file

Initializing persistent overlay file

500+0 records in

500+0 records out

Initializing persistent /home

Formatting unencrypted /home

Filesystem label=

OS type: Linux

Fragment size=4096 (log=2)

Stride=0 blocks, Stripe width=0 blocks

First data block=0

32768 blocks per group, 32768 fragments per group

Superblock backups stored on blocks:  

Allocating group tables: done                             

Writing superblocks and filesystem accounting information: done

Setting maximal mount count to -1

Setting interval between checks to 0 seconds