Clean-install procedure for 8.2: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
(→‎Development Builds: "USB stick" is the WRONG term!, better formatting)
Line 24: Line 24:
{{developers}}
{{developers}}


# Get a [[Developer key#Getting a Developer Key for your Running XO Laptop|developer key]] for your XO laptop '''and save it in <tt>security/develop.sig</tt> on a USB stick'''.
# Get a [[Developer key#Getting a Developer Key for your Running XO Laptop|developer key]] for your XO laptop '''and save it in <tt>/security/develop.sig</tt> on a USB flash drive'''.
# Download the OS image (e.g. {{{{:Friends in testing/current image stream}}-img-link}}) and its CRC file (e.g. {{{{:Friends in testing/current image stream}}-crc-link}}) to your local computer. DO NOT open them. Important: If your computer runs on MS Windows, point your cursor on the link, click the right mouse button 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..." and choose the USB memory stick as the target.
# Download the OS image (e.g. {{{{:Friends in testing/current image stream}}-img-link}}) and its CRC file (e.g. {{{{:Friends in testing/current image stream}}-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...". Choose the USB flash drive as the target.
#* ''Other development images can be found at places like the [http://xs-dev.laptop.org/~cscott/xo-1/streams/joyride/ joyride build stream] (e.g. [http://xs-dev.laptop.org/~cscott/xo-1/streams/joyride/build2230/devel_jffs2/ joyride-2230]) and from many other sources.''
#* ''Other [[OS images]] can be found at places like the [http://xs-dev.laptop.org/~cscott/xo-1/streams/joyride/ joyride build stream] (e.g. [http://xs-dev.laptop.org/~cscott/xo-1/streams/joyride/build2230/devel_jffs2/ joyride-2230]) and from many other sources.''
# Copy these files onto of a clean (Full (not Quick!) formatted) USB memory stick. Your USB memory stick should now contain two files named: for example, os{{:Friends in testing/current image number}}.img and os{{:Friends in testing/current image number}}.crc.
# 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, <tt>os''{{:Friends in testing/current image number}}''.img</tt> and <tt>os''{{:Friends in testing/current image number}}''.crc</tt> (and possibly the <tt>/security</tt> directory).
# Unmount the USB memory stick and disconnect it from your computer when it is safe to do so.
# Unmount the USB flash drive and disconnect it from your computer when it is safe to do so.
# Shut down your XO laptop. Insert the USB stick into the XO Laptop and power up while holding the escape key (the circled "x" in the upper left corner of the keyboard).
# 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).
# Release the 'x' key when it asks you to. You should be at the [[Firmware|OpenFirmware]] "ok" prompt.
# Release the 'x' key when it asks you to. You should be at the [[Open Firmware]] "ok" prompt.
# Type
# Assuming that your disk image is named _____.img, type
probe-usb copy-nand disk:\____.img
probe-usb copy-nand disk:\osNNN.img
: (e.g. os708.img, os2230.img, en708-1.img, ...)
: where osNNN.img is the file you downloaded (e.g. os708.img, os2230.img, or en708-1.img).
:8. Press Enter, then wait while your machine reflashes.
:8. Press Enter, then wait while your machine reflashes.


Revision as of 02:28, 4 October 2008

Updating

Basic Updating
Auto-updater
USB key update
Command line update

Advanced Updating
Unsigned update
Developer keys
For : testers
For : developers


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 and Candidate Builds

  For the general public
Power & Game buttons for B2 and older XOs. B3 and newer have "O" at the top and "✓" (check) at the right.
  1. Download the OS image and its signatures file to your local computer. 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...".
  2. Copy these files onto a clean (Full, not Quick!, formatted) USB storage device that has at least 500 MB of space. Your USB storage device should now contain two files named something like: en708-1.img and fs.zip.
  3. Unmount the USB storage device and disconnect it from your computer when it is safe to do so.
  4. 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!)
  5. Release the game keys when the XO asks you to. The XO will take a few minutes to rewrite its memory.
  6. Reboot.
  7. Check that you have the correct build:
  8. You will then need to install the G1G1 Activity pack link here.

Development Builds

  For Developers
  1. Get a developer key for your XO laptop and save it in /security/develop.sig on a USB flash drive.
  2. 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...". Choose the USB flash drive as the target.
  3. 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).
  4. Unmount the USB flash drive and disconnect it from your computer when it is safe to do so.
  5. 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).
  6. Release the 'x' key when it asks you to. You should be at the Open Firmware "ok" prompt.
  7. 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).
8. Press Enter, then wait while your machine reflashes.
9. When the "ok" prompt returns, reboot the machine by typing reboot.
Retrieved from "http://wiki.laptop.org/mediawiki/index.php?title=Clean-install_procedure_for_8.2&oldid=170990"