Changes

7,586 bytes removed ,  02:35, 27 July 2012
m
Pop HD page up to make links shorter
Line 1: Line 1: −
<noinclude>{{ GoogleTrans-en | es =show | bg =show | zh-CN =show | zh-TW =show | hr =show | cs =show | da =show | nl =show | fi =show | fr =show | de =show | el =show | hi =show | it =show | ja =show | ko =show | no =show | pl =show | pt =show | ro =show | ru =show | sv =show }}</noinclude>
+
<noinclude>[[Category:Supported systems]]</noinclude>
 +
=== Ways to run Sugar ===
 +
Determine which of the various methods of running Sugar meet your needs:
 +
* '''Run Sugar pre-installed in a computer'''
 +
*: Some computers come with Sugar pre-installed, most notably the [[olpc:Hardware|OLPC XO laptops]].
 +
*: Some deployments use the [https://sugardextrose.org/ Dextrose] distribution of Sugar.
 +
* '''Boot a Live CD / Live USB pre-installed with Sugar'''
 +
*: Suitable for trying Sugar without having to install any software on almost any computer&mdash;just boot Sugar off of a CD or USB drive. '''Note:''' When booting a Live CD, the Journal is not automatically saved on shutdown, because the boot media is readonly. All changes are lost upon shutdown or reboot. This is not a limitation for Live USB installations.  See our [[Sugar on a Stick]] project page or other [[:Category:Live USB|Live USB projects]].
 +
* '''Install Sugar'''
 +
*: If you are running one of the currently supported distributions, you can install Sugar using your systems standard package manager, e.g., Synaptic, apt-get, or yum. See [[Fedora#Sugar_Learning_Environment|these instructions]].
 +
*: The [[Harmonic Distribution]] of the Sugar Learning Platform may also appeal to you.
 +
* '''Install an emulator or virtualizer and launch a bootable Sugar disk image file'''
 +
*: [[QEMU]], [[VirtualBox]], or [[VMware]] let you run Sugar in an emulator or by virtualization on your computer&mdash;you'll need to install an emulator from which you launch Sugar and one of the [[Emulator image files]].
   −
==Try Sugar==
+
==Supported distributions==
This page is intended to give instructions on how to try Sugar:
+
{{:Supported distributions}}
 
  −
''Step 1.'' Determine which of the various methods of running Sugar meet your needs:
  −
;LiveCD/LiveUSB:Suitable for trying Sugar without having to install any software on almost any computer&mdash;just boot Sugar off of a CD or USB drive.
  −
;Emulator:QEMU or VMWare let you run Sugar in an emulator on your computer&mdash;you'll need to install an emulator from which you launch Sugar.
  −
;Install Sugar:If you are running one of the currently supported distributions, you can install Sugar using your systems standard package manager, e.g., Synaptic, apt-get, or yum.
  −
;Build Sugar:You can run sugar-jhbuild to build the complete Sugar environment on most GNU/Linux systems.
  −
;Pre-installed Sugar: Some computers come with Sugar pre-installed, most notably the OLPC-XO-1 laptop.
  −
 
  −
''Step 2.'' Refer to the [[#Matrix of Sugar solutions|matrix]] below to find a Sugar solution that works for you.
  −
 
  −
=== Computer labs ===
  −
 
  −
Bill Kerr has written up instructions for trying Sugar in computer labs which run only Windows
  −
(Please see [http://billkerr2.blogspot.com/2008/07/evaluating-sugar-in-developed-world.html]).
  −
 
  −
Caroline Meeks is developing a deployment model that only requires one USB stick per child (Please see [[DeploymentTeam/School_Key]]).
      
==Matrix of Sugar solutions==
 
==Matrix of Sugar solutions==
Line 24: Line 20:  
* As a [[#Starch|complete disk image]] on an existing machine;
 
* As a [[#Starch|complete disk image]] on an existing machine;
 
* As a [[#Sucrose|session]] on a Linux system; or
 
* As a [[#Sucrose|session]] on a Linux system; or
* As part of a [[#Systems|complete hardware-software platform]].
+
* As part of a complete hardware-software platform.
 
  −
(A discussion of '''technical considerations''' regarding supported systems is found [[Supported systems/Technical considerations|here]].)
  −
 
  −
===Starch===
  −
 
  −
[[Image:Sugar-on-CD-USB.jpg]]
  −
 
  −
[[Taxonomy#Starch.28es.29:_A_complete_disk_image_for_Sugar|Starch]] is a complete disk image for Sugar.
  −
 
  −
{|border=1
  −
|+ '''A complete disk image for Sugar'''
  −
|-
  −
!Name
  −
!Sugar Version
  −
!Tested
  −
!Notes
  −
|-
  −
|[ftp://rohrmoser-engineering.de/XO-LiveCD/XO-LiveCD_081106.iso LiveBackup XO-LiveCD]
  −
|0.82
  −
|No
  −
|This is a Live CD of the OLPC system. [ftp://rohrmoser-engineering.de/XO-LiveCD/XO-LiveCD_081106.pdf Release Notes]
  −
|-
  −
|[[Image:Fedora.jpg|30px]][http://download.sugarlabs.org/sugar/liveimages/fedora-sugar-spin/fedora-sugar-spin-0.82-i686.iso LiveBackup Fedora-LiveCD]
  −
|0.82
  −
|Yes
  −
|This is a Fedora Live CD of the Sugar system
  −
|-
  −
|[[Image:Ubuntu.jpg|30px]][http://dev.laptop.org/~probono/sbuntu/ Ubuntu LiveCD/LiveUSB]
  −
|0.82
  −
|
  −
|Instructions for installing a Ubuntu LiveUSB
  −
|}
  −
 
  −
===Sucrose===
  −
 
  −
[[Taxonomy#Sucrose:_The_interface.2C_plus_a_set_of_demonstration_activities|Sucrose]] is the Sugar interface plus a set of demonstration activities.
     −
{|border=1
+
===[[/Technical considerations | Technical considerations]]===
|+ '''The interface, plus a set of demonstration activities'''
+
: A discussion of '''technical considerations''' regarding supported systems.
|-
  −
!Operating System !! Version !! Sugar Version !! Bundled !! Tested !! Notes
  −
|-
  −
|colspan=6 align=center|binary packages available
  −
|-
  −
|[[Image:Debian.jpg|30px]]Debian||4.0||0.82||Yes||Yes||[[Community/Distributions/Debian | Sugar on Debian]]
  −
|-
  −
|[[Image:Fedora.jpg|30px]]Fedora||7,8,9||0.82||Yes||Yes||[[Community/Distributions/Fedora | Sugar on Fedora]]
  −
|-
  −
|[[Image:Ubuntu.jpg|30px]]Ubuntu||8.04 (Hardy)||0.79.0-0ubuntu3||Yes||Yes||[[Community/Distributions/Ubuntu | Sugar on Ubuntu]]
  −
|-
  −
| ||8.04 (Hardy)||0.82||Yes|| ||[[Community/Distributions/Ubuntu#Sucrose_0.82 | Sugar on Ubuntu]]
  −
|-
  −
|colspan=6 align=center|packages not pre-built
  −
|-
  −
|[[Image:Gentoo-logo.svg|30px]]Gentoo||[x86] [amd64] 2008-10-31||0.83.1||Yes||Yes||[[Community/Distributions/Gentoo | Sugar on Gentoo]]
  −
|-
  −
|MacOS X|| || || || ||[http://wiki.laptop.org/go/Sugar_on_MacOS_X Sugar on MacOS X]
  −
|-
  −
|[[Image:Slackware.png|65px]]||Slackware 12|| || || ||[http://wiki.laptop.org/go/Sugar_on_Slackware Sugar on Slackware]
  −
|-
  −
|[[Image:XP.gif|78px]]||WindowsXP|| || ||No||[http://dev.laptop.org/~wadeb/OLPC-XO-Software-8.2.0-Setup.exe Wade Brainerd has built a Sugar installer for Windows (using QEMU)]
  −
|}
      
===Sugar for various hardware systems===
 
===Sugar for various hardware systems===
Since Sugar is now available on most major GNU/Linux distributions, it is possible to run Sugar almost any computer that can run GNU/Linux. We highlight some systems below. Please add your favorite to the list.
+
* [[OLPC|OLPC XO laptops]]
 
+
* [[Macintosh]]
{|border=1
+
*: Intel processor
|+ '''Complete Sugar Solutions'''
+
*:* [[Sugar on a Stick/Macintosh]], [[Testing/Reports/Sugar on a Stick#MacBook_Persistent_SoaS_v5_and_SoaS_v6_EFI_Boot_USB|another example]]
|-
+
*:* [[VirtualBox#on_Mac_OS_X|VirtualBox on Mac OS X]]
!Manufacturer
+
*: PowerPC processor
!Model
+
*:* [[Fedora#PowerPC]]
!Operating System
+
*:* [[Ubuntu/PPC]]
!Tested
  −
!Notes
  −
|-
  −
| [http://www.laptop.org OLPC]
  −
| XO-1
  −
| Fedora 9
  −
| Yes
  −
| Standard (reference) distribution
  −
|-
  −
| [http://www.asus.com ASUSTeK]
  −
| Eee PC
  −
|
  −
| In initial testing phase
  −
|
  −
|-
  −
| [http://www.intel.com Intel]
  −
| Classmate Gen 1 & Gen 2
  −
|
  −
| under development
  −
|
  −
|}
      
== Getting the Sugar sources ==
 
== Getting the Sugar sources ==
Distributors can find the latest sources for the sucrose components [[ReleaseTeam/CurrentRelease/Sucrose#Getting_the_sources|here]]. Each [http://sugarlabs.org/go/ReleaseTeam/Roadmap#Schedule sucrose roadmap] entry has as well links to the release pages of earlier releases.
+
Distributors can find the latest sources for the sucrose components [[Development Team/Release/Modules|here]]. Each [[{{Current Stable Release}}| release page]] has as links to the release pages of earlier releases.
   −
==Updating Sugar to the Latest Version==
+
==Updating Sugar to the latest version==
 +
=== XO laptops ===
 +
* [[OLPC:Releases]]
 +
* [https://sugardextrose.org/ Dextrose development site] - [[Dextrose]]
   −
<span class="plainlinks">
+
==Looking at Sugar variants==
[http://wiki.sugarlabs.org/go/Community/Distributions/Ubuntu http://sugarlabs.org/wiki/images/e/e2/Ubuntu.jpg]
  −
</span>
  −
===Ubuntu===
     −
For a LiveCD/LiveUSB, check out the instructions [http://dev.laptop.org/~probono/sbuntu/].
+
See [[Sugar System Stack]] for a picture of the software stack.
   −
Updated sucrose packages are usually published in a PPA: See [[Community/Distributions/Ubuntu#Sugar_on_Ubuntu_8.04|here]] for details.
+
===Starch===
   −
If you want up-to-the-minute freshness (and brokenness) you can use [[DevelopmentTeam/Jhbuild|jhbuild]] to build from source instead of the released packages. Follow the instructions [[DevelopmentTeam/Jhbuild#Creating_an_xsession_for_Sugar-jhbuild|here]] to install sugar-jhbuild as an xsession option.
+
[[Image:Sugar-on-CD-USB.jpg]]
   −
<span class="plainlinks">
+
[[Taxonomy#Starch.28es.29:_A_complete_disk_image_for_Sugar|Starch]] is a complete disk image for Sugar.
[http://wiki.sugarlabs.org/go/Community/Distributions/Debian http://sugarlabs.org/wiki/images/a/a1/Debian.jpg]
  −
</span>
  −
===Debian===
  −
 
  −
Sucrose packages are usually updated in unstable. These packages migrate to testing after a while. You can see the current package versions [http://packages.debian.org/search?keywords=sugar&searchon=names&suite=all&section=all here].
  −
 
  −
If you want up-to-the-minute freshness (and brokenness) you can use [[DevelopmentTeam/Jhbuild|jhbuild]] to build from source instead of the released packages.
  −
 
  −
<span class="plainlinks">
  −
[http://wiki.sugarlabs.org/go/Community/Distributions/Fedora http://sugarlabs.org/wiki/images/1/1e/Fedora.jpg]
  −
</span>
  −
===Fedora===
  −
==== Fedora LiveCD/Live USB ====
  −
 
  −
The Fedora Sugar Spin incorporates the Sugar environment on a Fedora Live CD.
  −
 
  −
With this spin, you'll be able to run Sugar from a Live CD! You'll find several activities on the image including most notably...
  −
 
  −
* sugar-browse - a web browsing activity based on xulrunner
  −
* sugar-write - a word processor based on abiword
  −
 
  −
...among with several other applications introducing e.g. chat support.
  −
 
  −
The Fedora OLPC SIG will be importing further activities into Fedora, which might be installed using 'yum install sugar-*' at a later time.
  −
 
  −
Where can you get it? Easily, here:
  −
 
  −
http://download.sugarlabs.org/sugar/liveimages/fedora-sugar-spin/fedora-sugar-spin-0.82-i686.iso
  −
 
  −
Alternatively, you might want to refer to this, which is in fact the same image, just on another location:
  −
 
  −
http://alt.fedoraproject.org/pub/alt/olpc/0.82/i686/sugar-spin.iso
  −
 
  −
Please ''be aware'' of the fact that the link above has changed recently - the old one won't work anymore! For more information, please see this post: https://www.redhat.com/archives/fedora-olpc-list/2008-November/msg00003.html
  −
 
  −
And what if you wanted to put it onto a USB Key? Even easier!
  −
You'll just need to grab Luke Macken's liveusb-creator, which already
  −
includes support for the Sugar Spin. Here's the link:
  −
 
  −
https://fedorahosted.org/releases/l/i/liveusb-creator/liveusb-creator-3.0.zip
  −
 
  −
The liveusb-creator still contains the old link, which is the reason why you'll need to download the spin manually until this gets fixed.
  −
 
  −
'''Tip of the hat:''' Sebastian Dziallas and the Fedora team
  −
 
  −
==== Fedora on an OLPC XO ====
  −
 
  −
On an OLPC XO-1 laptop, run olpc-update as root.
  −
 
  −
Normally you only need to run ''olpc-update'' in the Terminal application with a build number, like this:
  −
 
  −
# olpc-update 703
  −
 
  −
'''Note:''' Now you can do this by means of the graphical [http://wiki.laptop.org/go/Sugar_Control_Panel Control Panel].
  −
 
  −
==== Update to the latest experimental version (a.k.a. Joyride) ====
  −
 
  −
<big><font color=red>Joyride is for developers; it is not supported. Joyride builds may cause data corruption and in rare cases, even cause hardware damage, so please do not use Joyride on mission-critical systems.</font></big>
  −
 
  −
Joyride contains all the "bleeding-edge" features that are being debugged for inclusion in the next release.
  −
 
  −
Open the Terminal application and type the following, substituting 2469 for the latest version number.
  −
 
  −
# olpc-update joyride-2469
  −
 
  −
'''What's the latest version?''' You can find the latest build number (shown above as 1779) at the bottom of http://xs-dev.laptop.org/~cscott/xo-1/streams/joyride/
  −
 
  −
Updates usually takes 10–15 minutes. It's advised that you plug your XO in while Sugar updates itself, then reboot it to see the new OS take effect.
  −
 
  −
==== Other Options ====
  −
 
  −
These are options that can be used with the update command:
  −
 
  −
# olpc-update --help
  −
<pre><nowiki>
  −
Usage:
  −
olpc-update [options] --hints hints-file
  −
olpc-update [options] [-rf] build-number
  −
olpc-update [options] [-rf] --usb
  −
olpc-update --version
  −
olpc-update --help
  −
 
  −
For example:
  −
olpc-update 630
  −
olpc-update joyride-1779
  −
olpc-update update.1-700
  −
 
  −
Options:
  −
  -h, --help    show this help message and exit
  −
  -f, --full    skip incremental update attempt.
  −
  --force      force update to an unsigned build.
  −
  -r, --reboot  reboot after a successful update.
  −
  --hints=FILE  name of json-encoded hints dictionary identifying the desired
  −
                new version.
  −
  -u, --usb    upgrade from new build on inserted USB stick.
  −
  -v            display verbose progress information; repeat for more verbose
  −
                output.
  −
  -q, --quiet  don't output anything; use exit status to indicate success.
  −
  --version    display version and license information.
  −
</nowiki></pre>
  −
 
  −
<span class="plainlinks">
  −
[http://wiki.sugarlabs.org/go/Community/Distributions/Gentoo http://sugarlabs.org/wiki/images/5/5e/Gentoo-logo-small.jpg]
  −
</span>
  −
===Gentoo===
  −
There are two methods to get Sugar on your Gentoo box: [[Community/Distributions/Gentoo#sugar-jhbuild|sugar-jhbuild]] and [[Community/Distributions/Gentoo#Sugar overlay|Sugar overlay]]. See [[Community/Distributions/Gentoo|Gentoo]] for details.
      +
===Sucrose===
   −
[[Category:Supported systems]]
+
[[Taxonomy#Sucrose:_The_interface.2C_plus_a_set_of_demonstration_activities|Sucrose]] is the Sugar interface plus a set of demonstration activities.  System maintainers should visit the [[Packaging Team]] page.