|
|
| (126 intermediate revisions by 14 users not shown) |
| Line 1: |
Line 1: |
| <noinclude>{{ Translations | [[Downloads|english]] | [[Downloads/lang-es|español]] | [[Downloads/lang-fr|français]] | [[Downloads/lang-no|Norsk]] }}__NOEDITSECTION__</noinclude>
| | me{{ Translations | [[Downloads|english]] | [[Downloads/lang-es|español]] | [[Downloads/lang-fr|français]] | [[Downloads/lang-no|norsk]] }}__NOEDITSECTION__</noinclude> |
| {{:Downloads/Landing_page}}
| |
| __NOTOC__
| |
|
| |
|
| <br/><br/>
| |
| ==Are you new to Sugar?== | | ==Are you new to Sugar?== |
| | There are two Live Systems that run Sugar from a USB stick or bootable DVD: |
| | * '''[[Sugar on a Stick]]''' based on Fedora, runs on 64-bit PCs and OS/X Macintoshes, OLPC XO and Raspberry Pi, in English only |
| | * '''[[Trisquel On A Sugar Toast]]''', runs on 32- and 64-bit PCs and has more Activities and world language support |
|
| |
|
| The easiest way to get started is to use [[Sugar on a Stick]]. Basic instructions are found below. A more detailed [http://download.sugarlabs.org/soas/docs/creation-kit/ Sugar-on-a-Stick Creation Guide] is also available. (If you already use GNU/Linux, you may want to install the [[#Do_you_use_GNU.2FLinux.3F|Sugar packages]] available from your distro.)
| | If you have a high-speed Internet connection, '''Fedora with the Sugar graphical learning environment''' may be installed to a hard disk or a a 4 GB USB stick with a [[Tutorials/Installation/Install with netinstall|'''Netinstall CD''']] |
| ----
| |
| === MS Windows ===
| |
|
| |
|
| {|
| | ==Do you use GNU/Linux?== |
| |-
| | {{:Supported distributions}} |
| |width="160px" valign="top"|[[File:Windows.gif|left|link=Sugar on a Stick/Windows]]
| |
| <br><br><br>
| |
| <span class="linkgroup">[[File:Download Mirabell.png|left|link=http://spins.fedoraproject.org/soas/#downloads]]</span>
| |
| [[File:USB flash drive.jpg|left|156px|link=http://spins.fedoraproject.org/soas/#downloads]]
| |
| |valign=top|
| |
| # '''Prepare''': [http://fedorahosted.org/liveusb-creator/#Download Download] the Fedora Live USB Creator from [http://fedorahosted.org/liveusb-creator/#Download FedoraHosted]<br><br>
| |
| # '''Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick iso.<br><br>
| |
| # '''Load''': Insert a USB flash drive (or SD Card) with 1 GB or more of free space into your computer and launch Fedora Live USB Creator to create a Sugar-on-a-Stick bootable image.<br/>'''Note''': Be sure to set the ''persistent storage'' slider to a non-zero value.<br><br>
| |
| # '''Boot''': Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's <abbr title="Basic Input/Output System">BIOS</abbr> setup, and then start up the computer.
| |
| |}
| |
| | |
| Detailed [[Sugar on a Stick/Windows|installation instructions for Windows]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Sugar on a Stick/Explore|guide to exploring Sugar on a Stick]].
| |
| ----
| |
| === GNU/Linux ===
| |
| GNU/Linux users may want to install the [[#Do_you_use_GNU.2FLinux.3F|Sugar packages]] on their favorite distro.
| |
| | |
| {|
| |
| |-
| |
| |width="160px"|<span class="linkgroup">[[File:Gnulinux.png|link=Sugar on a Stick/Linux]]
| |
| <br>
| |
| [[File:Download Mirabell.png|left|link=http://spins.fedoraproject.org/soas/#downloads]]</span>
| |
| [[File:USB flash drive.jpg|156px|link=http://spins.fedoraproject.org/soas/#downloads]]
| |
| |valign=top|
| |
| # '''Prepare''': Use this script http://bit.ly/livecd-iso-to-disk to create a bootable image.<br>(Run {{Code|chmod +x livecd-iso-to-disk.sh}} after you download the script to make it executable.)<br><br>
| |
| # '''Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick iso.<br><br>
| |
| # '''Load''': Execute, as the root user, in <u>one</u> command with arguments, the following:
| |
| #:{{Code|./livecd-iso-to-disk.sh --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home /path/to/source.iso /dev/sd'''?'''1}}
| |
| #: where '{{Code|'''?'''}}' in the final parameter represents the target bootable device node, such as {{Code|sdb1}} or {{Code|sdc1}}, etc.<br><br>
| |
| # '''Boot''': Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's <abbr title="Basic Input/Output System">BIOS</abbr> setup, and then start up the computer.
| |
| |}
| |
|
| |
|
| Detailed [[Sugar on a Stick/Linux|installation instructions for GNU/Linux]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Sugar on a Stick/Explore|guide to exploring Sugar on a Stick]].
| | ===Are you a developer?=== |
| ----
| |
| === Apple Mac OS X === | |
| '''DRAFT''': These instructions are incomplete. Please help with testing and documentation. In the meantime, we recommend the '''[[#Virtual Machines on all platforms|Virtual Machines instructions]]''' below.
| |
| {| | | {| |
| |- | | |- |
| |width="160px" valign="top"|[[File:Apple.gif|link=Sugar_on_a_Stick/Mac]] | | |width="174px" valign=top|[[File:Gear.png|link=Development Team]] |
| <br>
| | |Please see this [http://developer.sugarlabs.org/ developer documentation website] for the sugar-build development environment. |
| <span class="linkgroup">[[File:Download Mirabell.png|left|link=http://spins.fedoraproject.org/soas/#downloads]]</span>
| |
| [[File:USB flash drive.jpg|156px|link=http://spins.fedoraproject.org/soas/#downloads]]
| |
| |valign=top| | |
| # '''Prepare''': These instructions are only for '''64-bit''' processor machines. (To identify the processor type, choose Apple menu > About This Mac. A small window will appear titled ''About This Mac''. The processor type is displayed in this window. Sugar on a Stick is for the Intel processor only.)<br><br>
| |
| # '''Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick iso. Be sure to download a '''64-bit''' image.<br><br>
| |
| # '''Load''': <span style="background-color:#f9f6b7; border: 1px solid #c4c295; padding: 10px; padding-left: 5px;">[[File:question.png|link=|middle]] '''Help: Does someone have a simple way to load a Live USB on a Mac?'''</span><br><br>
| |
| :::'''[http://wiki.sugarlabs.org/go/Sugar_Creation_Kit#Building_a_bootable_USB Building and Booting_a_live_USB on a Mac]'''
| |
| # '''Boot''': Insert the USB stick into a USB port on your computer. '''Is this correct?''': During the startup sound, press and hold the '''c''' key. If the Apple logo appears, Sugar is not booting. Restart and try again.
| |
| #* the '''c''' key must be pressed during the startup sound and you must continue to hold it down.
| |
| #* you may release the '''c''' key once the Sugar logo appears.
| |
| * Have a MAC Book Air? See
| |
| : [http://wiki.sugarlabs.org/go/Mac_OS_X-Boot_USB_with_Virtualbox#Running_Soas_files_on_a_2nd_USB_in_Virtualbox_3.2_installed_on_the_MacBook_Air Running_Soas_files_on_a_2nd_USB_in_Virtualbox_3.2_installed_on_the_MacBook_Air]
| |
| : [http://wiki.sugarlabs.org/go/Sugar_Creation_Kit#Building_a_bootable_USB Building_a_bootable_USB]
| |
| : [http://lists.sugarlabs.org/archive/iaep/2010-November/012019.html Soas-v4 on a MacBook Air]
| |
| : [http://wiki.sugarlabs.org/go/Mac_OS_X-Boot_USB_with_Virtualbox#Mac_OSX-F14-desktop_with_Virtualbox_Boot_USB Mac_OSX-F14-desktop_with_Virtualbox_Boot_4GB USB]
| |
| :: Opens a 2nd USB with a Soas-v3 virtual appliance. Note that the 2nd USB can be exchanged for use by another student, who can eject his USB and keep it till his next session.
| |
| |}
| |
|
| |
|
| Alternative [[Sugar on a Stick/Mac|installation instructions for Mac OS X]]. Also, [[Sugar_on_a_Stick/Blueberry#For_Mac_OS_X_Users|these older installation instructions]] and [[Sugar on a Stick/Boot|booting instructions]] may be consulted.<br>There is also a [[Sugar on a Stick/Explore|guide to exploring Sugar on a Stick]].
| |
| ----
| |
| === Advanced users ===
| |
|
| |
|
| {|
| | Some additional references you may find useful: |
| |-
| | * See https://github.com/sugarlabs/, |
| |width="174px"|[[File:Sugar Creation Kit.png|link=Sugar Creation Kit]]
| | * [http://git.sugarlabs.org Gitorious source code repository], |
| |valign=top|
| | * The [[Supported systems]] page, |
| * '''Explore''' the [[Sugar Creation Kit]] | | * [[Platform_Team/Guide/Sweets Usage|Sweets]], to launch Sugar using the Sugar Package Management System, |
| | | * [[Emulator image files|Virtual machine or emulator image files]], |
| | | * Adding Sugar to your [[Sweets_Distribution/Supported_platforms|favorite distro...]] |
| * '''Try''' [[Sugar_on_a_Stick/Installation/Variations|customizing]] Sugar on a Stick; | |
| | |
| | |
| * '''Read''' the [http://download.sugarlabs.org/soas/docs/customization-guide/ detailed Customization Guide]; and | |
| | |
| | |
| * '''Read''' additional instructions for using [[VirtualBox]] and other virtual machines. | |
| |} | | |} |
|
| |
|
| <br/><br/> | | <br/><br/> |
| ==Do you have an OLPC XO?==
| |
|
| |
| {|
| |
| |-
| |
| |width="174px"|[[File:OLPCXO.png|middle|link=Dextrose]]
| |
| |valign=top|
| |
| * '''Upgrade''' to [[Deployment_Team/Fedora_on_the_XO-1 |Sugar 0.84 with Fedora 11 and Gnome]], the ''[[olpc:OS_images#Stable_builds|stable]]'' OLPC release
| |
|
| |
| * '''Upgrade''' to [[Dextrose |Dextrose Sugar 0.88 with Fedora 11 and Gnome]] (requires a ''[[olpc:Activation_and_developer_keys|developer key]]'')
| |
|
| |
| * '''Load ''' another one of the [[OLPC:OS images]]
| |
|
| |
| * '''Test''' Sugar 0.90 on Fedora 14 [[OLPC:F14 for XO]]
| |
| *: See this [http://www.mail-archive.com/devel@lists.laptop.org/msg25313.html discussion thread].
| |
|
| |
|
| * '''Experiment''' with [[Sugar_on_a_Stick/Installation/OLPC|Updating XOs]] to the latest ''Sugar on a Stick'' release.
| |
| |}
| |
|
| |
| <br/><br/>
| |
|
| |
| ==Do you use GNU/Linux?==
| |
|
| |
| {|
| |
| |-
| |
| |width="178px" valign="top"|Select your favorite distribution<br><br><span class="linkgroup">[[File:Gnulinux.png|link=Community/Distributions]]</span>||
| |
| {|
| |
| |-
| |
| |[[Image:Fedora-small.jpg|link=Community/Distributions/Fedora]]<br/>[[Community/Distributions/Fedora|Fedora]]
| |
| |-
| |
| |[[Image:Debian-small.jpg|link=Community/Distributions/Debian]]<br/>[[Community/Distributions/Debian|Debian]]
| |
| |<span class="linkgroup">[[File:Trisquel_icon.png|link=Community/Distributions/Trisquel]]</span><br/>[[Community/Distributions/Trisquel|Trisquel]]
| |
| |[[Image:Ubuntu-small.jpg|link=Community/Distributions/Ubuntu]]<br/>[[Community/Distributions/Ubuntu|Ubuntu]]
| |
| |align="center"|[[Image:Ubuntu-small.jpg|link=http://wiki.ubuntu.com/Sugar]]<br>[http://wiki.ubuntu.com/Sugar '''U'''buntu '''S'''ugar '''R'''emix]
| |
| |-
| |
| |align="center"|<span class="linkgroup">[[Image:Mandriva-small.png|link=Community/Distributions/Mandriva]]</span><br/>[[Community/Distributions/Mandriva|Mandriva]]
| |
| |align="center"|[[Image:Caixa_M%C3%A1gica-small.jpg|link=Community/Distributions/Magalhães]]<br/>[[Community/Distributions/Magalhães|Caixa Mágica]]
| |
| |-
| |
| |align="center"|[[Image:Suse-small.jpg|link=Community/Distributions/OpenSUSE]]<br/>[[Community/Distributions/OpenSUSE| openSUSE]]
| |
| |[[Image:Suse-small.jpg|link=http://en.opensuse.org/Sugar]]<br/>[http://en.opensuse.org/Sugar openSUSE]||
| |
| |-
| |
| |align="center"|[[Image:Arch-logo.png|link=http://wiki.archlinux.org/index.php/Sugar]]<br/> [http://wiki.archlinux.org/index.php/Sugar Archlinux]||
| |
| |-
| |
| |[[Image:Debian-small.jpg|link=Community/Distributions/Linux_Mint_Debian]]<br/>[[Community/Distributions/Linux_Mint_Debian|Linux_Mint_Debian]]
| |
| |-
| |
| |<span class="linkgroup">[[Image:Altlinux-small.png|link=Community/Distributions/ALTLinux]]</span><br/>[[Community/Distributions/ALTLinux|AltLinux]]
| |
| |}
| |
| |-
| |
| |width="180px" valign="top"|Or try a Live USB version of Sugar
| |
| |[[File:Soas-mango-lassi.png|middle|200px|link=http://spins.fedoraproject.org/soas/#downloads]], Mango Lassi with Sugar 0.90.3 and Fedora 14 (Laughlin)<br/>or, for brave pioneers, [[Sugar_on_a_Stick/Beta | v5 alpha with Sugar 0.90.3 and Fedora 15 (Lovelock)]]<br/><span class="linkgroup">[[File:Trisquel_icon.png|link=Trisquel On A Sugar Toast]]</span> Trisquel on a Sugar Toast (Trisquel 3.0 ''Dwyn'')<br/>[[File:Suse-small.jpg|link=http://en.opensuse.org/Education/Live|Education/Live]] OpenSuse Live USB
| |
| |}
| |
|
| |
| <br/><br/>
| |
| == Virtual Machines on all platforms == | | == Virtual Machines on all platforms == |
|
| |
|
| {| | | {| |
| |- | | |- |
| |width="160px"|[[File:VirtualBox.png|100px|left|link=http://www.virtualbox.org/wiki/Downloads]] | | |width="160px"|[[File:VirtualBox.png|100px|left|link=Sugar_on_a_Stick/Virtual_machines]] |
| |valign=top| | | |valign=top| |
| * '''Appliance of Sugar on a Stick v4-Mango lassi'''
| | ===[[Sugar Creation Kit/VirtualBox|VirtualBox Appliances]] === |
| :'''Sugar 0.90.1
| |
|
| |
|
| :user=sugar
| | |- |
| :password=sugaruser
| | | |
| : '''root=sugarroot'''
| |
| :How Built:
| |
| : 8-GB Virtual Box hard disc
| |
| :English and English keyboard
| |
| :USA-Los Angeles (Pacific timezone)
| |
| :'''download and import 2 files:'''
| |
| http://download.sugarlabs.org/images/VirtualBox/Fedora-14-i686-Live-SoaS-2.ovf 12K
| |
| http://download.sugarlabs.org/images/VirtualBox/Fedora-14-i686-Live-SoaS-2-disk1.vmdk 606M
| |
|
| |
|
| ;Note: This appliance has 1024x768 screensize available as Virtualbox extensions were compiled into the kernel
| |
|
| |
|
| * '''Appliance of Sugar on a Stick v3-Mirabelle'''
| | '''[[Emulator_image_files#Other_virtual_machines|More Virtual Appliances]]''' |
| ::firstboot has not yet run; so a new user name and password will be set for the gdm login on start up for the first time
| |
| :How Built:
| |
| : '''root=sugarroot'''
| |
| : 8-GB VirtualBox hard disc
| |
| :English and English keyboard
| |
| :USA-Los Angeles (Pacific timezone)
| |
| :'''download and import 2 files:'''
| |
| http://download.sugarlabs.org/images/VirtualBox/Fedora-13-i686-Live-SoaS-sugaruser.vmdk 533M
| |
| http://download.sugarlabs.org/images/VirtualBox/Fedora-13-i686-Live-SoaS-sugaruser.ovf 12K
| |
|
| |
|
| ;Note 1:Use the latest version of Oracle VM VirtualBox (3.2_10.8-64453 or later). Some appliances have multiple hard disc controllers and the earlier Sun VirtualBox 3.1 version does not support them.
| | | |
| ;Note 2: All appliances were built on a MacBook Air with Oracle VM VirtualBox (3.2.10-r66523) then tested on a Ubuntu installation on an Acer Aspire One Netbook imported into VirtualBox (3.2.10 r66523)
| |
| ;Note 3:Set ControlPanel/Frame "Edge" slider to far left for easier access to sugar-frame features
| |
|
| |
|
| :(Note that on some browsers on Mac OS X, the file extensions are reset upon download. You may have to modify them to match those shown above.)<br>
| |
|
| |
|
| :If you run into problems, you may want to consult the [[Talk:VirtualBox]] page for help.
| | Sugar included in other GNU/Linux operating systems, and older versions. |
| |-
| | :Also includes some VMware Player Appliances |
| |colspan="2"|'''[[Emulator_image_files#Other_virtual_machines|More Virtual Appliances]]''' Sugar included in other linux operating systems, and older versions.
| |
| |} | | |} |
|
| |
|
| | If you run into problems, you may want to consult the [[Talk:VirtualBox]] page for help. |
| <br/><br/> | | <br/><br/> |
| ==Are you a developer?==
| |
|
| |
|
| {|
| |
| |-
| |
| |width="174px" valign=top|[[File:Gear.png|link=Supported_systems]]
| |
| |Learn how to get setup on the [[Supported systems]] page.
| |
|
| |
| Some additional references you may find useful:
| |
| * [[Development Team/Jhbuild | jhbuild]]
| |
| * [[Platform_Team/Guide/Core_development|sweet build]]
| |
| * [http://git.sugarlabs.org Gitorious source code repository]
| |
| * [[Emulator image files|Virtual machine or emulator image files]]
| |
| * Adding Sugar to your [[Supported systems|favorite distro...]]
| |
| |}
| |
|
| |
| <br/><br/>
| |
| ==Are you preparing a deployment without Internet access?== | | ==Are you preparing a deployment without Internet access?== |
|
| |
|
| Line 210: |
Line 60: |
| |valign="top"|See [[Sugar Creation Kit]] | | |valign="top"|See [[Sugar Creation Kit]] |
| |} | | |} |
|
| |
| <br/><br/>
| |
|
| |
|
| ==Are you looking for Sugar Activities?== | | ==Are you looking for Sugar Activities?== |
