Changes

[[Image:SugarLabs3x.jpg|right]]

[[Image:SugarLabs3x.jpg|right]]

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]].

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]].

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 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.

The Sugar on a Stick Strawberry release is based Fedora 11 with the latest updates as of June 22. It also features the latest Sugar learning environment, namely [[DevelopmentTeam/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.)

{| 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;"

==== Windows Users ====

==== Windows Users ====

# Download the latest version of Fedora ''LiveUSB Creator'' from https://fedorahosted.org/liveusb-creator/ and extract it;

# Download the latest version of Fedora ''LiveUSB Creator'' from http://fedorahosted.org/liveusb-creator/ and extract it;

# Plug a target USB key into your computer (minimum 1-gigabyte);

# Plug a target USB flash drive into your computer (minimum 1-gigabyte);

# Use the ''Format'' dialog to rename your USB ''Volume'' to FEDORA;

# Use the ''Format'' dialog to rename your USB ''Volume'' to FEDORA;

# Launch''LiveUSB Creator'';

# Launch ''LiveUSB Creator'';

# Select ''Sugar on a Stick v1 Strawberry'' in the drop-down menu on the upper-right side of the ''LiveUSB Creator'' window;

# Select ''Sugar on a Stick v1 Strawberry'' in the drop-down menu on the upper-right side of the ''LiveUSB Creator'' window;

# Set the ''Persistent Storage'' slider to at least 160 MB (use more if you have a key with more space);

# Set the ''Persistent Storage'' slider to at least 160 MB (use more if you have a drive with more space);

# Select your USB key as the target;

# Select your USB flash drive as the target;

# Click the ''Create Live USB'' button and then wait for the process to finish (about 5 minutes);

# Click the ''Create Live USB'' button and then wait for the process to finish (about 5 minutes);

# Eject the USB key using the ''Safely Remove Hardware'' dialog.

# Eject the USB flash drive using the ''Safely Remove Hardware'' dialog.

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

==== Linux Users ====

==== Linux Users ====

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

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

# 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

# Plug your target USB key into your computer;

# Plug your target USB flash drive into your computer;

# Unmount the USB key (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/sdb</code>

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

:'''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.

:'''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.

 

==== Mac Users ====

==== Mac Users ====

Mac users will need to have access to a Linux or Windows machine to prepare their USB key.

Mac users will need to have access to a 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-boot.iso

# Put both the CD and the USB key 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 key 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.

:'''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.

 

==== XO-1 & VMs ====

==== XO-1 & VMs ====

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 will be provided here at a later time. 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! ===

* Set the option to boot from USB in your machine's BIOS and let it come up

* 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

* 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

* Make sure to name your USB flash drive FEDORA, as it won't be recognized otherwise

* Put both the CD and the USB key in and let it boot from CD

* Put both the CD and the USB flash drive in and let it boot from CD

=== Use it! ===

=== Use it! ===

Once you have successfully launched Sugar on a Stick you should explore the Sugar Learning Platform. There is a [http://en.flossmanuals.net/sugar guide to Sugar] and help pages dedicated to most activities. (Try running Sugar on more than one machine so you can enjoy its collaboration features.)

Once you have successfully launched Sugar on a Stick you should explore the Sugar Learning Platform. There is a [http://en.flossmanuals.net/sugar guide to Sugar] and help pages dedicated to most activities. (Do try running Sugar on more than one machine so you can enjoy its collaboration features.)

== 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

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.

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.

Sugar on a Stick Strawberry is based on [http://www.fedoraproject.org/ Fedora 11], the latest release. Consequently, it contains a number of known issues with Fedora images that should be mentioned.

Sugar on a Stick Strawberry is based on [http://www.fedoraproject.org/ Fedora 11], the latest release. Consequently, it contains a number of known issues with Fedora images that 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.

* 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.  

* 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 [https://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]].