Sugar on a Stick/Installation/OLPC

2009-06-10T20:25:43Z

Rabbe: /* Option 2: Install the v0.84 Sugar on a Stick image */

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

==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 three 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 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]] or [[#Option 2: Install the v0.84 Sugar on a Stick image|Option 2]], 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.

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

wget {{SoaS-2 path}}

sudo yum install livecd-tools

sudo livecd-iso-to-disk --format --xo --xo-no-home {{SoaS-2 image}} /dev/sdX1

Where <code>/dev/sdX1</code> is the device associated with your removable media. The livecd-iso-to-disk script needs to be a current version with XO support (not what you get by default in Fedora 10). You can find an up-to date version in the SoaS disk image /LiveOS/livecd-iso-to-disk.

===Option 2: Install the v0.84 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

:(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 order wget, to install them by the order “yum install wget”

Next:

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

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

sudo sh livecd-iso-to-xo.sh {{SoaS-2 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 3: Update to the official OLPC v0.82 Sugar build===

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

sudo olpc-update 767

where 767 is the build number of the [http://wiki.laptop.org/go/Builds#Stable_builds latest stable release] from OLPC. This is OLPC release 8.2.0, incorporating Sugar v0.82.

As of March, OLPC has candidate builds for an upcoming 8.2.1 release.

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

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

[[Category:HowTo]]

Sugar Labs - User contributions [en]

Sugar on a Stick/Installation/OLPC