Changes

Jump to navigation Jump to search
7,465 bytes removed ,  20:59, 25 April 2017
no edit summary
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 &lt;http://www.ubuntu.com/download/desktop/create-a-usb-stick-on-mac-osx&gt;.
  −
# '''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|&nbsp;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|&nbsp;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>
184

edits

Navigation menu