Changes

<noinclude>{{ GoogleTrans-en}}{{TeamHeader|Sugar on a Stick|home=Project Home|xbgColor=ffe792|join_label=Get Involved}}</noinclude>

<noinclude>{{TeamHeader|Sugar on a Stick|home=Project Home|xbgColor=ffe792|join_label=Get Involved}}

[[Image:SugarLabs3x.jpg|right]]

</noinclude>

<div style="font-size: smaller" align="right">released 22 June 2009</div>

[[File:SugarLabs3x.jpg|right|a Sugar environment you can carry in your pocket!|link=http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso]]

[[File:Logo_SoaS_01.png|200px|link=http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso]][http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso Strawberry]

== Sugar on a Stick - Strawberry ==

== Sugar on a Stick - Strawberry ==

'''Release Notes - last update: 2009/06/24'''

{{Note/note||Sugar on a Stick v1 '''Strawberry''' has been superseded by the [[Sugar_on_a_Stick/Blueberry|v2 Blueberry release]] as of 8 December 2009. See [[Sugar on a Stick/Downloads]] for the current release.}}

 

Release Notes - last software update: 24 June 2009

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 example how to use a Boot Helper CD for very old PCs. For more detailed information, please check the [[Sugar_on_a_Stick|SoaS wiki page]]. For more general information, please see the [[Sugar on a Stick/FAQ|Frequently Asked Questions (FAQ) page for Sugar on a Stick]].

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 example how to use a Boot Helper CD for very old PCs. For more detailed information, please check the [[Sugar_on_a_Stick|SoaS wiki page]]. For more general information, please see the [[Sugar on a Stick/FAQ|Frequently Asked Questions (FAQ) page for Sugar on a Stick]].

