User:Mchua/Braindumps/upgrade draft

From OLPC
< User:Mchua‎ | Braindumps
Revision as of 14:00, 6 October 2008 by Mchua (talk | contribs)
Jump to: navigation, search
Stop hand.png WARNING:
The content of this section is considered
DEPRECATED and OBSOLETE
It is preserved for historical or documenting reasons.

Getting 8.2.0 on your XO

So you want upgrade to 8.2.0 on your XO! It has shiny new features.

If you want to wipe out everything on your XO and start with a fresh version of the 8.2.0 release and its Activities, see the "Making my XO like new" section below. If you use this method, your Journal entries will be lost--all of your data will be erased!

If you want to upgrade to the new software but keep the work you've done in your Journal, see the "Keep my work, but give me the new software" section below. Your XO needs to be connected to the internet--otherwise, you will have to use the "Making my XO like new" instructions. When you upgrade to 8.2.0, you may not be able to use all the Activities you were using with the previous build. You might also be unable to use any Journal entries that were made using Activities that do not work with 8.2.0.

Making my XO like new

If you have access to the Internet, you can prepare yourself to restore an XO to its factory default settings, or reflash the XO. This procedure is called a "clean-install" and is described in more detail at http://wiki.laptop.org/go/Clean-install_procedure. Clean-installing works by completely reformatting your XO with a software image stored on a USB storage device. This will erase all of your data!

What you will need

  • An empty USB storage device that is at least 1GB in size.
  • A computer with fast Internet access.

How long it will take

This depends on how fast your internet connection is. You will be downloading two special files that are about 300-400MB in size. On a fast internet connection, this should take less than an hour.

Preparing your USB Storage Device

  1. Download the following files (do not open them--on a non-XO computer). You will usually want to right-click (Ctrl-click for Mac) on each of the above two URLs in the browser and choose "Save Target As" ("Save Link As" for Firefox):
    1. http://download.laptop.org/xo-1/custom/g1g1/releases/8.2-latest/os-image.html
    2. http://download.laptop.org/xo-1/custom/g1g1/releases/8.2-latest/fs-zip.html
  2. You now have two files: gg-767-4.img and fs.zip. Copy these files onto your USB storage device. Make sure they are the only files there.
  3. Eject the USB storage device and disconnect it from your computer when it is safe to do so.

Reflashing your XO

  1. Turn off your XO.
  2. Connect your USB storage device to your XO.
  3. Hold down all four gamepad keys (on the right side of the screen, above the power button). While still holding the four gamepad keys, push the power button to turn the XO on. Do not release the gamepad keys yet.
  4. When the message "Release the game key to continue" appears, release the gamepad keys.
  5. If you see a grid of colored boxes on your screen, congratulations! Your XO is reflashing.

Finishing up

That's it! The reflashing process will run automatically. The XO will color in the grid of boxes, and the words will appear "Rebooting in 10 seconds..." shortly before the XO reboots itself. You can safely remove the USB storage device after the XO reboots itself.

Your XO now has a clean image of release 8.2.0 along with the Activities that came with it. You can now choose a name and colors for your XO and then start playing with the Activities. Congratulations!

If something goes wrong

If the message "Bad hash at eblock #0" appears while reflashing your XO, it means there was a mistake copying the files to your USB storage device. You should try repeating these instructions again, but with a different USB storage device.

Keep my work, but give me the new software

What you will need

You will need your XO and a fast connection to the Internet.

How long it will take

This depends on how fast your internet connection is. On a fast internet connection, it should take less than an hour.

Preparing your XO

Make sure your XO is plugged in, turned on, and connected to the Internet (you should be able to load http://laptop.org in the Browse Activity).

Upgrading your XO

  1. Open the Terminal Activity.
  2. In the Terminal Activity, type su - (lowercase letter 's', lowercase letter 'u', a space, and a hyphen). Press Enter.
  3. Now type /usr/sbin/olpc-update 8.2.0. (a forward slash, 'usr', a forward slash, 'sbin', a forward slash, 'olpc-update,' a space, and '8.2.0'). Press Enter.
  4. You should see text that looks something like this.
 Downloading contents of build ''{{:Friends in testing/current image}}''
 Updating to version hash ''xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx''
 Making clean /versions/updates/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
 Trying irsync_pristine update from rsync://updates.laptop.org/''build-{{:Friends in testing/current image}}''
 - Cleaning tree.
 - Fetching contents.
 - Performing incremental rsync.
 Verifying update.
 Installing update in /versions/{pristine,run}/''xxxx''
  1. At the end of the upgrade, you will see the words "Update Successful!" appear on the screen.
  2. Reboot your XO by entering 'reboot' and press Enter.
Congratulations, you've upgraded!