5,424 bytes added
, 12:19, 14 July 2012
<noinclude>
These are the steps for installing Sugar on a Stick on a USB/SD device.
This page is transcluded to various installation instruction pages.</noinclude>
<ol start="0">
<li> '''Download''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file.<br><br></li>
<li> '''Prepare''': (with '''root''' user permissions)
<ul><li> Create a mount point directory: {{Code|mkdir /media/soas}}</li>
<li> Mount the .iso file as a disk: {{Code|mount '''/path/to/source'''.iso /media/soas/}}</li>
<li> Insert a USB stick of 2 GB or greater capacity into your computer.</li>
<li> Use the {{Code|blkid}} or {{Code|df -Th}} command to get the USB device node name.</li>
{{Show| You should see something like the following:
|<pre>
[root@MyComputer ~]# df -Th
Filesystem Type Size Used Avail Use% Mounted on
rootfs rootfs 20G 5.5G 14G 29% /
devtmpfs devtmpfs 1.6G 0 1.6G 0% /dev
tmpfs tmpfs 1.6G 788K 1.6G 1% /dev/shm
tmpfs tmpfs 1.6G 1.3M 1.6G 1% /run
tmpfs tmpfs 1.6G 0 1.6G 0% /sys/fs/cgroup
tmpfs tmpfs 1.6G 0 1.6G 0% /media
/dev/loop0 iso9660 509M 509M 0 100% /media/soas
/dev/sdc1 vfat 995M 983M 13M 99% /run/media/MyAccount/LG
</pre>
where the mount point and filesystem sizes should help you identify what you want.}}
<li> Unmount the USB device filesystem:<br>{{Code|umount /run/media/MyAccount/MyUSBdiscMountPoint}}</li>
<li> (You should have the isomd5sum package installed so that the following installation script can verify the download.)<br><br></li></ul>
<li> '''Load''': Execute, as the '''root''' user in <u>one</u> command with arguments, the following:<br><div style="padding: 1em; border: 1px dashed #2F6FAB; background-color: #FBFBFB; margin: 1em 0px 1em 1.6em; font-family: Courier;">/media/soas/LiveOS/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>
: where '{{Code|'''?'''}}' in the final parameter represents the target USB device '''''s'''csi '''d'''rive'' node, such as {{Code|sd'''b'''1}} or {{Code|sd'''c'''1}}, etc., and {{Code|'''/path/to/source'''.iso}} is the location and name of the .iso file.
: The operating system will occupy ~510 MB, and the overlay and home size arguments, '''500''' and '''900''', were selected to fit in a 2 GB device, but may be adjusted according to your device capacity.
{{Show| The installation transcript should look something like the following:
|<pre>
[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...
/media/soas/Fedora-17-x86_64-Live-SoaS.iso: 470134baa7e48085595243e53b55d41e
Fragment sums: 7de3e14f3d5aa991343fa35bdfe3a1db59d578db95a844a63d22de789de1
Fragment count: 20
Press [Esc] to abort check.
Checking: 100.0%
The media check is complete, the result is: PASS.
It is OK to use this media.
Copying live image to target device.
squashfs.img
512344064 100% 43.04MB/s 0:00:11 (xfer#1, to-check=0/1)
sent 512406681 bytes received 31 bytes 44557105.39 bytes/sec
total size is 512344064 speedup is 1.00
osmin.img
8192 100% 0.00kB/s 0:00:00 (xfer#1, to-check=0/1)
sent 8265 bytes received 31 bytes 16592.00 bytes/sec
total size is 8192 speedup is 0.99
Updating boot config file
Initializing persistent overlay file
500+0 records in
500+0 records out
524288000 bytes (524 MB) copied, 5.1728 s, 101 MB/s
Initializing persistent /home
900+0 records in
900+0 records out
943718400 bytes (944 MB) copied, 152.195 s, 6.2 MB/s
Formatting unencrypted /home
mke2fs 1.42.3 (14-May-2012)
Filesystem label=
OS type: Linux
Block size=4096 (log=2)
Fragment size=4096 (log=2)
Stride=0 blocks, Stripe width=0 blocks
57600 inodes, 230400 blocks
11520 blocks (5.00%) reserved for the super user
First data block=0
Maximum filesystem blocks=239075328
8 block groups
32768 blocks per group, 32768 fragments per group
7200 inodes per group
Superblock backups stored on blocks:
32768, 98304, 163840, 229376
Allocating group tables: done
Writing inode tables: done
Creating journal (4096 blocks): done
Writing superblocks and filesystem accounting information: done
tune2fs 1.42.3 (14-May-2012)
Setting maximal mount count to -1
Setting interval between checks to 0 seconds
Installing boot loader
Target device is now set up with a Live image!
</pre>}}
<li> '''Boot''': Insert the USB stick into a bootable USB port on your computer. Set the option to "boot from USB" in your computer's <abbr title="Basic Input/Output System">BIOS</abbr> setup, and then start up the computer.<br><br></li></ol>
::* You may create more Sugar Sticks on other 1 GB or greater USB or SD devices. In the Terminal Activity of a running ''Sugar on a Stick'', run this command as root:<br><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 '''300''' --home-size-mb '''175''' --delete-home --unencrypted-home /run/initramfs/livedev /dev/sd'''?'''1</div>