The Sugar on a Stick Strawberry release is based on Fedora 11 with the latest updates as of June 22. It also features the latest Sugar learning environment, namely [[Development Team/Release/Releases/Sucrose/0.84| version 0.84]], including 40 Activities to enrich the learning experience. Hundreds of Activities are available for download from the [http://activities.sugarlabs.org/ Sugar Activity Library]. This release is a step forward from the [[Sugar_on_a_Stick/Beta| beta release]]; in addition to Fedora updates, it includes supplementary sample content, which is available in the Journal. Apart from the default [[Sugar_on_a_Stick/Roadmap#Fructose_modules_.28F11.29|Fructose]] activities, additional Activities are included in this release.  (See the Sugar [[Taxonomy]] for an explanation of these codenames.)

The Sugar on a Stick Strawberry release is based on Fedora 11 with the latest updates as of June 22. It also features a recent Sugar learning environment, namely [[0.84/Notes| version 0.84]], including 40 Activities to enrich the learning experience. Hundreds of Activities are available for download from the [http://activities.sugarlabs.org/ Sugar Activity Library]. This release includes Fedora updates, new Sugar features like ''View Source'' and file transfer, supplementary sample content, which is available in the Journal, and usability improvements. Apart from the default [[Sugar_on_a_Stick/Roadmap#Fructose_modules_.28F11.29|Fructose]] activities, the following table of additional Activities are included in this release.  (See the Sugar [[Taxonomy]] for an explanation of these codenames.)

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"

| [http://activities.sugarlabs.org/en-US/sugar/addon/4027 Turtle Art] || ||

| [http://activities.sugarlabs.org/en-US/sugar/addon/4027 Turtle Art] || ||

|-

|-

| Write  ||  ||

| [http://activities.sugarlabs.org/en-US/sugar/addon/4201 Write] ||  ||

|}

|}

=== Get it! ===

=== Get it! ===

{{:Sugar on a Stick/Downloads}}

{{Transclude|Sugar on a Stick/Downloads}}

==== Windows Users ====

==== Windows Users ====

==== GNU/Linux Users ====

==== GNU/Linux Users ====

# Download the SoaS iso image from http://download.sugarlabs.org/soas/releases/soas-strawberry.iso,

# Download the SoaS iso image from {{SoaS release path}},

# Install these three packages: ''syslinux'', ''isomd5sum'', and ''cryptsetup'',

# Install these three packages: ''syslinux'', ''isomd5sum'', and ''cryptsetup'' ([[Sugar_on_a_Stick/Linux#Put_SoaS_onto_a_stick_using_Fedora_and_Ubuntu|details here]]),  

# Download this script: http://download.sugarlabs.org/soas/releases/livecd-iso-to-disk.sh

# Download this script: http://download.sugarlabs.org/soas/releases/livecd-iso-to-disk.sh

# Change mode to make the script executable,

# Change mode to make the script executable,

# Unmount the USB flash drive (e.g., <code>sudo umount /dev/sdb1</code>),

# Unmount the USB flash drive (e.g., <code>sudo umount /dev/sdb1</code>),

# Execute the script with the following command:

# Execute the script with the following command:

#:<code>sudo ./livecd-iso-to-disk.sh --overlay-size-mb 300 --home-size-mb 160 --delete-home --unencrypted-home soas-strawberry.iso /dev/sdb1</code>

#:<code>sudo ./livecd-iso-to-disk.sh --overlay-size-mb 300 --home-size-mb 160 --delete-home --unencrypted-home soas-1-strawberry.iso /dev/sdb1</code>

:'''Note:''' In this example, your USB device node is assumed to be sdb. Verify this before confirming the command. Also, you might want to increase the home or overlay size if you have more than 1 GB of space.

:'''Note:''' In this example, your USB device node is assumed to be sdb. Verify this before confirming the command. Also, you might want to increase the home or overlay size if you have more than 1 GB of space.

Apple Macintosh users will need to have access to a GNU/Linux or Windows machine to prepare their USB flash drive.

Apple Macintosh users will need to have access to a GNU/Linux or Windows machine to prepare their USB flash drive.

# Create your SoaS as described above;

# Create your SoaS as described above;

# Download the boot helper disk: http://download.sugarlabs.org/soas/releases/soas-boot.iso

# Download the boot helper disk: http://download.sugarlabs.org/soas/releases/soas-1-boot.iso

# Put both the CD and the USB flash drive into the machine;

# Put both the CD and the USB flash drive into the machine;

# Turn the Mac on and press at the chime the "C" key;

# Turn the Mac on and press at the chime the "C" key;

# It should boot from the CD and continue to use the USB flash drive from this point.

# It should boot from the CD and continue to use the USB flash drive from this point.

:'''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 below. If you run into issues, you might want to consider using a virtual machine. See [[#XO-1 & Virtual Machines]] section below.

:'''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 below. If you run into issues, you might want to consider using a virtual machine. See [[#XO-1 & Virtual Machines]] section below.

: More information is available [[Sugar on a Stick/Mac|here]].

: More information is available [[Macintosh|here]].

==== XO-1 & Virtual Machines ====

==== XO-1 & Virtual Machines ====

The use of SoaS on the OLPC XO-1, as well as in virtual machines, is currently in an experimental state. Instructions for both categories are being developed here for [[Sugar on a Stick/Installation/OLPC|XO-1]], [[VirtualBox]], & [[VMware#Soas-Strawberry.iso_installed_to_VM_Hard_Disk|VMware]]. In the meantime, you might want to refer to the information on the general SoaS [[Sugar_on_a_Stick| wiki page]].

The use of SoaS on the OLPC XO-1, as well as in virtual machines, is currently in an experimental state. Instructions for both categories are being developed here for '''[[Sugar on a Stick/Installation/OLPC|XO-1]]''', '''[[VirtualBox]]''', & '''[[VMware#Soas-Strawberry.iso_installed_to_VM_Hard_Disk|VMware]]'''. In the meantime, you might want to refer to the information on the general SoaS [[Sugar_on_a_Stick| wiki page]].

=== Boot it ===

=== Boot it ===

==== Helper CD ====

==== Helper CD ====

If your machine doesn't support booting from USB devices, then download and burn to CD. [http://www.dvdflick.net/download.php DVD flick] is free and here's a [http://www.youtube.com/watch?v=OzYtvm77W_s video] to show you how it works.

If your machine doesn't support booting from USB devices, then download the following soas-1-boot.iso and burn it to a CD.

* [http://www.imgburn.com/ ImgBurn] and [http://www.dvdflick.net/download.php DVD flick] are some freeware, .iso burning tools for Windows.

Download the ISO...

Download the boot support helper CD image at http://download.sugarlabs.org/soas/releases/soas-1-boot.iso.

http://download.sugarlabs.org/soas/releases/soas-boot.iso.

# Use [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), otherwise it won't be recognized by the boot-support CD.

# Use [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), otherwise it won't be recognized by the boot-support CD.

# Put both the boot-support CD and the USB flash drive in your computer and let it boot from the CD.

# Put both the boot-support CD and the USB flash drive in your computer and let it boot from the CD.

== Help Us ==

== Help Us ==

Please share your feedback with us; it will help us to improve Sugar in subsequent versions of SoaS. You can always send an e-mail to [mailto:feedback@sugarlabs.org feedback@sugarlabs.org] or join the ''<nowiki>It's an Education Project</nowiki>'' mailing list: http://lists.sugarlabs.org/listinfo/iaep.  See all our [[Sugar Labs/Contacts|'''communication channels''']] and our [[Sugar Labs/Getting Involved|'''Getting Involved''']] pages.

Please share your feedback with us; it will help us to improve Sugar in subsequent versions of SoaS. Join the ''Sugar on a Stick (SoaS)'' mailing list: http://lists.sugarlabs.org/listinfo/soas, or you can always join the ''It's an Education Project'' mailing list: http://lists.sugarlabs.org/listinfo/iaep.  See all our [[Sugar Labs/Communication channels|'''communication channels''']] and our [[Sugar Labs/Getting Involved|'''Getting Involved''']] pages.

If you encounter any hardware-related issues besides the ones [[#Known Issues|listed below]], please consider joining our [[Sugar_on_a_Stick/Hardware| hardware effort]]. Please submit the specifications of your hardware so that we work together with 'upstream' to resolve any issues.

If you encounter any hardware-related issues besides the ones [[#Known Issues|listed below]], please consider joining our [[Sugar_on_a_Stick/Hardware| hardware effort]]. Please submit the specifications of your hardware so that we work together with 'upstream' to resolve any issues.

Finally, you might also consider submitting bug reports at our [http://dev.sugarlabs.org/ bug tracker] (you would need to create an account).

Finally, you might also consider submitting bug reports at our [https://bugs.sugarlabs.org bug tracker] (you would need to create an account).

=== Known Issues ===

=== Known Issues ===

* If you encounter image flickering or are not able to get past a black screen, it might be worth pressing the <Escape> key 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, then just add the ''nomodeset'' argument in the appearing line, and then boot by pressing the <Enter> key.  

* If you encounter image flickering or are not able to get past a black screen, it might be worth pressing the <Escape> key 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, then just add the ''nomodeset'' argument in the appearing line, and then boot by pressing the <Enter> key.  

For more information, please refer to the [http://fedoraproject.org/wiki/Common_F11_bugs#Hardware-related_issues list of common F11 bugs].

For more information, please refer to the [http://fedoraproject.org/wiki/Common_F11_bugs#Hardware-related_issues list of common F11 bugs].

 

=== Custom Builds ===

=== Custom Builds ===

Preliminary instructions how to customize and compose an image can be found [[Sugar_on_a_Stick/Customization| here]].

Preliminary instructions how to customize and compose an image can be found [[Sugar_on_a_Stick/Customization| here]].