5,705
edits
Changes
Jump to navigation
Jump to search
mLine 1:
Line 1: − + + + + + + + + + + + + + − + − This page is intended to give instructions on how to try Sugar:+ − − ''Step 1.'' Determine which of the various methods of running Sugar meet your needs: − ;LiveCD/LiveUSB:Suitable for trying Sugar without having to install anything software on almost any computer—just boot Sugar off of a CD or USB drive. − ;Emulator:QEMU or VMWare let you run Sugar in an emulator on your computer—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]]). Line 24:
Line 20: − + − − (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 − |- − |[http://wiki.laptop.org/go/LiveBackup_XO-LiveCD LiveBackup XO-LiveCD] − |0.75.13-1 − |Yes − |This is a Live CD of the OLPC system − |- − |[[Image:Fedora.jpg|30px]][http://alt.fedoraproject.org/pub/alt/olpc/0.82/i686/sugar-spin.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+ − |+ '''The interface, plus a set of demonstration activities'''+ − |- − !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://wiki.laptop.org/go/Sugar_on_Windows Sugar on Windows]<br/>[http://lists.laptop.org/pipermail/devel/2008-September/019643.html Tom van Overbeek describes how to run Sugar using QEMU] − |} − + − 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.+ − + − {|border=1+ − |+ '''Complete Sugar Solutions'''+ − |-+ − !Manufacturer + − !Model + − !Operating System+ − !Tested − !Notes − |- − | [http://www.laptop.org OLPC] − | XO-1 − | Fedora 9 − | Yes − | Standard (reference) distribution − |- − | [http://www.asus.com ASUSTeK] − − | − | In initial testing phase − | − |- − | [http://www.intel.com Intel] − | Classmate Gen 1 & Gen 2 − | − | under development − | − |} − + − + + + + − <span class="plainlinks">+ − [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/].+ − Updated sucrose packages are usually published in a PPA: See [[Community/Distributions/Ubuntu#Sugar_on_Ubuntu_8.04|here]] for details.+ − 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.+ − <span class="plainlinks">+ − − </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§ion=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://alt.fedoraproject.org/pub/alt/olpc/0.82/i686/sugar-spin.iso − − 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 − − '''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. + − +
Pop HD page up to make links shorter
<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—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—you'll need to install an emulator from which you launch Sugar and one of the [[Emulator image files]].
==Try Sugar==
==Supported distributions==
{{:Supported distributions}}
==Matrix of Sugar solutions==
==Matrix of Sugar solutions==
* 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.
===[[/Technical considerations | Technical considerations]]===
: A discussion of '''technical considerations''' regarding supported systems.
===Sugar for Various Systems===
===Sugar for various hardware systems===
* [[OLPC|OLPC XO laptops]]
* [[Macintosh]]
*: Intel processor
*:* [[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]]
*: PowerPC processor
*:* [[Fedora#PowerPC]]
*:* [[Ubuntu/PPC]]
| Eee PC
== 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]]
==Looking at Sugar variants==
See [[Sugar System Stack]] for a picture of the software stack.
===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.
[http://wiki.sugarlabs.org/go/Community/Distributions/Debian http://sugarlabs.org/wiki/images/a/a1/Debian.jpg]
===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.