Difference between revisions of "Sugar on a Stick/Strawberry"
(introduction overhaul) |
|||
| Line 5: | Line 5: | ||
'''Release Notes - last update: 2009/06/23''' | '''Release Notes - last update: 2009/06/23''' | ||
| − | This document provides instructions for preparing a Sugar on a Stick (SoaS) installation. It also contains a list of known issues and sources of further information. | + | This document provides instructions for preparing a Sugar on a Stick (SoaS) installation. It also contains a list of known issues and sources of further information. For more detailed information, please check the [[Sugar_on_a_Stick|SoaS wiki page]]. |
| + | |||
| + | The Sugar on a Stick Strawberry release is based Fedora 11 and includes the latest updates as of June 22. It also features the last Sugar desktop environment, namely [[DevelopmentTeam/Release/Releases/Sucrose/0.84| version 0.84]], and additional activities to enrich the user experience. Interested users can download further activities from the [http://activities.sugarlabs.org/ Sugar Activity Library]. This release is finally another step forward compared with the last [[Sugar_on_a_Stick/Beta| beta release]] and now includes also supplementary sample content, which is directly available from the Journal. Apart from the default fructose activities, the following ones are included in this release. | ||
| + | |||
| + | {| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;" | ||
| + | |-style="background:#787878; color: white;" | ||
| + | | '''Activity Name''' || '''Activity Name''' | ||
| + | |- | ||
| + | | [http://activities.sugarlabs.org/en-US/sugar/addon/4037 CartoonBuilder] || [http://activties.sugarlabs.org/en-US/sugar/addon/4063 Memorize] | ||
| + | |- | ||
| + | | [http://activities.sugarlabs.org/en-US/sugar/addon/4050 Colors] || [http://activities.sugarlabs.org/en-US/sugar/addon/4034 Moon] | ||
| + | |- | ||
| + | | [http://activities.sugarlabs.org/en-US/sugar/addon/4044 FlipSticks] || [http://activities.sugarlabs.org/en-US/sugar/addon/4082 Paint] | ||
| + | |- | ||
| + | | [http://activities.sugarlabs.org/en-US/sugar/addon/4054 FreeCell] || [http://activities.sugarlabs.org/en-US/sugar/addon/4193 Physics] | ||
| + | |- | ||
| + | | [http://activities.sugarlabs.org/en-US/sugar/addon/4042 InfoSlicer] || [http://activities.sugarlabs.org/en-US/sugar/addon/4074 Poll] | ||
| + | |- | ||
| + | | [http://activities.sugarlabs.org/en-US/sugar/addon/4029 IRC] || [http://activities.sugarlabs.org/en-US/sugar/addon/4081 Record] | ||
| + | |- | ||
| + | | [http://activities.sugarlabs.org/en-US/sugar/addon/4046 JigsawPuzzle] || [http://activities.sugarlabs.org/en-US/sugar/addon/4047 SliderPuzzle] | ||
| + | |- | ||
| + | | [http://activities.sugarlabs.org/en-US/sugar/addon/4064 JokeMachine] || [http://activities.sugarlabs.org/en-US/sugar/addon/4038 Speak] | ||
| + | |- | ||
| + | | [http://activities.sugarlabs.org/en-US/sugar/addon/4078 Labyrinth] || [http://activities.sugarlabs.org/en-US/sugar/addon/4073 StoryBuilder] | ||
| + | |- | ||
| + | | [http://activities.sugarlabs.org/en-US/sugar/addon/4089 Library] || [http://activities.sugarlabs.org/en-US/sugar/addon/4039 ViewSlides] | ||
| + | |- | ||
| + | |} | ||
=== Get it! === | === Get it! === | ||
| Line 22: | Line 50: | ||
* Download the final version of SoaS: http://download.sugarlabs.org/soas/releases/soas-strawberry.iso | * Download the final version of SoaS: http://download.sugarlabs.org/soas/releases/soas-strawberry.iso | ||
* Install the following three packages on your machine: syslinux isomd5sum cryptsetup | * Install the following three packages on your machine: syslinux isomd5sum cryptsetup | ||
| − | * Download this script to put the image on your USB key: | + | * Download this script to put the image on your USB key: http://download.sugarlabs.org/soas/releases/livecd-iso-to-disk.sh |
* Plug your USB key in and unmount it afterwards | * Plug your USB key in and unmount it afterwards | ||
* Execute the script with the following command as root: | * Execute the script with the following command as root: | ||
| Line 62: | Line 90: | ||
=== Known Issues === | === Known Issues === | ||
| − | As Sugar on a Stick is based on [http://www.fedoraproject.org/ Fedora], namely the latest release - Fedora 11, it also contains a number of known issues, which should be mentioned. Recently, problems with ATI graphics hardware, as well as various Mac models have been reported. This was resolved by adding the ''nomodeset'' parameter to the kernel arguments. If you encounter image flickering or are not able to get past a black screen, it might be worth pressing | + | As Sugar on a Stick is based on [http://www.fedoraproject.org/ Fedora], namely the latest release - Fedora 11, it also contains a number of known issues, which should be mentioned. Recently, problems with ATI graphics hardware, as well as various Mac models have been reported. This was resolved by adding the ''nomodeset'' parameter to the kernel arguments. If you encounter image flickering or are not able to get past a black screen, it might be worth pressing escape at the blue screen, which appears for a second before the normal boot process starts. You'll be presented a short menu, at which you can directly press tab - just add the ''nomodeset'' argument then in the appearing line and boot with enter. For more information, please refer to the [https://fedoraproject.org/wiki/Common_F11_bugs#Hardware-related_issues list of common F11 bugs]. |
| + | |||
| + | === Custom Builds === | ||
| + | |||
| + | Instructions how to customize and compose an image will be provided here shortly. | ||
Revision as of 16:13, 23 June 2009
Sugar on a Stick - Strawberry
Release Notes - last update: 2009/06/23
This document provides instructions for preparing a Sugar on a Stick (SoaS) installation. It also contains a list of known issues and sources of further information. For more detailed information, please check the SoaS wiki page.
The Sugar on a Stick Strawberry release is based Fedora 11 and includes the latest updates as of June 22. It also features the last Sugar desktop environment, namely version 0.84, and additional activities to enrich the user experience. Interested users can download further activities from the Sugar Activity Library. This release is finally another step forward compared with the last beta release and now includes also supplementary sample content, which is directly available from the Journal. Apart from the default fructose activities, the following ones are included in this release.
| Activity Name | Activity Name |
| CartoonBuilder | Memorize |
| Colors | Moon |
| FlipSticks | Paint |
| FreeCell | Physics |
| InfoSlicer | Poll |
| IRC | Record |
| JigsawPuzzle | SliderPuzzle |
| JokeMachine | Speak |
| Labyrinth | StoryBuilder |
| Library | ViewSlides |
Get it!
Windows Users
- Download the latest version of Fedora LiveUSB Creator and extract it: https://fedorahosted.org/liveusb-creator/
- Plug your USB Key in and launch LiveUSB Creator
- Select Sugar on a Stick v1 Strawberry in the drop-down menu on the right
- Set the slider to at least 160 MB (use more if you've a key with more space)
- Click Create Live USB and wait for the process to finish
- Eject the device using the Safely Remove Hardware screen
Linux Users
- Download the final version of SoaS: http://download.sugarlabs.org/soas/releases/soas-strawberry.iso
- Install the following three packages on your machine: syslinux isomd5sum cryptsetup
- Download this script to put the image on your USB key: http://download.sugarlabs.org/soas/releases/livecd-iso-to-disk.sh
- Plug your USB key in and unmount it afterwards
- Execute the script with the following command as root:
Note: In this example, your USB device would be sdb! Adjust this before confirming the command, if necessary. Also, you might want to increase the home or overlay size if you have more than 1 GB of space.
./livecd-iso-to-disk.sh --overlay-size-mb 300 --home-size-mb 160 --delete-home --unencrypted-home soas-strawberry.iso /dev/sdb
Mac Users
- Mac users will need to have access to a Linux or Windows machine to prepare their USB key
- Create your SoaS as described above for the different systems
- Download the boot helper disk: http://download.sugarlabs.org/soas/releases/soas-boot.iso
- Put both the CD and the USB key in
- Turn the Mac on and press at the chime the "C" key
- It should boot from the CD and continue to use the USB key then
Note: This is an experimental method to run SoaS on a Mac. Not all hardware configurations might be supported, as it is also noted in the known issues section. If you run into issues, you might want to consider using a virtual machine.
Boot it!
- Set the option to boot from USB in your machine's BIOS and let it come up
- If your machine doesn't support that, download and burn: http://download.sugarlabs.org/soas/releases/soas-boot.iso
- Make sure to name your USB key FEDORA, as it won't be recognized otherwise
- Put both the CD and the USB key in and let it boot from CD
Use it!
You have successfully installed Sugar on a Stick - now you can explore it. If you are interested in a guide for Sugar, you might want to check this: http://en.flossmanuals.net/sugar
Help Us
Please share your feedback with us - it helps us to improve following versions of SoaS. You can always send an e-mail to our feedback address feedback@sugarlabs.org or join the It's an Education Project mailing list: http://lists.sugarlabs.org/listinfo/iaep
If you encounter any hardware related issues besides the ones listed below, please consider joining our hardware effort. There, you will be able to submit the specs of your hardware, so that we can look better into it and work together with upstream to resolve issues.
Finally, you might also submit a bug report at our bug tracker, for which you would need an account.
Known Issues
As Sugar on a Stick is based on Fedora, namely the latest release - Fedora 11, it also contains a number of known issues, which should be mentioned. Recently, problems with ATI graphics hardware, as well as various Mac models have been reported. This was resolved by adding the nomodeset parameter to the kernel arguments. If you encounter image flickering or are not able to get past a black screen, it might be worth pressing escape at the blue screen, which appears for a second before the normal boot process starts. You'll be presented a short menu, at which you can directly press tab - just add the nomodeset argument then in the appearing line and boot with enter. For more information, please refer to the list of common F11 bugs.
Custom Builds
Instructions how to customize and compose an image will be provided here shortly.