Difference between revisions of "Sugar on a Stick"

Revision as of 00:26, 15 November 2017

Project Home · Join · Contacts · Resources · FAQ · Roadmap · To Do · Meetings

What is Sugar on a Stick?

	Sugar on a Stick is a Fedora^® Spin operating system featuring the award-winning Sugar Learning Platform. Sugar on a Stick will run on any 64-bit Notebook, Laptop, or Desktop computer, with a minimum of 1GB RAM, that can run Linux, Windows or macOS, using a USB thumbdrive or stick, as a Live USB, a 32-bit computer with the TOAST version of Sugar (Trisquel on a Sugar Toast). See Trisquel On A Sugar Toast. a Raspberry Pi 2 or 3, using a microSD card, or; any computer as a virtual machine. You can use Sugar on a Stick to demo Sugar almost anywhere without disturbing the contents of the computer you use, and if people like what they see, you can install Sugar on a Stick to their hard drives or other sticks from the demo stick.
	x86_64 (64-bit)		armhfp Raspberry Pi 2 or 3, see How to install.
	How to quickly demonstrate: (English), (en español)

Fedora and the Infinity design logo are trademarks of Red Hat, Inc.

What's new in Sugar on a Stick?

Sugar version 0.110.0
More information about this version at 0.110/Notes.
The current release comes with Fedora 27, though Sugar on a Stick does not package all the software of other desktops.
See : Fedora 27 Release Notes.

Known bugs

(pending input from users)
See Common Fedora 27 bugs

Want to use Sugar on a Stick?

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.

Want to contribute to Sugar on a Stick?

You're in the right place! This page is a contributors portal to the project, and contains everything you need to get started in becoming part of the Sugar on a Stick community.

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.

What can you do?

There are three main ways you can contribute to the Sugar on a Stick community. We work closely with our upstreams, Sugar Labs and the Fedora Project.

Get Activities on the Stick

We're always looking for help with all aspects of the Sugar on a Stick release process. Here are a few things you can do:

Test Sugar on a Stick and help us find bugs and think of ways the project could be better. When you find a bug or think of an enhancement, file a ticket! No technical experience required.
Help make it easier for others to test Sugar on a Stick by writing test cases. If you've run a test case, you can write a test case.
Fix a bug or add a feature to an existing Activity, to sugar-core itself, or to 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.
Package Sugar Activities for Fedora. If you're a 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.
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 feature process.

Get Sticks into Schools

Deployments all over the world need many different types of help as they work through the Sugar on a Stick deployment process - we need help building resources for all deployments to use, supporting those deployments, and helping new deployments start, as well as gathering stories and feedback from deployments so that we can make the next version of Sugar on a Stick even better.

Some things you can do to help:

"It's a wiki: Edit away!" is often said in open source communities. Almost nothing is set in stone and can't be undone. So if you've got ideas how to make instructions clearer and more accessible, just go for it!
We produce official documentation such as the Creation Kit or the Customization Guide. If you've an idea how to make them better, why don't you jump in and create a patch? Creating these nifty text files is simple - instructions live in the Documentation SOP.
Unofficial documentation for unsupported workarounds for installation and customization need to be edited, tested, and submitted for approval for official support. Check them out and leave comments and improvements; just jump in and edit the page.
Interested in starting a deployment or helping a specific one (with anything from pedagogical design to technical support to funding logistics)? Introduce yourself on the deployment lists for Sugar Labs and One Laptop Per Child and we'll get you connected with some teachers on the ground.
We're looking for some people to help us assemble tools for our support team to use. Email the Sugar on a Stick mailing list if you're interested.

Get Contributors

Contributors are the lifeblood of the Sugar on a Stick community - we work hard to bring a playful mindset of teaching, learning, and meaningful work to the children we aim to reach, and we aim to keep that mindset in our own work and community as well. Welcoming and teaching new contributors or all types, building the resources they need, and teaching them how to empower others in their turn is one of the most important things you can do; it is everyone's responsibility to help build our community, one person at a time.

