Supported systems: Difference between revisions

m adjust Merge template discuss link
m Pop HD page up to make links shorter
 
(35 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<noinclude>[[Category:Supported systems]]</noinclude>
<noinclude>[[Category:Supported systems]]</noinclude>
{{Note/warning|Warning: Outdated Information|This page has not been updated in a long time. The links on this page, '''[[Community/Distributions]]''', are probably more current.}}
{{Merge|Community/Distributions|discuss=Talk:Community/Distributions#Merge page}}
{{Note/note|Please note:| Development changes occur rapidly, and the documentation here lags the current state of systems development.  For the latest information on any development project, visit their work sites.}}
See [[Sugar System Stack]] for a picture of the software stack.
=== Ways to run Sugar ===
=== Ways to run Sugar ===
Determine which of the various methods of running Sugar meet your needs:
Determine which of the various methods of running Sugar meet your needs:
* '''Pre-installed Sugar:'''
* '''Run Sugar pre-installed in a computer'''
*: Some computers come with Sugar pre-installed, most notably the OLPC XO-1 laptop.
*: Some computers come with Sugar pre-installed, most notably the [[olpc:Hardware|OLPC XO laptops]].
* '''Live CD / Live USB:'''
*: Some deployments use the [https://sugardextrose.org/ Dextrose] distribution of 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.
* '''Boot a Live CD / Live USB pre-installed with Sugar'''
* '''Install 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]].
*: 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.
* '''Install Sugar'''
*: Make custom Fedora F11/F12 Sugar Install or Live DVD/CD's [http://wiki.sugarlabs.org/go/Community/Distributions/Fedora#Make_you_own_custom_Fedora_F11.2F12_Install_or_Live_DVD.2FCD.27s]
*: 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]].
* '''Emulator/Virtualizer:'''
*: 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]].
*: [[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]].


Refer to the [[#Matrix of Sugar solutions|matrix]] below to find a Sugar solution that works for you.
==Supported distributions==
 
{{:Supported distributions}}
=== 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 [[Sugar on a Stick]].)


==Matrix of Sugar solutions==
==Matrix of Sugar solutions==
Line 30: 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.


===[[/Technical considerations | Technical considerations]]===
===[[/Technical considerations | Technical considerations]]===
: A discussion of '''technical considerations''' regarding supported systems.
: A discussion of '''technical considerations''' regarding supported systems.
===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.
===Sucrose===
[[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.


===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]]
 
*: Intel processor
MacBook Air
*:* [[Sugar on a Stick/Macintosh]], [[Testing/Reports/Sugar on a Stick#MacBook_Persistent_SoaS_v5_and_SoaS_v6_EFI_Boot_USB|another example]]
OSX 10.6.6  (Virtualbox 4.0.2)[[Emulator_image_files#VirtualBox]] VirtualBox runs on most hardware and OS's
*:* [[VirtualBox#on_Mac_OS_X|VirtualBox on Mac OS X]]
Works well in VirtualBox including wireless and magic mouse
*: PowerPC processor
Burned Soas.iso for Soas-v4 and Soas-v3 boot fine
*:* [[Fedora#PowerPC]]
[[Downloads#Apple_Mac_OS_X Apple Mac OS X]]<br>[[Sugar on a Stick/Mac]]
*:* [[Ubuntu/PPC]]
 


== Getting the Sugar sources ==
== Getting the Sugar sources ==
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.
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]]


[[File:Ubuntu.jpg|link=Community/Distributions/Ubuntu]]
==Looking at Sugar variants==


===Ubuntu===
See [[Sugar System Stack]] for a picture of the software stack.


'''[[Community/Distributions/Ubuntu]]'''
===Starch===
: UbuntuSugarRemix and 10.04LTS


'''https://wiki.ubuntu.com/Sugar'''
[[Image:Sugar-on-CD-USB.jpg]]
: UbuntuSugarRemix


The Sugar packages in
[[Taxonomy#Starch.28es.29:_A_complete_disk_image_for_Sugar|Starch]] is a complete disk image for Sugar.
Ubuntu 9.04 and 8.10 [[Community/Distributions/Ubuntu#Using_sugar_PPAs]].


For a LiveCD/LiveUSB, check out the instructions [http://dev.laptop.org/~probono/sbuntu/].'''(Note that this produces a very old sugar version 0.82.1)'''
===Sucrose===


Updated sucrose packages are usually published in a PPA: See [[Community/Distributions/Ubuntu#Sugar_on_Ubuntu_8.04|here]] for details.
[[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.
 
If you want up-to-the-minute freshness (and brokenness) you can use [[Development Team/Jhbuild|jhbuild]] to build from source instead of the released packages. Follow the instructions [[Development Team/Jhbuild#Creating_an_xsession_for_Sugar-jhbuild|here]] to install sugar-jhbuild as an xsession option.
 
 
[[File:Debian.jpg|link=Community/Distributions/Debian]]
===Debian===
 
[[Community/Distributions/Debian]]
*sugar 0.88.0 works nicely in Debian squeeze
 
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 [[Development Team/Jhbuild|jhbuild]] to build from source instead of the released packages.
 
[[File:Fedora.jpg|link=Community/Distributions/Fedora]]
===Fedora===
 
==== Fedora LiveCD/Live USB ====
:Project page: http://fedoraproject.org/wiki/Sugar (superseding: http://fedoraproject.org/wiki/Sugar_Spin)
 
With this spin, you'll be able to run Sugar, which is developed by Sugarlabs and the desktop environment used on the OLPC, directly 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
 
...along with several other activities including Chat support.
 
:See our [[Sugar_on_a_Stick | Sugar on a Stick page]].
 
The Fedora OLPC SIG, https://fedoraproject.org/wiki/OLPC, will be importing further activities into Fedora, which might be installed using ''yum install sugar-*'' at a later time.
 
:Recent development spins:
::http://download.sugarlabs.org/soas/snapshots/1/
 
For more information, please refer to the announcement here:
 
https://www.redhat.com/archives/fedora-olpc-list/2008-December/msg00061.html
 
Fedora 11 Preview contains USB Creator which can make USB and SD's with persistence of Fedora F11 (and Sugar if added with Synaptic) and Soas-beta's [satellit 04/30/2009]
 
What if you wanted to put it quickly onto your USB Key? You'll just need to grab Luke Macken's liveusb-creator, which already includes support for the Sugar Spin. Here's the link:
 
:http://fedorahosted.org/liveusb-creator/
 
The liveusb-creator still contains an 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:
 
# sudo olpc-update 767
 
'''Note:''' Now you can do this by means of the graphical [[olpc:Sugar Control Panel|Sugar Control Panel]].
 
===OLPC Clean Install===
 
http://wiki.laptop.org/go/Clean-install_procedure
 
 
====Joyride====
See [[OLPC:Future releases]], the Joyride train is in the round house.
 
<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>
 
 
[[File:Gentoo-logo-small.jpg|link=Community/Distributions/Gentoo]]
 
 
==== Fedora on the XO-1 ====
 
One of the updated  ways of installing sugar on the XO can be seen here.
 
http://wiki.laptop.org/go/F11_for_XO-1
 
==== SOAS on the XO ====
You can also install  sugar on a stick on the XO-1
* [[Sugar_on_a_Stick/Installation/OLPC]]
 
===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.
 
<span class="linkgroup">
[[File:Alt_linux_team_tiny.png|link=Community/Distributions/ALTLinux]]
</span>
 
===ALT Linux===
* ALT Linux Team is an international software developers team, collectively working on [http://en.altlinux.org/Sisyphus Sisyphus].
 
*'''To install''' Sugar try these [[Community/Distributions/ALTLinux#Setup|packages]].
 
<span class="linkgroup">
[[File:Mandriva.png|link=Community/Distributions/Mandriva]]
</span>
 
===Mandriva===
To install Sugar on Mandriva follow these [[Community/Distributions/Mandriva#Setup|instructions]].