|
|
| Line 6: |
Line 6: |
| ==Sugar on a Stick== | | ==Sugar on a Stick== |
|
| |
|
| The SoaS download is found here: '''[[Sugar on a Stick]]'''. Basic instructions are found below:
| |
|
| |
| == Sugar on a Stick installation instructions ==
| |
| === MS Windows === | | === MS Windows === |
|
| |
|
| Line 15: |
Line 12: |
| |width="160px" valign="top"|[[File:Windows.gif|left|link=Sugar on a Stick/Windows]] | | |width="160px" valign="top"|[[File:Windows.gif|left|link=Sugar on a Stick/Windows]] |
| <br><br><br> | | <br><br><br> |
| <span class="linkgroup">[[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]</span>
| |
| [[File:USB flash drive.jpg|left|156px|link=Sugar on a Stick/Downloads]] | | [[File:USB flash drive.jpg|left|156px|link=Sugar on a Stick/Downloads]] |
| |valign=top| | | |valign=top| |
| # '''Prepare''': [http://fedorahosted.org/liveusb-creator/#Download Download] the Fedora Live USB Creator from [http://fedorahosted.org/liveusb-creator/#Download FedoraHosted].<br><br>
| |
| # '''Download''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file.<br><br> | | # '''Download''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file.<br><br> |
| # '''Load''': Insert a USB flash drive (or SD Card) with 2 GB or more of free space into your computer and launch Fedora Live USB Creator to create a Sugar-on-a-Stick bootable image.<br/>'''Note''': Be sure to set the ''persistent storage'' slider to a non-zero value.<br><br> | | # '''Load''': Insert a USB flash drive (or SD Card) with 2 GB or more of free space into your computer and launch Rufus to create a Sugar-on-a-Stick bootable image.<br/> |
| # '''Boot''': Insert the USB stick into a 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. | | # '''Boot''': Insert the USB stick into a 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. |
| |} | | |} |
|
| |
| Detailed [[Sugar on a Stick/Windows|installation instructions for Windows]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Getting Started/Explore|guide to exploring Sugar]].
| |
| ----
| |
| === GNU/Linux === | | === GNU/Linux === |
| {|style="width: 800px;" | | {|style="width: 800px;" |
| Line 31: |
Line 23: |
| |width="160px" valign=top|<br><span class="linkgroup">[[File:Gnulinux.png|link=Sugar on a Stick/Linux]] | | |width="160px" valign=top|<br><span class="linkgroup">[[File:Gnulinux.png|link=Sugar on a Stick/Linux]] |
| <br> | | <br> |
| [[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]</span> | | [[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]] |
| [[File:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]] | | [[File:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]] |
| |valign=top| | | |valign=top| |
| | |
| | # '''Download''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file.<br><br> |
| | # '''Load''': <br>Here is a simple way to create a SOAS usb flash drive.<br> |
| | ## Open a shell (command line interpreter) |
| | ## Type <code>df -Th</code>. This shows all of the mounted partitions (on your computer's hard drive.) |
| | ## Insert a USB flash drive (or SD Card) with 2 GB or more of free space into your computer |
| | ## After a few moment type <code>df -Th</code> again. You should see an added line for your USB drive. Check the size of the drive (e.g. 3.7GB for a 4GB drive) and its type: vfat to confirm this line refers to your usb flash drive. The first field on this line, e.g. /dev/sdb1, identifies the partition. For dd command, you will use /dev/sdb [this field without the partition number]. |
| | ## type <code>cd ~/Downloads</code>. Then type <code>ls Fedora*.iso</code> Assuming you downloaded to the Downloads folder, this will show the SOAS iso. |
| | ## Type <code>sudo dd if=Fedora-SoaS-Live-x86_64-25-1.3.iso of=/dev/sdb bs=1M</code> with the correct if (input file) and of (output device). The dd command erases the 'of' device so make sure it doesn't say /dev/sda which would erase your computer's hard drive!!! Also make sure you have saved any valuable information on the usb flash drive. |
| | # '''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> |
| |} | | |} |
|
| |
| Detailed [[Sugar on a Stick/Linux|installation instructions for GNU/Linux]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Getting Started/Explore|guide to exploring Sugar]].
| |
| GNU/Linux users may also want to install the [[#Do_you_use_GNU.2FLinux.3F|Sugar packages]] on their favorite distro, apart from Sugar on a Stick.
| |
| ----
| |
|
| |
| === Apple Mac OS X === | | === Apple Mac OS X === |
| {| | | {| |
| Line 48: |
Line 45: |
| [[File:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]] | | [[File:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]] |
| |valign=top| | | |valign=top| |
| The instructions below are based on the Ubuntu Web page at <http://www.ubuntu.com/download/desktop/create-a-usb-stick-on-mac-osx>.
| |
| # '''Prepare''': These instructions are for '''32-bit''' and '''64-bit''' processors.<br><br>
| |
| # '''Download''' the latest [[Sugar on a Stick/Downloads|Sugar on a Stick]] .iso file.<br><br> | | # '''Download''' the latest [[Sugar on a Stick/Downloads|Sugar on a Stick]] .iso file.<br><br> |
| # '''Load''': <br>Here is a simple way to load a bootable USB on a Mac.<br> | | # '''Load''': <br>Here is a simple way to load a bootable USB on a Mac.<br> |
| Line 62: |
Line 57: |
| # '''Boot''': Insert the USB stick into a USB port on your computer, then reboot and press and hold the Option key while rebooting. You should see a list of all the EFI-recognizable USB drives that can be bootstrapped. If Sugar on a Stick is not one such drive, it cannot be bootstrapped: you need rEFInd (a fork of rEFIt).<br> | | # '''Boot''': Insert the USB stick into a USB port on your computer, then reboot and press and hold the Option key while rebooting. You should see a list of all the EFI-recognizable USB drives that can be bootstrapped. If Sugar on a Stick is not one such drive, it cannot be bootstrapped: you need rEFInd (a fork of rEFIt).<br> |
| <br> | | <br> |
| :* Have a MacBook? Consider these options:
| |
| ::[[File:Usb1.png|50px]] [[Testing/Reports/Sugar on a Stick#MacBook Persistent SoaS v5 USB EFI Boot|'''MacBook Persistent SoaS v5 USB EFI Boot''']]
| |
| :: [[Talk:Downloads#Bootable_CD_of_Trisquel_4.5_for_MacBook_Air|Bootable CD of Trisquel 4.5 for MacBook Air]]
| |
| :: See other installation variations at [[Sugar Creation Kit]]
| |
| ::[[File:Apple.gif|30px]] [[Tutorials/Installation/Burn_a_CD.iso_on_a_Mac|'''Burning a CD from an .iso file on a Mac''']]
| |
| :* Have an iBook or PowerPC Mac?
| |
| :: See [[Ubuntu/PPC]] and [[Fedora#PowerPC]].
| |
| |} | | |} |
|
| |
| Alternative [[Macintosh|installation instructions for Mac OS X]]. Also, [[Sugar_on_a_Stick/Blueberry#For_Mac_OS_X_Users|these older installation instructions]] and [[Sugar on a Stick/Boot|booting instructions]] may be consulted.<br>There is also a [[Getting Started/Explore|guide to exploring Sugar]].
| |
| ----
| |
|
| |
|
| ===Advanced users=== | | ===Advanced users=== |
| Line 100: |
Line 85: |
|
| |
|
|
| |
|
| <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></li>
| |
| {{Note/important|Important change since Fedora 24 SoaS|The ''livecd-iso-to-disk'' installation script is no longer packaged in the SoaS .iso file. Starting with Fedora 24, if you want a Live USB with persistent storage, you must install the ''livecd-tools'' package to obtain the installation script and the SYSLINUX boot loader. Use this command to obtain the installer: {{Code|sudo dnf install livecd-tools}}}}
| |
| <li> Insert a USB stick of 2 GB or greater capacity into your computer.</li>
| |
| <li> With [[olpc:Root|'''root''' user]] permissions at a terminal or [[Wikipedia:System_console|console]] command line, use the command {{Code|df -Th}} or {{Code|blkid}} 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 668M 668M 0 100% /run/soas
| |
| /dev/sdc1 vfat 2.0G 2.0G 53M 98% /run/media/MyAccount/LG
| |
| /</pre>
| |
| : <small>(The {{Code|/run/media/MyAccount/}} path is the new, Fedora 17 standard mount point for removable media.<br>{{Code|/media/MyMountPoint}} is common on other operating systems.)</small>
| |
|
| |
| <pre>
| |
| [root@MyComputer ~]# blkid
| |
| /dev/sda1: LABEL="Fedora-20" UUID="8962913a-c335-4c3b-b3ed-90fbb9c97580" TYPE="ext4" PARTUUID="1549f232-01"
| |
| /dev/sdc1: LABEL="LIVE" UUID="D2AC-5056" TYPE="vfat" PARTUUID="000056b3-01"
| |
| /dev/loop0: UUID="2013-12-12-01-40-45-00" LABEL="Fedora-Live-SoaS-x86_64-20-1" TYPE="iso9660" PTUUID="461863db" PTTYPE="dos"
| |
| </pre>
| |
| :: <small>(Additional disk drive partitions may be listed on your computer.)</small>
| |
| : The mount point (Mounted on), Filesystem, Size, and LABEL should help you identify what you want.}}
| |
| <li> Unmount the USB device filesystem:<br>{{Code|umount /run/media/MyAccount/MyUSBdiscMountPoint}}
| |
| : <small>(The {{Code|/run/media/MyAccount/}} path is the new, Fedora 17 standard mount point. Other operating systems may use {{Code|/media/MyMountPoint}}.)</small></li>
| |
| <li> (You should have the isomd5sum package installed so that the following installation script can verify the download.)<br><br></li>
| |
| <li> '''Load''': Execute the following installation command, as the [[olpc:Root|'''root''' user]], in <u>one</u> command line with many options:<br><div style="margin: 1em 0px 1em 1.6em; border: 1px dashed #2F6FAB; padding: 1em; background-color: #FBFBFB; font-family: Courier;">livecd-iso-to-disk --reset-mbr --overlay-size-mb '''500''' --home-size-mb '''800''' --unencrypted-home '''/path/to/downloaded'''.iso /dev/sd'''?'''1</div>
| |
| : The '{{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/downloaded'''.iso}} is the location and name of the .iso file.
| |
| : The operating system will occupy ~670 MB, and the overlay and home size arguments, '''500''' and '''800''', were selected to fit in a 2 GB device. These may be adjusted depending on your preferences and device capacity (see [[LiveOS image]]). SoaS 10 can be squeezed into a 1 GB device with '''160''' and '''170'''. On a 4 GB device, one might use '''1000''' and '''1600''' for the size arguments.
| |
| {{Show| The installation transcript should look something like the following:
| |
| |<pre>
| |
| [root@MyComputer ~]# /run/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 800 --unencrypted-home /home/MyAccount/Downloads/Fedora-Live-SoaS-x86_64-20-1.iso /dev/sdc1
| |
| Verifying image...
| |
| /home/MyAccount/Downloads/Fedora-Live-SoaS-x86_64-20-1.iso: b0a9414ff7eb79b680d5c86440e19587
| |
| Fragment sums: 9bfe23577651c88dcfb78c76ac3a28a5c53eead4561e3bdc5921b8b2e748
| |
| 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
| |
| 630,784,000 100% 1.96MB/s 0:05:06 (xfr#1, to-chk=0/1)
| |
| osmin.img
| |
| 8,192 100% 0.00kB/s 0:00:00 (xfr#1, to-chk=0/1)
| |
| Updating boot config file
| |
| Initializing persistent overlay file
| |
| 500+0 records in
| |
| 500+0 records out
| |
| 524288000 bytes (524 MB) copied, 216.717 s, 2.4 MB/s
| |
| Initializing persistent /home
| |
| 800+0 records in
| |
| 800+0 records out
| |
| 838860800 bytes (839 MB) copied, 344.643 s, 2.4 MB/s
| |
| Formatting unencrypted /home
| |
| mke2fs 1.42.8 (20-Jun-2013)
| |
| Filesystem label=
| |
| OS type: Linux
| |
| Block size=4096 (log=2)
| |
| Fragment size=4096 (log=2)
| |
| Stride=0 blocks, Stripe width=0 blocks
| |
| 51296 inodes, 204800 blocks
| |
| 10240 blocks (5.00%) reserved for the super user
| |
| First data block=0
| |
| Maximum filesystem blocks=209715200
| |
| 7 block groups
| |
| 32768 blocks per group, 32768 fragments per group
| |
| 7328 inodes per group
| |
| Superblock backups stored on blocks:
| |
| 32768, 98304, 163840
| |
|
| |
| Allocating group tables: done
| |
| Writing inode tables: done
| |
| Creating journal (4096 blocks): done
| |
| Writing superblocks and filesystem accounting information: done
| |
|
| |
|
| tune2fs 1.42.8 (20-Jun-2013)
| |
| 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>}}<br></li>
| |
| <li> '''[[Sugar on a Stick/Boot|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>
| |
|
| |
|
| ::* To create more Sugar Sticks on other 1 GB or greater USB or SD devices, while running ''Sugar on a Stick'', one must first obtain the ''livecd-tools'' installer as above, then in the [[Activities/Terminal|Terminal Activity]], execute this command as the root user:<br><div style="margin: 1em 0px 1em 0em; border: 1px dashed #2F6FAB; padding: 1em; background-color: #FBFBFB; font-family: Courier;">livecd-iso-to-disk --reset-mbr --overlay-size-mb '''160''' --home-size-mb '''170''' --delete-home --unencrypted-home /run/initramfs/livedev /dev/sd'''?'''1</div>
| |
| ::: <small>Replace {{Code|/dev/sd'''?'''1}} with a new device node for the second USB/SD device that you want to load with ''Sugar on a Stick''.</small>
| |
|
| |
|
| <noinclude>[[Category:Supported systems]]</noinclude> | | <noinclude>[[Category:Supported systems]]</noinclude> |