Sugar Labs

Sugar on a Stick: Difference between revisions

← Older edit
TOC pushes pancake button "below the fold"
 
(163 intermediate revisions by 13 users not shown)
Line 3: Line 3:
[[Category:Live USB]]
[[Category:Live USB]]
[[Category:Sugar on a Stick]]
[[Category:Sugar on a Stick]]
</noinclude>


== What is Sugar on a Stick? ==
{{TeamHeader|Sugar on a Stick|home=Project Home|xbgColor=ffe792}}__NOTOC__</noinclude>
 
==What is Sugar on a Stick?==
{{:Sugar on a Stick/Downloads}}
=== What's new in Sugar on a Stick? ===
* Sugar [[0.118]], see the [[0.118/Notes|release notes for 0.118]],
* several updated activities,
* based on Fedora 35, see the [[fedoradocs:fedora/f34/release-notes/|release notes for Fedora 35]]
:
 
==== Known bugs ====
 
* See also [[fedora:Common_F34_bugs|Common Fedora 35 bugs]].
 
== Sugar on a Stick installation instructions ==
=== MS Windows ===


{|
{|
|-
|-
| style="border: 0; border-width: 0; width: 350px;" | [[File:SugaronastickMirabelle.png |300px|left|link=http://spins.fedoraproject.org/soas]]
|width="160px" valign="top"|[[File:Windows.gif|left|link=Sugar on a Stick/Windows]]
| style="border: 0; border-width: 0;" | '''[[Sugar on a Stick]]''' is a [http://fedoraproject.org Fedora-based] [[wikipedia:Live USB|Live USB]] operating system featuring the award-winning [[What is Sugar?|Sugar Learning Platform]] and designed to fit on an ordinary USB thumbdrive ("stick"). Learn more about [http://spins.fedoraproject.org/soas/#home the project] and the [http://spins.fedoraproject.org/soas/#about principles] behind it at our [http://spins.fedoraproject.org/soas Spin webpage]. The most recent version is version 3, code-named '''[[Sugar on a Stick/Mirabelle|Mirabelle]]''' and was released on '''May 25, 2010.'''
<br><br><br>
<span class="linkgroup">[[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]</span>
[[File:USB flash drive.jpg|left|156px|link=Sugar on a Stick/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''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file.<br><br>
# '''Load''': Insert a USB flash drive (or SD Card) with 2 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.
|}


'''Turn your computer into a Sugar on a Stick Creation Station:''' A related project is the [[Sugar Creation Kit]], a downloadable DVD which includes the materials you need to create Mirabelle sticks and install additional Activities on it, along with documentation and previous versions of Sugar on a Stick.
Detailed [[Sugar on a Stick/Windows|installation instructions for Windows]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Getting Started/Explore|guide to exploring Sugar]].
----
=== GNU/Linux ===
{|style="width: 800px;"
|-
|width="160px" valign=top|<br><span class="linkgroup">[[File:Gnulinux.png|link=Sugar on a Stick/Linux]]
<br>
[[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]</span>
[[File:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]]
|valign=top|
{{:Sugar on a Stick/Linux/Installation}}
|}
|}


__NOTOC__
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 [[Getting Started/Explore|guide to exploring Sugar]].
GNU/Linux users may also want to install the [[#Do_you_use_GNU.2FLinux.3F|Sugar packages]] on their favorite distro, apart from Sugar on a Stick.
----


=== Want to use Sugar on a Stick? ===
=== Apple Mac OS X ===
{|
|-
|width="160px" valign="top"|[[File:Apple.gif|link=Macintosh]]
<br>
<span class="linkgroup">[[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]</span>
[[File:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]]
|valign=top|
The instructions below are based on the Ubuntu Web page at &lt;http://www.ubuntu.com/download/desktop/create-a-usb-stick-on-mac-osx&gt;.
# '''Prepare''': These instructions are for '''32-bit''' and '''64-bit''' processors.<br><br>
# '''Download''' the latest [[Sugar on a Stick/Downloads|Sugar on a Stick]] .iso file.<br><br>
# '''Load''': <br>Here is a simple way to load a bootable USB on a Mac.<br>
## Enter the Terminal: <code>/Applications/Utilities/Terminal</code>.
## Type <code>diskutil list</code>. You should see all the disk drives you have inserted into your computer.
## Insert the disk drive to which you want to write Sugar on a Stick.
## Type <code>diskutil list</code> again. You should see that your USB drive has been added to the list. If not, wait a while and repeat.
## Type <code>hdiutil convert -format UDRW -o &lt;<i>Sugar on a Stick image file</i>&gt;.img &lt;<i>Sugar on a Stick image file</i>&gt;</code> to convert the image into a bootable format.
## Type <code>sudo diskutil unmountDisk &lt;<i>device name</i>&gt;</code> to unmount the disk (it will not be ejected).
## Type <code>sudo dd if=&lt;<i>Sugar on a Stick image file</i>&gt;.img.dmg of=&lt;<i>device name</i>&gt; bs=1m</code>. <code>sudo</code> will ask for your password, and then <code>dd</code> will start writing the disk file.
## When <code>dd</code> finishes writing the disk file, type <code>sudo diskutil eject &lt;<i>device name</i>&gt;</code>.
# '''Boot''': Insert the USB stick into a USB port on your computer, then reboot and press and hold the Option key while rebooting. You should see a list of all the EFI-recognizable USB drives that can be bootstrapped. If Sugar on a Stick is not one such drive, it cannot be bootstrapped: you need rEFInd (a fork of rEFIt).<br>
<br>
:* Have a MacBook? Consider these options:
::[[File:Usb1.png|50px]] [[Testing/Reports/Sugar on a Stick#MacBook Persistent SoaS v5 USB EFI Boot|'''MacBook Persistent SoaS v5 USB EFI Boot''']]
:: [[Talk:Downloads#Bootable_CD_of_Trisquel_4.5_for_MacBook_Air|Bootable CD of Trisquel 4.5 for MacBook Air]]
:: See other installation variations at [[Sugar Creation Kit]]
::[[File:Apple.gif|30px]] [[Tutorials/Installation/Burn_a_CD.iso_on_a_Mac|'''Burning a CD from an .iso file on a Mac''']]
|}
 
Alternative [[Macintosh|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 [[Getting Started/Explore|guide to exploring Sugar]].
----
 
===Advanced users===
==Do you have an OLPC XO?==  


{|
{|
|-
|-
| rowspan="3" style="border: 0; border-width: 0; width: 350px;" | [[File:Cici-maze.jpg |300px|left|link=http://spins.fedoraproject.org/soas]]
|width="174px"|[[File:OLPCXO.png|middle|link=olpc:Releases]]
|-
|valign=top|
|
* '''Upgrade''' to the latest ''[[olpc:Releases]]'' from OLPC (which may require a [[olpc:Activation_and_developer_keys|developer key]]).
|style="border: 0; border-width: 0;" align="center" | [[File:Download Mirabell.png|center|link=http://spins.fedoraproject.org/soas/#downloads]]
|-
|
|If you'd like to try out Sugar on a Stick, check out the [http://spins.fedoraproject.org/soas Sugar on a Stick Spin Page] - it's where our software downloads, installation and usage instructions, and support information lives.


After you've tried out Sugar on a Stick, we hope you'll come back here and join our community of contributors to help us make the next release even better.
* '''Experiment''' with [[Sugar_on_a_Stick/Installation/OLPC|Updating XOs]] to the latest ''Sugar on a Stick'' release.
|}
|}
<br/><br/>
==Some alternate installations==
* Once you download, and then burn or load a Sugar on a Stick (SoaS) .iso file, and boot it, the running Fedora 34 SoaS Live CD/USB may be used to install Fedora with Sugar to a hard disk or a 4 GB USB stick [[Tutorials/Installation/Install with liveinst|with the '''{{Code|liveinst}} command''']].
:- You start with a SoaS LiveOS image, and then load an uncompressed version onto the hard disk or USB stick.


=== Want to contribute to Sugar on a Stick? ===
=== Want to contribute to Sugar on a Stick? ===
{|
{|
|-
|-
Line 43: Line 110:
== New contributors start here! ==
== New contributors start here! ==


Welcome! We're excited that you want to help us bring the Sugar Learning Platform to children around the world. No prior experience with computers or educational technology is required - in fact, we actively encourage a diversity of backgrounds, ages, and perspectives. See the [[Joining Sugar on a Stick]] page for instructions on how to get started. You may also want to check out the [http://openhatch.org/+projects/Sugar%20on%20a%20Stick Sugar on a Stick project page] on [http://openhatch.org OpenHatch], or attend one of our [[Sugar on a Stick meetings]].
Welcome! We're excited that you want to help us bring the Sugar Learning Platform to children around the world. No prior experience with computers or educational technology is required - in fact, we actively encourage a diversity of backgrounds, ages, and perspectives. See the [[Joining Sugar on a Stick]] page for instructions on how to get started.


== What can you do? ==
== What can you do? ==
Line 61: Line 128:
* [http://bugs.sugarlabs.org Fix a bug or add a feature] to an existing Activity, to [[Development Team|sugar-core itself]], or to [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=new&status=reopened&component=SoaS&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component Sugar on a Stick]. See [[How to fix an Activity bug]] and [[How to fix a sugar-core bug]] to get started. ''Basic Python programming skills - or the desire to learn - are all that's needed.''
* [http://bugs.sugarlabs.org Fix a bug or add a feature] to an existing Activity, to [[Development Team|sugar-core itself]], or to [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=new&status=reopened&component=SoaS&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component Sugar on a Stick]. See [[How to fix an Activity bug]] and [[How to fix a sugar-core bug]] to get started. ''Basic Python programming skills - or the desire to learn - are all that's needed.''
* [https://fedoraproject.org/wiki/Sugar_Activities Package Sugar Activities for Fedora]. ''If you're a [https://fedoraproject.org/wiki/PackageMaintainers/Join Fedora Packager] or want to become one, help in this area is something we desperately need - it's a trickier thing to learn, but rewarding once you get the hang of it.''
* [https://fedoraproject.org/wiki/Sugar_Activities Package Sugar Activities for Fedora]. ''If you're a [https://fedoraproject.org/wiki/PackageMaintainers/Join Fedora Packager] or want to become one, help in this area is something we desperately need - it's a trickier thing to learn, but rewarding once you get the hang of it.''
* [[Sugar on a Stick release process#Review|Review Activities for inclusion in the build]] - check submitted Activities against our [[SoaS Activity Criteria]] and help us choose what gets included in the next release! ''No prior experience needed - we do reviews during our [[Sugar on a Stick meetings|weekly meetings]] and will teach you how.''
* [[Sugar on a Stick release process#Review|Review Activities for inclusion in the build]] - check submitted Activities against our [[Sugar on a Stick/Activity Criteria]] and help us choose what gets included in the next release! ''No prior experience needed.''
* Have an idea for a technical feature that isn't an Activity? Check out our [[Sugar on a Stick release process#Feature process|feature process]].
* Have an idea for a technical feature that isn't an Activity? Check out our [[Sugar on a Stick release process#Feature process|feature process]].


Line 104: Line 171:


== What's happening? ==
== What's happening? ==
===[[Sugar on a Stick/Beta]]===


=== Meetings ===
=== Contributor stories ===


We have weekly meetings on IRC - see [[Sugar on a Stick meetings]] for more information, including logs from past meetings. Attending a meeting is a great way for newcomers to get started.
To find out what other contributors are doing, check out [http://planet.sugarlabs.org Planet Sugar Labs], where contributors to Sugar Labs and the Sugar on a Stick project aggregate their blogs. You can also [[Sysadmin/Planet syndication request|add your own blog to the Planet]].
 
=== Release schedule ===


Our release schedule is based on the [[fedora:Releases/Schedule | Fedora release schedule]]. The most recent release was v.3, code-named [[Mirabelle]], shipped on '''May 25, 2010''' and based on the Fedora 13 release schedule. The next Sugar on a Stick version will be based on the [[fedora:Releases/14/Schedule | Fedora 14 release schedule]].
=== <s>Meetings</s> ===


{|border="1" cellspacing="0" width="100%"
Communication through the [http://lists.sugarlabs.org/listinfo/soas Sugar on a Stick mailing list] has replaced regular meetings.  
|-
:We once had weekly meetings on IRC - see [[Sugar on a Stick meetings]] for more information, including logs from past meetings.
|rowspan="2"| 2010-05-25 || Sugar on a Stick v.3.0 Mirabelle released
|-
| Planning & Development Begins
|-
| 2010-07-27    || Feature Freeze (all features have to be ''approved'' and in a satisfying state.)
|-
| 2010-08-03    || Alpha Change deadline (all changes will have to be ''pushed'' by this time. pending submissions are insufficient.)
|-
| 2010-08-17 || Alpha Release
|-
| 2010-09-07 || Beta Change deadline (all changes will have to be ''pushed'' by this time. pending submissions are insufficient.)
|-
| 2010-09-21 || Beta Release
|-
| 2010-10-12 || Final Freeze (all changes have to be ''pushed''. no further changes permitted.)
|-
| 2010-10-14  || Compose Release Candidate
|-
| 2010-10-26  || Sugar on a Stick v.4.0 Final Release
|-
|}
 
=== Contributor stories ===
 
To find out what other contributors are doing, check out [http://planet.sugarlabs.org Planet Sugar Labs], where contributors to Sugar Labs and the Sugar on a Stick project aggregate their blogs. You can also [[Sysadmin/Planet syndication request|add your own blog to the Planet]].


== Related work ==
== Related work ==
Line 145: Line 186:
While the projects listed below are not part of Sugar on a Stick, we watch them closely and try to work with them when possible (or at least we're trying to learn!)
While the projects listed below are not part of Sugar on a Stick, we watch them closely and try to work with them when possible (or at least we're trying to learn!)


* [[Talk:Sugar_Creation_Kit#Introduction_to_Soas-v3_Mirabelle|Introduction to Mirabelle]]
* For deployments lacking easy Internet access, one can turn a computer into a '''Sugar on a Stick Creation Station'''. The [[Sugar Creation Kit]] includes the materials you need to create Live USB sticks sticks and to install additional Activities, along with documentation and previous versions of Sugar on a Stick.
* [[Sugar_on_a_Stick/Installation/Variations#SugarCreationKit_DVD|SugarCreationKit DVD]] - Complete DVD containing all the resources required to create all 3 versions of Sugar-on-a-Stick without requiring Internet access
* Older [[:Category:Live USB|portable Sugar distributions]] based on other Linux distributions .
* Other [[:Category:Live USB|portable Sugar distributions]] - Live USB work based on other Linux distributions.
* [[The undiscoverable]] is an unofficial FAQ for tips, tricks, and solutions to common problems that may otherwise be tricky to find. These are being considered for inclusion in the official SoaS documentation.
* [[The undiscoverable]] is an unofficial FAQ for tips, tricks, and solutions to common problems that may otherwise be tricky to find. These are being considered for inclusion in the official SoaS documentation.


== Previous versions and subpage index ==
== Previous versions and other subpages index ==
{{Show|Earlier versions of Sugar on a Stick can be reviewed at these pages: |{{Special:PrefixIndex/Sugar on a Stick}}}}
{{Show|Earlier versions of Sugar on a Stick and other project pages can be reviewed at these pages: |{{Special:PrefixIndex/Sugar on a Stick/}}}}
Retrieved from "https://wiki.sugarlabs.org/go/Sugar_on_a_Stick"