Difference between revisions of "Get sugar"

From Sugar Labs
Jump to navigation Jump to search
(Created page with " __NOTOC__ There are two ways to use Sugar on your own computer. SOAS (Sugar on a Stick) is a USB flash drive with Sugar which can be booted on your computer but does not cha...")
 
 
(3 intermediate revisions by the same user not shown)
Line 4: Line 4:
 
There are two ways to use Sugar on your own computer. SOAS (Sugar on a Stick) is a USB flash drive with Sugar which can be booted on your computer but does not change anything on your hard drive. The second way is to free some space on your hard drive and install a distribution of GNU/Linux which supports Sugar. The method allows you to choose your normal operating system or GNU/Linux with Sugar during boot.
 
There are two ways to use Sugar on your own computer. SOAS (Sugar on a Stick) is a USB flash drive with Sugar which can be booted on your computer but does not change anything on your hard drive. The second way is to free some space on your hard drive and install a distribution of GNU/Linux which supports Sugar. The method allows you to choose your normal operating system or GNU/Linux with Sugar during boot.
  
−
==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]].
+
==='''Note'''===
−
----
 
−
 
 
−
===Advanced users===
 
−
==Do you have an OLPC XO?==
 
−
 
 
−
{|
 
−
|-
 
−
|width="174px"|[[File:OLPCXO.png|middle|link=olpc:Releases]]
 
−
|valign=top|
 
−
* '''Upgrade''' to the latest ''[[olpc:Releases]]'' from OLPC (which may require a [[olpc:Activation_and_developer_keys|developer key]]).
 
  
−
* '''Experiment''' with [[Sugar_on_a_Stick/Installation/OLPC|Updating XOs]] to the latest ''Sugar on a Stick'' release.
+
SOAS sticks created with Windows or GNU/Linux can be booted on PC computers. SOAS sticks created using an Apple computer can be booted on an Apple computer.
−
|}
 
  
−
<br/><br/>
+
=='''Installing Sugar on your computer's hard drive'''==
−
==Some alternate installations==
 
−
* Once you download, and then burn or load a Sugar on a Stick (SoaS) .iso file, and boot it, the running Fedora 17 SoaS Live CD/USB may be used to install Fedora with Sugar to a hard disk or a 4 GB USB stick [[Tutorials/Installation/Install with liveinst|with the '''{{Code|liveinst}} command''']].
 
−
:- You start with a SoaS LiveOS image, and then load an uncompressed version onto the hard disk or USB stick.
 
−
:- The Fedora-17-Live-SoaS.iso file is a 509 MB download.
 
  
−
* If you have a high-speed Internet connection,<br>'''Fedora with the Sugar graphical learning environment''' may be installed to a hard disk or a a 4 GB USB stick [[Tutorials/Installation/Install with netinstall|with a '''Netinstall CD''']].
+
The procedure to install Sugar is:
−
:- Not a compressed LiveOS image like SoaS, but all of Sugar.
 
