Sugar Labs - User contributions [en]

Sugar on a Stick/Installation/OLPC

2009-11-02T15:54:19Z

Tvoverbeek: Fixed link to Fedora XO builds (xo-1 -> XO-1)

<noinclude>{{ Translations | [[Sugar_on_a_Stick/Installation/OLPC|english]] | [[Sugar_on_a_Stick/Installation/OLPC/lang-es|español]] | [[Sugar_on_a_Stick/Installation/OLPC/lang-fr|français]] }} {{GoogleTrans-en}}</noinclude>

==Do you have an OLPC XO-1?==

[[image:OLPCXO.png]]


Sugar 0.84 has a number of improvements above and beyond 0.82. And we have a version working on the OLPC XO-1, but because of the changes in process at OLPC (see [[olpc:Future releases]]), there is a new short-term strategy for updates. Until OLPC issues its next official release, we are recommending that XO-1 users who would like to try 0.84 use Sugar on a Stick. The XO-1 can be booted from an external USB or SD card storage device, [[#Option 1: Run v0.84 of Sugar on a Stick from an SD card or external USB|Option 1]] below.

----

There are four main options for OLPC XO users:
# Run v0.84 Sugar on a Stick from a USB flash drive or SD card
# Install v0.84 Sugar on a Stick-XO on the XO-1's internal NAND flash memory
# Convert a v0.84 Sugar on a Stick .iso image to one suitable to install on the XO-1's internal NAND flash memory
# Use <tt>olpc-update</tt> to update to the latest software release from OLPC (which is currently 8.2.0 incorporating Sugar v0.82).

'''Note:''' The OLPC XO-1 has some built-in protections which lock the computer down in order to prevent haphazard software changes. In order to use either [[#Option 1: Run v0.84 of Sugar on a Stick from an SD card or external USB|Option 1]], [[#Option 2: Install a v0.84 SoaS-XO image on the XO-1 NAND flash drive|Option 2]], or [[#Option 3: Convert a v0.84 Sugar on a Stick .iso image|Option 3]], XO-1 owners must [http://wiki.laptop.org/go/Activation_and_developer_keys request a developer key from OLPC]; it's a simple process but takes up to 24 hours.

'''Warning:''' Options 2 & 3 will wipe /security directory, with any leases or devkeys there.

===Option 1: Run v0.84 of Sugar on a Stick from an SD card or external USB===

(Requires a [http://wiki.laptop.org/go/Activation_and_developer_keys developer key for your OLPC-XO-1] and access to a Windows or Fedora computer)

====On Windows:====

Create the USB stick as described on the [[Sugar on a Stick/Windows]] page in the "Windows Instructions" section.

Do '''not''' boot this stick on your Windows machine. Make sure the first boot is on your XO. If you do boot the stick on another machine first, the X server setup needed for the XO will not be done.

====On Fedora:====
Type the following commands in a terminal window:
[[wikipedia:Wget|wget]] {{SoaS release path}}
 
sudo yum install livecd-tools
 
wget -O livecd-iso-to-disk.sh "http://git.fedoraproject.org/git/?p=hosted/livecd;a=blob_plain;f=tools/livecd-iso-to-disk.sh;hb=HEAD"
 
sudo ./livecd-iso-to-disk.sh --format --xo --xo-no-home {{SoaS release image}} /dev/sd''X''1

Where <code>/dev/sdX1</code> is the device associated with your removable media.

The livecd-iso-to-disk.sh script needs to be a current version with XO support (not what you get by default in Fedora 10, though Fedora 11's should be fine). You can find an up-to date version in the SoaS disk image /LiveOS/livecd-iso-to-disk.sh .

===Option 2: Install a v0.84 SoaS-XO image on the XO-1 NAND flash drive===
See:
*http://www.mail-archive.com/sugar-devel@lists.sugarlabs.org/msg05231.html and *https://www.redhat.com/archives/fedora-olpc-list/2009-June/msg00063.html

This build feels substantially faster than 802 (the last stable release). Serious issues:

* No sound
* No automounting of USB keys.

==== More recent builds are better ====
See:
* http://lists.sugarlabs.org/archive/sugar-devel/2009-August/017775.html
* The builds are located in http://people.sugarlabs.org/~mtd/soas-xo1/
* The Fedora builds for the XO are here: http://dev.laptop.org/~smparrish/XO-1/builds

Be sure to update your XO to the latest firmware:

http://wiki.laptop.org/go/OLPC_Firmware_q2e41

===Option 3: Convert a v0.84 Sugar on a Stick .iso image===

'''WARNING''': This option is wishful thinking until the [https://bugzilla.redhat.com/show_bug.cgi?id=500196 jffs2 mount bug] is fixed.

'''Note''': Requires a [http://wiki.laptop.org/go/Activation_and_developer_keys developer key for your OLPC-XO-1] and access to a GNU/Linux computer) It also requires a recent OFW version (Q2E28 has been reported as working. [http://wiki.laptop.org/go/Manual_Firmware_Install Instructions for updating your firmware]).

'''WARNING''': this will overwrite all data on your OLPC-XO-1 NAND!!

On a Fedora10 system:

sudo yum -y install crcimg mtd-utils

On Debian or Ubuntu:

sudo apt-get install mtd-utils

:(On some older Debian/Ubuntu builds, you may need to install mtd-tools instead.)

:crcimg is not packaged for Debian so you'll have to build it:

wget http://dev.laptop.org/~mstone/releases/SOURCES/crcimg-1.1.tar.bz2
tar xvf crcimg-1.1.tar.bz2
sudo make -f Makefile.build install

NB: Of course, if you do not have the packages of the program [[wikipedia:Wget| wget]], install them by the command “yum install wget”

Next:

wget http://download.sugarlabs.org/soas/releases/livecd-iso-to-disk.sh
wget {{SoaS release path}}

run this command (or something similar depending on the version number of your .iso file)

sudo sh livecd-iso-to-xo.sh {{SoaS release image}} Soas.img

and then copy Soas.img and Soas.crc to a USB key or SD card

On the OLPC-XO-1, boot with the USB key plugged in and the four game keys press to get to the OK prompt in Open Firmware (OFW).

Type the following commands:

disable-security
copy-nand u:\Soas.img

Note: depending upon the file system on your USB key, the names maybe truncated:

dir u:\
copy-nand u:\SOAS-2~1.img

You should see an animation of the blocks being written to the NAND. When it is complete, you will be back at the OK prompt. Type:

reboot

and the OLPC-XO-1 will reboot and you should be running Sugar 0.84.

===Option 4: Update to the official OLPC v0.82 Sugar build===
(This does ''not'' give you a '''Sugar on a Stick''' image.)

You run ''olpc-update'' from the Terminal activity, ''e.g.'',:

sudo olpc-update 802

where 802 is the build number of the [[OLPC:OS images | latest stable image]] from OLPC. This is OLPC release 8.2.1, incorporating Sugar v0.82.

[[Supported_systems#Fedora_on_an_OLPC_XO]] has some more details on upgrading OLPC software.

== Notes on running Sugar on a Stick on XO-1 ==
* You must hold down the XO-1's '''✓''' ("check") gamepad key during boot, otherwise boot will hang at the gray "XO" logo. You should see dots appear under the USB flash drive icon indicating the XO is booting from that drive.

* SoaS images are based on Fedora "Rawhide" spins; [[olpc:Rawhide-XO]] describes many of the known issues running these on an XO-1.

* Also make sure you got a dev-key before booting with the SoaS using the check button. (It takes 24 hours to get a developer key, so please plan accordingly.)

----
[[Downloads|back to downloads page]]
__NOTOC__

[[Category:HowTo]]

Sugar on a Stick

2009-04-20T19:07:22Z

Tvoverbeek: updated boot helper cd instructions

<noinclude>{{ Translations | [[Sugar_on_a_Stick|english]] | [[Sugar_on_a_Stick/lang-es|español]] }}{{GoogleTrans-en | es =show | bg =show | zh-CN =show | zh-TW =show | hr =show | cs =show | da =show | nl =show | fi =show | fr =show | de =show | el =show | hi =show | it =show | ja =show | ko =show | no =show | pl =show | pt =show | ro =show | ru =show | sv =show }}{{TeamHeader|Sugar on a Stick|home=Project Home|xbgColor=ffe792}}
{{TOCright}}
[[Image:Soas.jpg|thumb]] [[Image:Soas-1.png|thumb]]

== Introduction ==

Sugar Labs offers ubiquitous access to Sugar in a USB (Universal Serial Bus) flash memory drive (stick). The Sugar on a Stick project (''still in Beta'') gives children access to ''their'' Sugar on any computer in their environment with just a USB memory stick. Taking advantage of the Fedora LiveUSB, it's possible to store everything you need to run Sugar on a single USB memory stick (minimum size 1GB). This small USB device can boot into the Sugar learning platform on different computers at home, at school, or at an after school program, bypassing the software on the those computers. In fact, Sugar on a Stick will work even if the computer does not have a hard-drive. With Sugar on a Stick, the learning experience is the same on any computer: at school, at home, at the library, or an after-school center.

You can learn more from [http://www.xconomy.com/boston/2009/02/05/sugar-beyond-the-xo-laptop-walter-bender-on-olpc-sucrose-084-and-sugar-on-a-stick/ Walter Bender's interview with Xconomy], [http://www.olpcnews.com/software/sugar/sugar_on_a_stick_netbooks.html Wayan Vota's video] and [http://www.flickr.com/photos/curiouslee/sets/72157613785006745/ Mike Lee's pictures].

'''What's exactly on the Stick''': The Fedora version contains a compressed copy of Fedora 11 that will boot, run in memory and maintain changes on a USB flash drive with a standard FAT16 or FAT32 partition. The files coexist with other files the user may have or put on the disk. Different types of configurations are being designed to offer the options to run virtualizations or emulations and to use virtual machines on existing computers saving the Sugar Home folder (user's work) on the Stick for use at another workstation. See our [[Sugar on a Stick/Resources| resources]] for more information.

== Project Goals ==

* Sugar on a Stick as 1-to-1 computing in an elementary school
* Sugar on a Stick to empower middle- and high-school students to help test
* Sugar on a Stick for conferences to let people try Sugar and collaborate with other conference participants

== Getting Sugar on a Stick (beta) ==

'''Note:''' The first SoaS beta is now available! Please check the [[/Beta|release notes]] and download it, unless you're a Windows user (in which case you'll be able to download it directly when creating your stick), from here: http://download.sugarlabs.org/soas/releases/soas-beta.iso

We had a SoaS pre-release on April 10th, 2009 at [http://www.ncose.org/node/47 FOSSVT], where we premiered and distributed SoaS. We are testing the beta image again this week (the week of April 13) and are ready for the final release now.

Please download, test (see [[Smoke test]]), and give feedback (on sugar-devel@lists.sugarlabs.org and [[Sugar on a Stick/Getting Involved]]) – please follow the instructions below to download a copy!

'''Requirement:''' You'll need a USB key, with a size of at least 1 GB!

=== Create Your Stick ===

Please select your operating system below to get further instructions.


[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Windows http://wiki.sugarlabs.org/images/f/f9/Windows.gif]
[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Mac http://wiki.sugarlabs.org/images/7/76/Apple.gif]
[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux http://wiki.sugarlabs.org/images/9/97/Penguin.png]


You can also download the ''virtual appliance'' below to run SoaS in a virtual machine. If you've done so, please follow the instructions [[/VirtualBox|here]].

=== Boot ===

If you have an older machine or you just want things to immediately work without fussing with the BIOS, 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 stick: http://people.sugarlabs.org/sdz/soas-boot.iso.
Note that when you use this method your USB stick must have the label FEDORA. Name the stick FEDORA '''before''' running liveusb-creator. This ensures the persistent overlay will be used when booting with the "Boot Helper" CDO.

On most modern computers its possible to set the target computer's BIOS to boot from USB so you don't need a CD at all! 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.

=== Use ===

Once your stick boots, you'll find yourself in your own Sugar environment, ready to play and learn.

For a guide on how to use Sugar, see the [http://en.flossmanuals.net/sugar FLOSSmanuals Sugar Users Guide]. [[olpc:Keyboard_shortcuts]] lists some of the Sugar keyboard shortcuts on a PC keyboard.

Let us know how it goes! Send e-mail to iaep@lists.sugarlabs.org. This is our "Its an Education Project" mailing list.

== Help the project ==

Please keep notes on which version of Sugar on a Stick you have downloaded when reporting issues.

* When booting SoaS, you'll see for a short time a screen showing a kind of solar system.
* Press the "Escape" button here and you'll get to the boot menu.
* There, you should find the images name in the following structure: ''Soas{version number}-{date of creation}''

Alternatively, you can also refer to the name of the .iso file, if you still have it around.

To find out which version of Sugar you are using you can look it up in the 'About my Computer' Section in the Control Panel.

Report bugs to http://dev.sugarlabs.org/. Use the "SoaS" component when entering new bugs.

=== For Developers: Downloading alternative images ===

We've now various solutions available, which are listed below. Some of those might still be unstable and in testing, which means that ''they might not work yet.''

* The SoaS beta release is currently based on ''{{SoaS-2 beta}}''. It's the most stable solution we've available right now and is recommended for usage.

* On the other hand, you can also grab the a snapshot, which includes the latest bits, but might contain some issues. We really need your help on testing those to move forward!

* The virtual appliance is ''not ready'' for general use and under heavy development. Any help with testing it is appreciated, though.

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"
|-style="background:#787878; color: white;"
| '''available solution''' || '''current state''' || '''download location'''
|-
| SoaS ''Beta'' || beta quality || http://download.sugarlabs.org/soas/releases/soas-beta.iso
|-
| SoaS ''Snapshot'' || varying quality || {{SoaS-2 path}}
|-
| SoaS ''Virtual Appliance'' || alpha quality || {{SoaS-2 app-path}}
|-
|}

Previous snapshots are provided in the subsequent directories on http://download.sugarlabs.org/soas/.

=== Testing ===

For testing SoaS, you might want to follow the Sugar [[Smoke_test| Smoke Test]] procedures.
See the [[/Getting Involved| Getting Involved]] page for details.

=== Join the development effort ===

* We are experimenting with the [http://schools.sugarlabs.org/mod/forum/view.php?id=530 Sugar Labs Moodle system] to help in coordinating deployment work on this project.
* Development discussions take place on the Sugar-Devel email list, http://lists.sugarlabs.org/listinfo/sugar-devel.
* Real-time development chat is at irc://irc.freenode.net#sugar Mibbit: [http://embed.mibbit.com/?server=irc.freenode.net&channel=%23sugar&noServerTab=false #sugar]
*[http://git.sugarlabs.org/projects/soas Gitorious SoaS home]

=== Roadmap ===

Review and contribute to plans and schedules on the [[/Roadmap| Project roadmap page]].

== See Also ==
* [[OLPC:Rawhide-XO]] for the closely related development of Sugar for the XO-1 laptop on Fedora 11.
* [[Deployment Team/School_Key]] Information on various Sugar on a Stick deployments.
* Protocol for [[April 17 Olin Play Session]]
* Notes from [[April 18th YMCA Healthy Kids Day]]

===[[/Subpages]]===

[[Category:Project]]

Sugar on a Stick

2009-04-19T01:17:45Z

Tvoverbeek: USB stick must be labelled FEDORA when using "Boot Helper" CD

<noinclude>{{ Translations | [[Sugar_on_a_Stick|english]] | [[Sugar_on_a_Stick/lang-es|español]] }}{{GoogleTrans-en | es =show | bg =show | zh-CN =show | zh-TW =show | hr =show | cs =show | da =show | nl =show | fi =show | fr =show | de =show | el =show | hi =show | it =show | ja =show | ko =show | no =show | pl =show | pt =show | ro =show | ru =show | sv =show }}{{TeamHeader|Sugar on a Stick|home=Project Home|xbgColor=ffe792}}
{{TOCright}}
[[Image:Soas.jpg|thumb]] [[Image:Soas-1.png|thumb]]

== Introduction ==

Sugar Labs offers ubiquitous access to Sugar in a USB (Universal Serial Bus) flash memory drive (stick). The Sugar on a Stick project (''still in Beta'') gives children access to ''their'' Sugar on any computer in their environment with just a USB memory stick. Taking advantage of the Fedora LiveUSB, it's possible to store everything you need to run Sugar on a single USB memory stick (minimum size 1GB). This small USB device can boot into the Sugar learning platform on different computers at home, at school, or at an after school program, bypassing the software on the those computers. In fact, Sugar on a Stick will work even if the computer does not have a hard-drive. With Sugar on a Stick, the learning experience is the same on any computer: at school, at home, at the library, or an after-school center.

You can learn more from [http://www.xconomy.com/boston/2009/02/05/sugar-beyond-the-xo-laptop-walter-bender-on-olpc-sucrose-084-and-sugar-on-a-stick/ Walter Bender's interview with Xconomy], [http://www.olpcnews.com/software/sugar/sugar_on_a_stick_netbooks.html Wayan Vota's video] and [http://www.flickr.com/photos/curiouslee/sets/72157613785006745/ Mike Lee's pictures].

'''What's exactly on the Stick''': The Fedora version contains a compressed copy of Fedora 11 that will boot, run in memory and maintain changes on a USB flash drive with a standard FAT16 or FAT32 partition. The files coexist with other files the user may have or put on the disk. Different types of configurations are being designed to offer the options to run virtualizations or emulations and to use virtual machines on existing computers saving the Sugar Home folder (user's work) on the Stick for use at another workstation. See our [[Sugar on a Stick/Resources| resources]] for more information.

== Project Goals ==

* Sugar on a Stick as 1-to-1 computing in an elementary school
* Sugar on a Stick to empower middle- and high-school students to help test
* Sugar on a Stick for conferences to let people try Sugar and collaborate with other conference participants

== Getting Sugar on a Stick (beta) ==

'''Note:''' The first SoaS beta is now available! Please check the [[/Beta|release notes]] and download it, unless you're a Windows user (in which case you'll be able to download it directly when creating your stick), from here: http://download.sugarlabs.org/soas/releases/soas-beta.iso

We had a SoaS pre-release on April 10th, 2009 at [http://www.ncose.org/node/47 FOSSVT], where we premiered and distributed SoaS. We are testing the beta image again this week (the week of April 13) and are ready for the final release now.

Please download, test (see [[Smoke test]]), and give feedback (on sugar-devel@lists.sugarlabs.org and [[Sugar on a Stick/Getting Involved]]) – please follow the instructions below to download a copy!

'''Requirement:''' You'll need a USB key, with a size of at least 1 GB!

=== Create Your Stick ===

Please select your operating system below to get further instructions.


[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Windows http://wiki.sugarlabs.org/images/f/f9/Windows.gif]
[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Mac http://wiki.sugarlabs.org/images/7/76/Apple.gif]
[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux http://wiki.sugarlabs.org/images/9/97/Penguin.png]


You can also download the ''virtual appliance'' below to run SoaS in a virtual machine. If you've done so, please follow the instructions [[/VirtualBox|here]].

=== Boot ===

If you have an older machine or you just want things to immediately work without fussing with the BIOS, 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 stick: http://people.sugarlabs.org/sdz/soas-boot.iso. Note that when you use this method your USB stick must have the label FEDORA. Otherwise the boot will hang. Also when booting with the "Boot Helper" CD the persistent storage will not be used.

On most modern computers its possible to set the target computer's BIOS to boot from USB so you don't need a CD at all! 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.

=== Use ===

Once your stick boots, you'll find yourself in your own Sugar environment, ready to play and learn.

For a guide on how to use Sugar, see the [http://en.flossmanuals.net/sugar FLOSSmanuals Sugar Users Guide]. [[olpc:Keyboard_shortcuts]] lists some of the Sugar keyboard shortcuts on a PC keyboard.

Let us know how it goes! Send e-mail to iaep@lists.sugarlabs.org. This is our "Its an Education Project" mailing list.

== Help the project ==

Please keep notes on which version of Sugar on a Stick you have downloaded when reporting issues.

* When booting SoaS, you'll see for a short time a screen showing a kind of solar system.
* Press the "Escape" button here and you'll get to the boot menu.
* There, you should find the images name in the following structure: ''Soas{version number}-{date of creation}''

Alternatively, you can also refer to the name of the .iso file, if you still have it around.

To find out which version of Sugar you are using you can look it up in the 'About my Computer' Section in the Control Panel.

Report bugs to http://dev.sugarlabs.org/. Use the "SoaS" component when entering new bugs.

=== For Developers: Downloading alternative images ===

We've now various solutions available, which are listed below. Some of those might still be unstable and in testing, which means that ''they might not work yet.''

* The SoaS beta release is currently based on ''{{SoaS-2 beta}}''. It's the most stable solution we've available right now and is recommended for usage.

* On the other hand, you can also grab the a snapshot, which includes the latest bits, but might contain some issues. We really need your help on testing those to move forward!

* The virtual appliance is ''not ready'' for general use and under heavy development. Any help with testing it is appreciated, though.

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"
|-style="background:#787878; color: white;"
| '''available solution''' || '''current state''' || '''download location'''
|-
| SoaS ''Beta'' || beta quality || http://download.sugarlabs.org/soas/releases/soas-beta.iso
|-
| SoaS ''Snapshot'' || varying quality || {{SoaS-2 path}}
|-
| SoaS ''Virtual Appliance'' || alpha quality || {{SoaS-2 app-path}}
|-
|}

Previous snapshots are provided in the subsequent directories on http://download.sugarlabs.org/soas/.

=== Testing ===

For testing SoaS, you might want to follow the Sugar [[Smoke_test| Smoke Test]] procedures.
See the [[/Getting Involved| Getting Involved]] page for details.

=== Join the development effort ===

* We are experimenting with the [http://schools.sugarlabs.org/mod/forum/view.php?id=530 Sugar Labs Moodle system] to help in coordinating deployment work on this project.
* Development discussions take place on the Sugar-Devel email list, http://lists.sugarlabs.org/listinfo/sugar-devel.
* Real-time development chat is at irc://irc.freenode.net#sugar Mibbit: [http://embed.mibbit.com/?server=irc.freenode.net&channel=%23sugar&noServerTab=false #sugar]
*[http://git.sugarlabs.org/projects/soas Gitorious SoaS home]

=== Roadmap ===

Review and contribute to plans and schedules on the [[/Roadmap| Project roadmap page]].

== See Also ==
* [[OLPC:Rawhide-XO]] for the closely related development of Sugar for the XO-1 laptop on Fedora 11.
* [[Deployment Team/School_Key]] Information on various Sugar on a Stick deployments.
* Protocol for [[April 17 Olin Play Session]]
* Notes from [[April 18th YMCA Healthy Kids Day]]

===[[/Subpages]]===

[[Category:Project]]

Sugar on a Stick/Installation/OLPC

2009-03-09T20:03:29Z

Tvoverbeek: Sticks produced with liveusb creator 3.6 on Windows boot on XO

<noinclude>
{{ Translations | [[Sugar_on_a_Stick/Installation/OLPC|english]] | [[Sugar_on_a_Stick/Installation/OLPC/lang-es|español]] | [[Sugar_on_a_Stick/Installation/OLPC/lang-fr|français]] }}
{{ GoogleTrans-en | es =show | bg =show | zh-CN =show | zh-TW =show | hr =show | cs =show | da =show | nl =show | fi =show | fr =show | de =show | el =show | hi =show | it =show | ja =show | ko =show | no =show | pl =show | pt =show | ro =show | ru =show | sv =show }}
</noinclude>
__NOTOC__
==Do you have an OLPC XO-1?==


[http://wiki.sugarlabs.org/go/Supported_systems#Fedora_on_an_OLPC_XO http://sugarlabs.org/wiki/images/8/80/OLPCXO.png]


There are three main options for OLPC XO users: (1) olpc-update; (2) install Sugar on a Stick on the internal NAND; and (3) Sugar on a Stick on an SD card.

===Update to the latest Sugar build===

You run ''olpc-update'' from the Terminal activity, e.g.,:

sudo olpc-update 767

where 767 is [http://wiki.laptop.org/go/Builds#Stable_builds the latest stable release] from OLPC (OLPC 8.2, Sugar 0.82)

Details regarding the 8.2.1 release will be available in late March or early April.

More details can be found [[Supported_systems#Fedora_on_an_OLPC_XO|here]].

===Install the Sugar on a Stick image===

'''Note''': Requires a [http://wiki.laptop.org/go/Activation_and_developer_keys developer key for your OLPC-XO-1] and access to a GNU/Linux computer) It also requires a recent OFW version (Q2E28 has been reported as working. [http://wiki.laptop.org/go/Manual_Firmware_Install Instructions for updating your firmware]).

'''WARNING''': this will overwrite all data on your OLPC-XO-1 NAND!!

On a Fedora10 system:

sudo yum -y install crcimg mtd-utils

On Debian or Ubuntu:

sudo apt-get install mtd-utils

:crcimg is not packaged for Debian so you'll have to build it:

wget http://dev.laptop.org/~mstone/releases/SOURCES/crcimg-1.1.tar.bz2
tar xvf crcimg-1.1.tar.bz2
sudo make -f Makefile.build install

Next:

wget http://dev.laptop.org/~cjb/rawhide-xo/livecd-iso-to-xo.sh
wget {{SoaSiso}}

run this command (or something similar depending on the version number of your .iso file)

sudo sh livecd-iso-to-xo.sh Soas-200903051021.iso Soas-200903051021.img

and then copy Soas-200903051021.img and Soas-200903051021.crc to a USB key or SD card

On the OLPC-XO-1, boot with the USB key plugged in and the four game keys press to get to the OK prompt in Open Firmware (OFW).

Type the following commands:

disable-security
copy-nand u:\Soas-200903051021.img

Note: depending upon the file system on your USB key, the names maybe truncated:

dir u:\
copy-nand u:\SOAS-2~1.img

You should see an animation of the blocks being written to the NAND. When it is complete, you will be back at the OK prompt. Type:

reboot

and the OLPC-XO-1 will reboot and you should be running Sugar 0.84.

===Run Sugar on a Stick from an SD card or external USB===

(Requires a [http://wiki.laptop.org/go/Activation_and_developer_keys developer key for your OLPC-XO-1] and access to a Windows or Fedora computer)

====On Windows:====

Create the USB stick as described on the [http://sugarlabs.org/go/Sugar_on_a_Stick/Installation/Windows Sugar on a Stick/Installation/Windows] page in the "Instructions for creating a Sugar-on-a-Stick USB key from Windows" section.

Do '''not''' boot this stick on your Windows machine. Make sure the first boot is on your XO. If you do boot the stick on an other machine first, the X server setup needed for the XO will not be done.

====On Fedora:====

wget {{SoaSiso}}

sudo yum install livecd-tools

sudo livecd-iso-to-disk --format --xo --xo-no-home Soas-200903051021.iso /dev/sdX1

where <code>/dev/sdX1</code> is the device associated with your removable media.

----

[[Downloads|back to downloads page]]