Clean-install procedure for 8.2

From OLPC
Revision as of 10:04, 6 October 2008 by Skierpage (talk | contribs) (→‎Official releases and candidate builds: mention USB flash drive requirement, and formatting step)
Jump to navigation Jump to search

This page provides parallel instructions for installing both signed builds (official or candidate releases) and unsigned development builds for Friends in Testing.

Note that a clean install will reflash your XO; everything you created will be deleted. See olpc-update for an update mechanism that preserves some data.

Official releases and candidate builds

  For the general public

You'll need a USB storage device such as a flash drive, with a capacity of 500 MB or highers. It should be formatted as FAT or FAT32, and only contains one partition. Most ordinary USB flash drives are set up this way, except "U3" flash drives which may not work. Remove U3 with uninstall software from http://www.u3.com/uninstall

  1. Attach the USB storage device to your local computer.
  2. Perform a clean (Full, not Quick!) format of the USB storage device.
  3. Download the OS image (e.g. os767.img) and its signatures file named fs.zip to the USB storage device. These are compressed files, but DO NOT open them — in your browser click the right mouse button over the link and choose "Save Link/Target As...".
  4. Your USB storage device should now contain two files named something like: os767.img and fs.zip.
  5. Unmount the USB storage device and disconnect it from your computer when it is safe to do so.
Power & Game buttons for B2 and older XOs. B3 and newer have "O" at the top and "✓" (check) at the right.
  1. Shut down your XO laptop. Connect the USB storage device to the XO Laptop and power up while holding all the four game keys. (this is VERY important!)
  2. Release the game keys when the XO asks you to. The XO will take a few minutes to rewrite its memory with the new OS image.
  3. Reboot.
    • If the new build includes newer firmware, then your XO will reboot twice. When the XO restarts the update will be complete.
  4. Check that you have the correct build:
  5. You will then need to install activities.

Development builds

  1. Get a developer key for your XO laptop and save it in /security/develop.sig on a USB flash drive.
  2. Read OS images and its table of releases to choose an appropriate build.
  3. Download the OS image (e.g. Template:Official-img-link) and its CRC file (e.g. Template:Official-crc-link) to your local computer. Important: DO NOT open them. If your computer runs MS Windows, click your right mouse button on the link and choose "Save Link Target As". If you are using a Mac, use Safari for the downloads and hold down the control key when you click on the link and choose "Download linked file as...".
  4. Copy these files onto of a clean (Full (not Quick!) formatted) USB flash drive. Your USB flash drive should now contain two files named, for example, osos860.img and osos860.crc (and possibly the /security directory).
  5. Unmount the USB flash drive and disconnect it from your computer when it is safe to do so.
  6. Shut down your XO laptop. Insert the USB flash drive into the XO Laptop and power up while holding the escape key (the circled 'x' in the upper-left corner of the keyboard).
  7. Release the 'x' key when it asks you to. You should be at the Open Firmware "ok" prompt.
  8. Type
 probe-usb copy-nand disk:\osNNN.img 
where osNNN.img is the file you downloaded (e.g. os708.img, os2230.img, or en708-1.img).
9. Press Enter, then wait while your machine reflashes.
10. When the "ok" prompt returns, reboot the machine by typing reboot.