−
:- {{Highlight|bgcolor=#f9f6b7|''This requires a high-speed Internet connection for software component downloading during installation.''}}
 
  
−
==Do you use GNU/Linux?==
+
# Free some space on the computer's hard drive
 +
## For Windows, shrink the size of the D: partition or, if no D: partition, the C: partition.
 +
## For GNU/Linux, use gparted, select the partition, choose move/resize, and add space after the partition (the size of the partition will be reduced accordingly).
 +
## Sugar was designed for systems with very limited storage capacity. To test Sugar a space of 10GB should be plenty. For daily use a larger space may be needed.
 +
# Install GNU/Linux in that space
 +
# Add the latest version of Sugar (0.110)
  
 +
To use Sugar:
  
 +
# Boot the computer choosing GNU/Linux
 +
# Before entering the password, click on the 'desktop' icon. Choose Sugar.
 +
# To quit
 +
## switch to the Home View (key f4)
 +
## right-click on the XO icon in the center of the screen
 +
## click on log out or shutdown as appropriate
  
−
<noinclude>
+
[[File:Ubuntu-small.jpg|link=Ubuntu]]
−
These are the steps for installing Sugar on a Stick on a USB/SD device.  
+
===Ubuntu 17.04 Zesty===
  
−
This page is transcluded to various installation instruction pages.</noinclude>
+
{| style="text-align: center"
−
<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>
+
# The latest version of Sugar (0.110) can be installed by typing:<br><br>
−
[root@MyComputer ~]# blkid
+
<code>sudo apt install sucrose</code>
−
/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.
+
|[[File:Debian-small.jpg|link=Debian]]
−
 
+
===Debian GNU/Linux 9 "Stretch"===
−
It is OK to use this media.
+
{|
−
Copying live image to target device.
+
# install Debian ''Jessie'' in the usual way, see [https://www.debian.org/ debian.org],
−
squashfs.img
+
# change <tt>/etc/apt/sources.list</tt> to use the Debian ''Stretch'' testing release,
−
    630,784,000 100%    1.96MB/s    0:05:06 (xfr#1, to-chk=0/1)
+
##<code>sudo sed -i 's/jessie/stretch/g' /etc/apt/sources.list</code>
−
osmin.img
+
##<code>sudo apt update</code>
−
          8,192 100%    0.00kB/s    0:00:00 (xfr#1, to-chk=0/1)
+
##<code>sudo apt dist-upgrade</code>
−
Updating boot config file
+
# install Sugar,<br>
−
Initializing persistent overlay file
+
## type <code>sudo apt install sucrose</code>
−
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>
 
−
: '''See these links to pages on the Sugar Labs wiki for GNU/Linux distributions where Sugar has been installed.'''
 
−
{{Note/note|Please note:|
 
−
* Development changes occur rapidly, and the documentation here lags the current state of systems development.
 
−
* For the latest information on any development project, visit their work sites.
 
−
* The 'Notes' column should indicate if the image is for pre-release testing.}}
 
−
 
 
−
{| style="text-align: center"
 
−
!Logo!!Name!!Latest<br>[[:Category:Platform_Cycle|Sugar]]!!Notes
 
−
|- style="height: 55px"
 
−
|[[File:Ubuntu-small.jpg|link=Ubuntu]]||[[Ubuntu]]||0.110||Ubuntu 17.04 Zesty
 
−
|-
 
−
|[[File:Debian-small.jpg|link=Debian]]||[[Debian]]||0.110||Debian Stretch
 
−
|-
 
−
|[[File:Debian-small.jpg|link=Debian]]||[[Debian on rpi3]]||0.110||Debian jessie
 
−
|- style="height: 55px"
 
−
|<span class="weblink">[[File:OLPCXO.png|middle|link=olpc:Releases]]</span>||<span class="weblink">[[OLPC:Releases|OLPC]]</span>||0.110||Prepared for XO laptops
 
−
|-
 
−
|[[File:Ubuntu-small.jpg|link=Ubuntu_on_rpi3]]||[[Ubuntu on rpi3]]||0.110||Ubuntu 17.04<br> (sugar on rpi3)
 
−
|-
 
−
|[[File:Fedora-small.jpg|link=Fedora]]||[[Fedora]]||0.108.1|| Primary distribution for Sugar (Fedora 25)
 
−
|-
 
−
|<span class="linkgroup">[[File:Soas-avocado.svg|200px|link=Sugar_on_a_Stick]]</span>||[[Sugar on a Stick]]||style="width: 55px;"|0.108.1|| Live CD/USB of the Sugar Learning Environment
 
−
|-
 
−
|[[File:Suse-small.jpg|link=OpenSUSE]]||[[OpenSUSE|openSUSE]]||0.107.2|| Part of the Linux for Education (Li-f-e) series
 
−
|-
 
−
|<span class="linkgroup">[[File:Trisquel_icon.png|link=Trisquel_On_A_Sugar_Toast]]</span>||[[Trisquel_On_A_Sugar_Toast |Trisquel Toast]]||0.102.0|| Based on Ubuntu
 
−
|-
 
−
|<span class="linkgroup">[[File:Mageia-2011.png|150px|link=Mageia]]</span>||[[Mageia]]||0.95.1|| Forked from Mandriva
 
−
|- style="height: 55px"
 
−
|<span class="linkgroup">[[File:Elementary.png|65px|link=http://wiki.sugarlabs.org/go/ElementaryOs]]</span>||[[ElementaryOs]]||0.94.1|| Based on Ubuntu 10.10 & [[Sweets Distribution]]
 
−
|- style="height: 55px"
 
−
|<span class="linkgroup">[[File:Fusion.png|50px|link=Fusion Linux]]</span>||[[Fusion Linux]]||0.94.1|| Remix of Fedora 16 with GNOME 3.2.1
 
−
|- style="height: 55px"
 
−
|<span class="linkgroup">[[File:LMD-small.png|100px|100px|link=Linux Mint]]</span>||[[Linux Mint]]||0.94.1|| mint 13 &  mint 14 Using [[Sweets Distribution]]
 
−
|- style="height: 55px"
 
−
|<span class="linkgroup weblink">[[File:Dextrose-mascotte-120x96.png|link=https://sugardextrose.org/projects/dextrose/wiki/DX3_release_info]]</span>||<span class="weblink">[https://sugardextrose.org/projects/dextrose/wiki/DX3_release_info Dextrose]</span>||0.92.4|| Prepared for XO laptops
 
−
|-
 
−
|<span class="linkgroup">[[File:LMD-small.png|100px|link=Linux_Mint_Debian_Edition]]</span>||[[Linux Mint Debian Edition]]||0.88.1||
 
−
|- style="height: 55px"
 
−
|<span class="linkgroup">[[File:Mandriva-small.png|link=Mandriva]]</span>||[[Mandriva]]||0.88.0||
 
−
|- style="height: 55px"
 
 
|}
 
|}

Latest revision as of 23:55, 25 April 2017


There are two ways to use Sugar on your own computer. SOAS (Sugar on a Stick) is a USB flash drive with Sugar which can be booted on your computer but does not change anything on your hard drive. The second way is to free some space on your hard drive and install a distribution of GNU/Linux which supports Sugar. The method allows you to choose your normal operating system or GNU/Linux with Sugar during boot.

Sugar on a Stick

MS Windows

Windows.gif




USB flash drive.jpg
  1. Download the latest Sugar on a Stick .iso file.

  2. 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.
  3. Boot: Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's BIOS setup, and then start up the computer.

GNU/Linux


Gnulinux.png


Download Mirabell.png

USB flash drive.jpg

  1. Download the latest Sugar on a Stick .iso file.

  2. Load:
    Here is a simple way to create a SOAS usb flash drive.
    1. Open a shell (command line interpreter)
    2. Type df -Th. This shows all of the mounted partitions (on your computer's hard drive.)
    3. Insert a USB flash drive (or SD Card) with 2 GB or more of free space into your computer
    4. After a few moment type df -Th 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].
    5. type cd ~/Downloads. Then type ls Fedora*.iso Assuming you downloaded to the Downloads folder, this will show the SOAS iso.
    6. Type sudo dd if=Fedora-SoaS-Live-x86_64-25-1.3.iso of=/dev/sdb bs=1M 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.
  3. Boot: Insert the USB stick into a bootable USB port on your computer. Set the option to "boot from USB" in your computer's BIOS setup, and then start up the computer.

Apple Mac OS X

Apple.gif


Download Mirabell.png

USB flash drive.jpg

  1. Download the latest Sugar on a Stick .iso file.

  2. Load:
    Here is a simple way to load a bootable USB on a Mac.
    1. Enter the Terminal: /Applications/Utilities/Terminal.
    2. Type diskutil list. You should see all the disk drives you have inserted into your computer.
    3. Insert the disk drive to which you want to write Sugar on a Stick.
    4. Type diskutil list again. You should see that your USB drive has been added to the list. If not, wait a while and repeat.
    5. Type hdiutil convert -format UDRW -o <Sugar on a Stick image file>.img <Sugar on a Stick image file> to convert the image into a bootable format.
    6. Type sudo diskutil unmountDisk <device name> to unmount the disk (it will not be ejected).
    7. Type sudo dd if=<Sugar on a Stick image file>.img.dmg of=<device name> bs=1m. sudo will ask for your password, and then dd will start writing the disk file.
    8. When dd finishes writing the disk file, type sudo diskutil eject <device name>.
  3. 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).


Note

SOAS sticks created with Windows or GNU/Linux can be booted on PC computers. SOAS sticks created using an Apple computer can be booted on an Apple computer.

Installing Sugar on your computer's hard drive

The procedure to install Sugar is:

  1. Free some space on the computer's hard drive
    1. For Windows, shrink the size of the D: partition or, if no D: partition, the C: partition.
    2. For GNU/Linux, use gparted, select the partition, choose move/resize, and add space after the partition (the size of the partition will be reduced accordingly).
    3. Sugar was designed for systems with very limited storage capacity. To test Sugar a space of 10GB should be plenty. For daily use a larger space may be needed.
  2. Install GNU/Linux in that space
  3. Add the latest version of Sugar (0.110)

To use Sugar:

  1. Boot the computer choosing GNU/Linux
  2. Before entering the password, click on the 'desktop' icon. Choose Sugar.
  3. To quit
    1. switch to the Home View (key f4)
    2. right-click on the XO icon in the center of the screen
    3. click on log out or shutdown as appropriate

Ubuntu-small.jpg

Ubuntu 17.04 Zesty

  1. The latest version of Sugar (0.110) can be installed by typing:

sudo apt install sucrose

|Debian-small.jpg

Debian GNU/Linux 9 "Stretch"

  1. install Debian Jessie in the usual way, see debian.org,
  2. change /etc/apt/sources.list to use the Debian Stretch testing release,
    1. sudo sed -i 's/jessie/stretch/g' /etc/apt/sources.list
    2. sudo apt update
    3. sudo apt dist-upgrade
  3. install Sugar,
    1. type sudo apt install sucrose
Retrieved from "https://wiki.sugarlabs.org/index.php?title=Get_sugar&oldid=100206"