Difference between revisions of "Supported systems"

Latest revision as of 01:35, 27 July 2012

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 XO laptops.

Some deployments use the 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 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 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.

Supported distributions

Sugar is supported by several GNU/Linux distributions. Sugar Labs does not support any specific distribution, but does focus development on Fedora and Debian, which helps SoaS and Ubuntu.

Logo	Name	Notes
	Sugar on a Stick	Live system of the Sugar Learning Environment
	Fedora	Fedora 34
	Ubuntu	Ubuntu 18.04 Bionic
	Debian	Debian Stretch, see also Live Build
	OLPC OS 16.04	OLPC OS for OLPC NL3 laptops based on Ubuntu 16.04 Xenial
	OLPC OS 13.x	OLPC OS for OLPC XO laptops based on Fedora 18
	openSUSE	Part of an Linux for Education (Li-f-e) series
	Trisquel Toast	Based on Ubuntu

Please note:

Development changes occur rapidly, and the text here lags the current state of systems development.
For the latest information on any development project, visit their work sites.

Matrix of Sugar solutions

There are many ways to run Sugar:

As a complete disk image on an existing machine;
As a session on a Linux system; or
As part of a complete hardware-software platform.

Technical considerations

A discussion of technical considerations regarding supported systems.

Sugar for various hardware systems

OLPC XO laptops
Macintosh
Intel processor
- Sugar on a Stick/Macintosh, another example
- VirtualBox on Mac OS X
PowerPC processor
- Fedora#PowerPC
- Ubuntu/PPC

Getting the Sugar sources

Distributors can find the latest sources for the sucrose components here. Each release page has as links to the release pages of earlier releases.

Updating Sugar to the latest version

XO laptops

Looking at Sugar variants

See Sugar System Stack for a picture of the software stack.

Starch

Starch is a complete disk image for Sugar.

Sucrose

Sucrose is the Sugar interface plus a set of demonstration activities. System maintainers should visit the Packaging Team page.

@@ 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]].
-==A matrix of Sugar "solutions"==
+==Supported distributions==
+{{:Supported distributions}}
+==Matrix of Sugar solutions==
 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 using 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 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
-|}
-===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
-|-
-|Debian||4.0|| ||Yes||Yes||[[Community/Distributions/Debian | Sugar on Debian]]
-|-
-|Fedora||7,8,9|| ||Yes||Yes||[http://wiki.laptop.org/go/Sugar_on_Fedora Sugar on Fedora]
-|-
-|Ubuntu||8.04 (Hardy)||0.79.0-0ubuntu3||Yes||Yes||[[Community/Distributions/Ubuntu | Sugar on Ubuntu]]
-|-
-| ||8.04 (Hardy)||0.81.5||No|| ||[[Community/Distributions/Ubuntu | Sugar on Ubuntu]]
-|-
-|colspan=6 align=center|packages not pre-built
-|-
-|Gentoo||"[amd64] as of 2007-12-13"[http://wiki.laptop.org/go/Sugar_on_Gentoo_Linux]|| || ||Yes||[http://wiki.laptop.org/go/Sugar_on_Gentoo_Linux Sugar on Gentoo]
-|-
-|MacOS X|| || || || ||[http://wiki.laptop.org/go/Sugar_on_MacOS_X Sugar on MacOS X]
-|-
-|Slackware||12|| || || ||[http://wiki.laptop.org/go/Sugar_on_Slackware Sugar on Slackware]
-|-
-|Windows||XP|| || ||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 ==
-Distributors can find the latest sources for the sucrose components [http://wiki.sugarlabs.org/go/ReleaseTeam/CurrentRelease/Sucrose 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]]
-===Ubuntu===
+==Looking at Sugar variants==
-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===
-===Debian===
+[[Image:Sugar-on-CD-USB.jpg]]
-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].
+[[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.
+===Sucrose===
-===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:
+[[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.
-  -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>