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—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]]. |
| | | |
− | ==A matrix of Sugar "solutions"== | + | ==Supported distributions== |
| + | {{:Supported distributions}} |
| + | |
| + | ==Matrix of Sugar solutions== |
| There are many ways to run Sugar: | | There are many ways to run Sugar: |
− | * As a [[#Starch|separate disk image]] on an existing machine (Please see [[Documentation/Try_Sugar|Try Sugar]] for examples of running Sugar on top of other systems, e.g., MS-Windows); | + | * 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===
| |
− | | |
− | *[[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
| |
− | |-
| |
− | |[http://sdz.fedorapeople.org/olpc/sugar-spin.iso LiveBackup Fedora-LiveCD]
| |
− | |0.82
| |
− | |Yes
| |
− | |This is a Fedora Live CD of the Sugar system
| |
− | |}
| |
− | | |
− | ===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|| ||Yes||Yes||[[Community/Distributions/Debian | Sugar on Debian]]
| |
− | |-
| |
− | |[[Image:Fedora.jpg|30px]]Fedora||7,8,9|| ||Yes||Yes||[[Community/Distributions/Fedora | Sugar on Fedora]] (Also see [http://wiki.laptop.org/go/Sugar_on_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-23||0.82.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]
| |
− | |}
| |
| | | |
− | ===Sugar for Various Systems=== | + | ===Sugar for various hardware systems=== |
− | {|border=1
| + | * [[OLPC|OLPC XO laptops]] |
− | |+ '''Complete Sugar Solutions'''
| + | * [[Macintosh]] |
− | |-
| + | *: Intel processor |
− | !Manufacturer
| + | *:* [[Sugar on a Stick/Macintosh]], [[Testing/Reports/Sugar on a Stick#MacBook_Persistent_SoaS_v5_and_SoaS_v6_EFI_Boot_USB|another example]] |
− | !Model
| + | *:* [[VirtualBox#on_Mac_OS_X|VirtualBox on Mac OS X]] |
− | !Operating System
| + | *: PowerPC processor |
− | !Tested
| + | *:* [[Fedora#PowerPC]] |
− | !Notes
| + | *:* [[Ubuntu/PPC]] |
− | |-
| |
− | | [http://www.laptop.org OLPC]
| |
− | | XO-1
| |
− | | Fedora-7
| |
− | | 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]] |
| | | |
− | [[Image:Ubuntu.jpg]]
| + | ==Looking at Sugar variants== |
− | ===Ubuntu=== | |
| | | |
− | Updated sucrose packages are usually published in a PPA: See [[Community/Distributions/Ubuntu#Sugar_on_Ubuntu_8.04|here]] for details.
| + | See [[Sugar System Stack]] for a picture of the software stack. |
| | | |
− | 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.
| + | ===Starch=== |
| | | |
− | [[Image:Debian.jpg]] | + | [[Image:Sugar-on-CD-USB.jpg]] |
− | ===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].
| + | [[Taxonomy#Starch.28es.29:_A_complete_disk_image_for_Sugar|Starch]] is a complete disk image for Sugar. |
− | | |
− | 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.
| |
− | | |
− | [[Image:Fedora.jpg]]
| |
− | ===OLPC XO-1 (Fedora)===
| |
− | | |
− | ==== Update to the Latest Version ====
| |
− | | |
− | 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>
| |
− | | |
− | [[Image:Gentoo-logo-small.jpg]]
| |
− | ===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. |