Some things you can do:

Edit this page and Joining Sugar on a Stick. Is there something we could do to make the "getting started" process easier? You don't have to ask permission to edit; just do it!
Help us fill in our remaining task-starter pages: Sugar on a Stick release process, How to fix an Activity bug, How to fix a sugar-core bug, and Sugar on a Stick deployment process/
Point out starter tasks on OpenHatch - fill in questions and ideas for beginner jobs, and point newcomers towards them.
Watch for introductions on the mailing list, and send welcome emails to new contributors (copy the list, so we can see what advice a newcomer has gotten so far).
Hang out with us on IRC: #sugar. This is where the IRC Activity starts off. Help new joiners past initial questions and provide instant help!

What's happening?

Sugar on a Stick/Beta

Sugar Virtual Box Appliances

Import into VirtualBox

Contributor stories

To find out what other contributors are doing, check out Planet Sugar Labs, where contributors to Sugar Labs and the Sugar on a Stick project aggregate their blogs. You can also add your own blog to the Planet.

Meetings

Communication through the 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.

Related work

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!)

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.
Older portable Sugar distributions 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.

Previous versions and other subpages index

Earlier versions of Sugar on a Stick and other project pages can be reviewed at these pages:

@@ Line 1: / Line 1: @@
-==About Sugar on a Stick (SoaS)==
+<noinclude><!--{{ Translations | [[Sugar_on_a_Stick|english]] &#124; [[Sugar_on_a_Stick/lang-es|español]] &#124; [[Sugar_on_a_Stick/lang-fr|français]]}}-->
-[[Image:Soas-1.png|thumb]]
+[[Category:Project]]
+[[Category:Live USB]]
+[[Category:Sugar on a Stick]]
-The Sugar on a Stick project gives children access to *their* Sugar on any computer in their environment with just a USB key.
+{{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 version 0.110.0'''
+*: More information about this version at [[0.110/Notes]].
+* The current release comes with [[Fedora 27]], though Sugar on a Stick does not package all the software of other desktops.
+*: See : [https://docs.fedoraproject.org/f27/release-notes/index.html Fedora 27 Release Notes].
-===Project Goals===
+==== Known bugs ====
-* Sugar on a Stick as 1 to 1 computing in an elementary school
+* (pending input from users)
-* Sugar on a Stick to empower middle and high school students to help test [[Sugar as Service Learning]]
+* See [[fedora:Common_F27_bugs|Common Fedora 27 bugs]]
-* Sugar on a Stick for conferences to let people try Sugar and collaborate with other conference participants
-==Create your own USB Stick==
+=== Want to use Sugar on a Stick? ===
-[[Image:Soas.jpg|thumb]]
+{|
+|-
+| style="border: 0; border-width: 0; width: 350px;" | [[File:Cici-maze.jpg |300px|left|link=Sugar_on_a_Stick/Downloads]]
-The basics of creating and using a bootable Sugar on a Stick are:
+|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.
-#Download a .iso image file containing Sugar on a Stick.
+|}
-#Use a Bootable USB creator program to copy the image file to a USB stick.
-#Configure the target computer to boot from USB.
-===Download a .iso Image File===
+=== Want to contribute to Sugar on a Stick? ===
-A .iso image file of the latest version of Sugar on a Stick is located here:
+{|
-:http://download.sugarlabs.org/soas/snapshots/1/Soas-200902231225.iso
+|-
+| style="border: 0; border-width: 0; width: 350px;" | [[File:SoaS-contributors.jpg |300px|left|link=Sugar_on_a_Stick]]
+| style="border: 0; border-width: 0;" |
+You're in the right place! This page is a contributors portal to the project, and contains everything you need to get started in becoming part of the Sugar on a Stick community.
+|}
-See this email post for information about the latest version:
+== New contributors start here! ==
-:http://lists.sugarlabs.org/archive/sugar-devel/2009-February/012123.html
-===Create a Bootable USB stick===
+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.
-Creating bootable USB keys can be tricky.  If it doesn't work the first try, experiment with different methods, computers and USB keys.  Report your experience on the [[Talk:Sugar on a Stick|Sugar on a Stick talk]] page.
-====On Windows using Fedora LiveUSB Creator====
+== What can you do? ==
-Fedora LiveUSB Creator is a cross-platform tool for easily installing live operating systems on to USB flash drives.  ''This is the recommended method to create Sugar on a Stick USB drives.'''
-:http://fedorahosted.org/liveusb-creator/
+There are three main ways you can contribute to the Sugar on a Stick community. We work closely with our upstreams, [http://sugarlabs.org Sugar Labs] and [http://fedoraproject.org the Fedora Project].
-*Download and install Fedora LiveUSB creator as well as a .iso image file.
+=== Get Activities on the Stick ===
-*Plug in a 1GB or larger USB stick into your computer.
-*Open "liveusb-creator.exe"
-*Use "Browse" to select the iso file that you just downloaded.
-*Set the Target Device to your USB device.
-*Move the slider to set some persistent storage.  (Hint: Set it high, then it will tell you how much space there is, and you can adjust it to the right point).
-*Click "Create Live USB". It will take a few minutes.
-How much persistent memory you set will depend on the size of the .iso and the size of your USB.  Make sure you leave some so that people can use the Journal.
+{|
+|-
+| style="border: 0; border-width: 0;" |
-====On Linux using the shell script====
+We're always looking for help with all aspects of the [[Sugar on a Stick release process]]. Here are a few things you can do:
-This is known to work in Fedora and Ubuntu and should work in other Linux distributions.
-* Make sure you have the isomd5sum package installed in your distribution, as it will be needed by the script later on.
+* [[Sugar on a Stick QA|Test Sugar on a Stick]] and help us find bugs and think of ways the project could be better. When you find a bug or think of an enhancement, [[How to file a ticket|file a ticket!]] ''No technical experience required.''
-* Plug in a 1GB or larger USB stick into your computer.
+* Help make it easier for others to test Sugar on a Stick by writing [[Sugar on a Stick QA#Test cases|test cases]]. ''If you've run a test case, you can write a test case.''
-* Download the shell script [http://katzj.fedorapeople.org/olpc/livecd-iso-to-disk.sh livecd-iso-to-disk.sh]
+* [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.''
-* Check the USB device. In the example below the device is /dev/sdb,<br>
+* [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.''
-: df -h
+* [[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.''
- Filesystem            Size  Used Avail Use% Mounted on
+* 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]].
- /dev/sda1              19G  7.0G   11G  40% /
- tmpfs                 1.5G     0  1.5G   0% /lib/init/rw
- varrun                1.5G   96K  1.5G   1% /var/run
- varlock               1.5G     0  1.5G   0% /var/lock
- udev                  1.5G  2.9M  1.5G   1% /dev
- tmpfs                 1.5G  104K  1.5G   1% /dev/shm
- lrm                   1.5G  2.0M  1.5G   1% /lib/modules/2.6.27-11-generic/volatile
- /dev/sdb1             996M  913M   84M  92% /mnt/myUSBdisc
-* Then check to see that the partition is marked as bootable,<br>
+| style="border: 0; border-width: 0; width: 150px;" |[[Image:SoaS-netbook-1.jpg|150px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick_release_process]][[Image:SoaS-netbook-2.jpg|150px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick_release_process]][[Image:SoaS-netbook-3.jpg|150px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick_release_process]]
-: sudo fdisk -l ''<----that's a lowercase letter L for the List option.''
+|}
-You should see output that looks like this:
- Disk /dev/sdb: 1047 MB, 1047265280 bytes
-heads, 63 sectors/track, 127 cylinders
- Units = cylinders of 16065 * 512 = 8225280 bytes
- Disk identifier: 0x0008325f
- .
-  Device Boot      Start         End      Blocks   Id  System
- /dev/sdb1   *           1         127     1020096    6  FAT16
-The '*' under the Boot column is what you want to see.
-: If not, then
-:* For Ubuntu 8.10, menu: System -> Administration -> Partition Editor (GParted).
-::# Select your USB device (/dev/sdb in your case),
-::# then your partition (/dev/sdb1),
-::# then menu: Partition -> Manage Flags,
-::# check the boot box,
-::# and Close to mark the partition as bootable.
-:* For Fedora,
+=== Get Sticks into Schools ===
-::#  parted /dev/sdb
-::# toggle 1 boot
-::# quit
-* Unmount the drive,<br>
+{|
-: sudo umount /dev/sdb1
+|-
-* Run it as root, making sure to pass the correct USB device and to set overlay and home size appropriately, depending on the stick size.
+| style="border: 0; border-width: 0; width: 250px;" | [[File:Cici-stick.jpg |200px|left|link=Sugar_on_a_Stick_deployment_process]]
- sudo ./livecd-iso-to-disk.sh --overlay-size-mb 500 --home-size-mb 500 Soas-200902231225.iso /dev/sdb1
+| style="border: 0; border-width: 0;" |
+Deployments all over the world need many different types of help as they work through the [[Sugar on a Stick deployment process]] - we need help building resources for all deployments to use, supporting those deployments, and helping new deployments start, as well as gathering stories and feedback from deployments so that we can make the next version of Sugar on a Stick even better.
-====On Windows or Linux using UNetbootin====
+Some things you can do to help:
-UNetbootin (Universal Netboot Installer) is a cross-platform utility that can create Live USB systems.
-''Keep in mind that UNetbootin doesn't support persistent overlays, so you won't be able to save files using the Journal.''
+* ''"It's a wiki: Edit away!"'' is often said in open source communities. Almost nothing is set in stone and can't be undone. So if you've got ideas how to make instructions clearer and more accessible, just go for it!
+* We produce official documentation such as the [http://download.sugarlabs.org/soas/docs/creation-kit/ Creation Kit] or the [http://download.sugarlabs.org/soas/docs/customization-guide/ Customization Guide]. If you've an idea how to make them better, why don't you jump in and create a patch? Creating these nifty text files is simple - instructions live in the [[Sugar_on_a_Stick/Documentation_SOP|Documentation SOP]].
+* Unofficial documentation for unsupported workarounds for [[Sugar on a Stick/Installation|installation]] and [[Sugar on a Stick/Sugar Clone|customization]] need to be edited, tested, and submitted for approval for official support. Check them out and leave comments and improvements; just jump in and edit the page.
+* Interested in starting a deployment or helping a specific one (with anything from pedagogical design to technical support to funding logistics)? Introduce yourself on the deployment lists for [http://lists.sugarlabs.org/ Sugar Labs] and [http://lists.laptop.org/listinfo/ One Laptop Per Child] and we'll get you connected with some teachers on the ground.
+* We're looking for some people to help us assemble tools for our support team to use. Email the [http://lists.sugarlabs.org/listinfo/soas Sugar on a Stick mailing list] if you're interested.
+|}
-:http://unetbootin.sourceforge.net/
+=== Get Contributors ===
-* Choose the Diskimage ISO option.
+{|
-* Select the downloaded .iso image file.
+|-
-* Press OK and wait for your USB stick to be created.
+| style="border: 0; border-width: 0;" |
-===Booting Sugar on a Stick===
+Contributors are the lifeblood of the Sugar on a Stick community - we work hard to bring a playful mindset of teaching, learning, and meaningful work to the children we aim to reach, and we aim to keep that mindset in our own work and community as well. Welcoming and teaching new contributors or all types, building the resources they need, and teaching them how to empower others in their turn is one of the most important things you can do; it is ''everyone's'' responsibility to help build our community, one person at a time.
-Once you have created your USB key, you still need to set your target system to boot from USB.
-The trick is to set the BIOS to boot from USB.  Unfortunately this is slightly different on each computer.  Explore the setup screen for your system (press Esc or F1 while the computer is booting).  If you can't figure it out, search Google for information on your computer model's BIOS.
+Some things you can do:
-If you are unable to boot from USB, you can burn a "Boot Helper" CD using the .iso below.  This will start the boot from the CD, then read files from the USB.
+* Edit this page and [[Joining Sugar on a Stick]]. Is there something we could do to make the "getting started" process easier? You don't have to ask permission to edit; just do it!
-:http://www.sugarlabs.org/~marco/boot.iso
+* Help us fill in our remaining task-starter pages: [[Sugar on a Stick release process]], [[How to fix an Activity bug]], [[How to fix a sugar-core bug]], and [[Sugar on a Stick deployment process]]/
+* [http://openhatch.org/+projects/Sugar%20on%20a%20Stick Point out starter tasks on OpenHatch] - fill in questions and ideas for beginner jobs, and point newcomers towards them.
+* [http://lists.sugarlabs.org/listinfo/soas Watch for introductions on the mailing list], and send welcome emails to new contributors (copy the list, so we can see what advice a newcomer has gotten so far).
+* Hang out with us on IRC: [http://webchat.freenode.net?channels=sugar #sugar]. This is where the [http://activities.sugarlabs.org/en-US/sugar/addon/4029 IRC Activity] starts off. Help new joiners past initial questions and provide instant help!
-You can also use the 'PLoP Boot Manager' to create a boot floppy for machines without the ability to boot from CD or USB, see:
+| style="border: 0; border-width: 0; width: 200px;" |[[Image:Cici-netbook.jpg|200px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick]]
-:http://syslinux.zytor.com/wiki/index.php/No_native_BIOS_support
+|}
-==Report Bugs==
+== What's happening? ==
-Please keep notes on which version of Sugar on a Stick you have downloaded as the user interface currently does not display this information.
+===[[Sugar on a Stick/Beta]]===
-Report bugs to http://dev.sugarlabs.org/.  Use the "SoaS" component when entering new bugs.
+===[[Sugar_on_a_Stick/Virtual_machines| Sugar Virtual Box Appliances]]===
+* Import into VirtualBox
-===Join the development effort===
+=== Contributor stories ===
-We are coordinating work on this project on Sugar Labs Moodle system. Please create an account and join the Sugar on a Stick Class.
+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]].
-:http://schools.sugarlabs.org/course/view.php?id=17
-====TODO List====
+=== <s>Meetings</s> ===
-*Create an Easy Emulation for Boston School teachers macbooks - http://dev.sugarlabs.org/ticket/114 <-- [[User:Mick|Mick]] is working on this
-*Create a boot helper CD that lets Macs boot from the stick
-*Install the latest version of Sugar on a Stick, pick an activity and test it
-*Create a system for tracking activity testing
-*Solicit USB stick donations from companies
-*Create a design for a CD sticker to put on boot helper CDs
-*Develop specs for Cloning Sugar on a Stick: The vision is that an adult will be able to create a Sugar on a Stick, add activities, set the language and the collaboration service and then "clone" the stick to create Sugar on a Stick for all the students in a class or a school.
-== See Also ==
+Communication through the [http://lists.sugarlabs.org/listinfo/soas Sugar on a Stick mailing list] has replaced regular meetings.
-*[[DeploymentTeam/School_Key]] Information on various Sugar on a Stick deployments.
+:We once had weekly meetings on IRC - see [[Sugar on a Stick meetings]] for more information, including logs from past meetings.
-*[[Sugar on a Stick Ubuntu]] An alternate version of Sugar on a Stick which uses Ubuntu as the base system.
-*[[Sugar on a Stick VirtualBox]] Instructions for using a preconfigured VirtualBox disk image with Sugar on a Stick.
+== Related work ==
+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!)
+* 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.
+* Older [[:Category:Live USB|portable Sugar distributions]] 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.
+== Previous versions and other subpages index ==
+{{Show|Earlier versions of Sugar on a Stick and other project pages can be reviewed at these pages: |{{Special:PrefixIndex/Sugar on a Stick/}}}}