|
|
| (198 intermediate revisions by 23 users not shown) |
| 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.
| | ===[[/Technical considerations | Technical considerations]]=== |
| | : A discussion of '''technical considerations''' regarding supported systems. |
|
| |
|
| {|border=1
| | ===Sugar for various hardware systems=== |
| |+ '''The interface, plus a set of demonstration activities'''
| | * [[OLPC|OLPC XO laptops]] |
| |-
| | * [[Macintosh]] |
| !Operating System !! Version !! Sugar Version !! Bundled !! Tested !! Notes
| | *: 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]] |
| |colspan=6 align=center|binary packages available
| | *:* [[VirtualBox#on_Mac_OS_X|VirtualBox on Mac OS X]] |
| |-
| | *: PowerPC processor |
| |[[Image:Debian.jpg|30px]]Debian||4.0|| ||Yes||Yes||[[Community/Distributions/Debian | Sugar on Debian]]
| | *:* [[Fedora#PowerPC]] |
| |-
| | *:* [[Ubuntu/PPC]] |
| |[[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.jpg|30px]]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]
| |
| |-
| |
| |[[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===
| |
| {|border=1
| |
| |+ '''Complete Sugar Solutions'''
| |
| |-
| |
| !Manufacturer
| |
| !Model
| |
| !Operating System
| |
| !Tested
| |
| !Notes
| |
| |-
| |
| | [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>
| |
|
| |
|
| | ===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. |