Clean-install procedure for 8.2: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
 
(12 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Deprecated|<center>Release 8.2 is obsolete, please see the installation section of the release notes in the [[release|latest stable release]].</center>}}
This page provides parallel instructions for installing both signed builds (official or candidate releases) and unsigned development builds for [[Friends in Testing]].
This page provides parallel instructions for installing both signed builds (official or candidate releases) and unsigned development builds for [[Friends in Testing]].


Line 6: Line 7:
<!-- Section copied from [[olpc-update]], keep the two pages in sync -->
<!-- Section copied from [[olpc-update]], keep the two pages in sync -->
You need to identify the "build" to which you want to update your system.
You need to identify the "build" to which you want to update your system.
The latest stable system software release is
: {{Latest_Releases/stable}}
Most users should update to that build.


* This page describes how to update to the 8.2 release from 2009.
'''For 2008 G1G1 users, [[Release_Notes/8.2.0#If_your_XO_is_not_connected_to_the_internet|the 8.2.0 release notes]] offer the most concise instructions for restoring the factory configuration.'''
* To install the latest release, see [[Release notes|the latest release notes]]. You may need to first [[Upgrading_firmware|upgrade your firmware]].


For G1G1 users, [[Release_Notes/8.2.0#If_your_XO_is_not_connected_to_the_internet|the 8.2.0 release notes]] offer the most concise instructions for restoring the factory configuration.
All releases currently available are listed on the [[Release notes]] page.
Before upgrading to any release, read its [[release notes]] carefully.


===Other builds===
There are later builds in various stages of development, see [[OS images]] for more background.
These are likely to be unstable and you will probably need to request a [[developer key]] to install them.


== Official releases and candidate builds ==
== Official releases and candidate builds ==
Line 28: Line 23:
# Attach the USB storage device to your local (NOT the XO!) computer.
# Attach the USB storage device to your local (NOT the XO!) computer.
# Perform a clean (Full, not Quick!) format of the USB storage device.
# Perform a clean (Full, not Quick!) format of the USB storage device.
# Download the OS image named <tt>''someversion''.img</tt> (e.g. <tt>os''767''.img</tt>) and its signatures file named <tt>fs.zip</tt> to the USB storage device. These are compressed files, but DO NOT open them &mdash; in your browser click the right mouse button over the link and choose "Save Link/Target As...".
# Download the OS image named <tt>''someversion''.img</tt> (e.g. <tt>gg-802-1.img</tt>) and the signature file <tt>fs.zip</tt> to the USB storage device. These are compressed files, but DO NOT open them &mdash; in your browser click the right mouse button over the link and choose "Save Link/Target As...".
#* You can download official OS images from subdirectories of http://download.laptop.org/xo-1/os/official/
#* For release 8.2.1 with activities included, use gg-802-1.img and fs.zip from<br>http://download.laptop.org/xo-1/custom/g1g1/gg-802-1/
#* For release 8.2.0 only, you can download a special OS image that also contains a set of activities from http://download.laptop.org/xo-1/custom/g1g1/gg-767-4/
#* For release 8.2.0 with activities included, use gg-767-4.img and fs.zip from<br>http://download.laptop.org/xo-1/custom/g1g1/gg-767-4/
#* For other releases without activities included, see subdirectories of<br>http://download.laptop.org/xo-1/os/official/
# Your USB storage device should now contain two files (in the root) named something like: <tt>os767.img</tt> and <tt>fs.zip</tt>.
# Your USB storage device should now contain two files (in the root) named something like: <tt>gg-802-1.img</tt> and <tt>fs.zip</tt>.
# Unmount the USB storage device and disconnect it from your computer when it is safe to do so.
# Unmount the USB storage device and disconnect it from your computer when it is safe to do so.
# Plug your XO laptop into an electrical outlet and make sure the battery is locked in place.
# Plug your XO laptop into an electrical outlet and make sure the battery is locked in place.
Line 38: Line 34:
# 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.
# 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.
# [[Reboot]] the XO. If the new build includes newer [[firmware]], then your XO will reboot twice. When the XO restarts the update will be complete.
# [[Reboot]] the XO. If the new build includes newer [[firmware]], then your XO will reboot twice. When the XO restarts the update will be complete.
# Check that you have the correct build:
# Check that the XO has the correct build loaded:
#* Follow [[How to check the OS and firmware versions]].
#* Follow [[How to check the OS and firmware versions]].
#* Verify that the build number matches build number of the image file you downloaded, e.g. "Update.1 708, firmware Q2D16" for en708-1.
#* Verify that the build number matches build number of the image file you downloaded, e.g. "Update.1 708, firmware Q2D16" for en708-1.
# You will then need to [[Activity installation|install activities]].
# You may then need to [[Activity installation|install activities]].


== Development builds ==
== Development builds ==
{{developers}}
{{developers}}


* Read [[OS images]] and its table of releases to choose an appropriate build.
# 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'''.
** ''Other OS images can be found at [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.''
# Read [[OS images]] and its table of releases to choose an appropriate build.
* 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.
#* ''Other OS images can be found at [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.''
**Important: DO NOT open these links just by clicking on them.
# 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..." (Firefox will work. Use "Save Link As...").
**If your computer runs MS Windows, click your right mouse button on the link and choose "Save Link Target As".
# 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).
**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..."
# Unmount the USB flash drive and disconnect it from your computer when it is safe to do so.
**Firefox will also work, use "Save Link As...").
# 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).
* Prepare a clean (Full (not Quick!) formatted) USB flash drive.
# You should be at the [[Open Firmware]] "ok" prompt. If it shuts down without asking you to release the 'x' key, try again and release it after the display finishes loading to the point where it shut off. The "ok" prompt will appear and you can proceed from there as shown below.
* Get a [[Developer_key#Getting_a_developer_key_for_your_running_XO_laptop|developer key]] for your XO laptop and save it as <tt>develop.sig</tt> in a folder <tt>security</tt> on the USB flash drive.
# Type
* Copy the OS image files onto the USB flash drive,
probe-usb copy-nand disk:\os''NNN''.img
**the files should be next to the security folder and not in it.
: where os''NNN''.img is the file you downloaded (e.g. os2230.img, or en708-1.img).
**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).
:9. Press Enter, then wait while your machine reflashes.
* Unmount the USB flash drive and disconnect it from your computer when it is safe to do so.

* [[Shutdown]] the XO laptop.
:10. When the "ok" prompt returns, reboot the machine by typing reboot.
* Insert the USB flash drive into the XO laptop and power up to the "ok" prompt, (see [[Ok]] for how),
* Install the image by typing
probe-usb copy-nand disk:\os''NNN''.img
where os''NNN''.img is the file you downloaded (e.g. os2230.img, or en708-1.img).
* Press Enter, then wait while your machine reflashes.
* When the "ok" prompt returns, reboot the machine by typing:
bye


Note: This procedure can be used for builds signed with the OLPC key. If it is used for builds signed with other keys, it is necessary to [[Developer_key#Disable_the_security_system|disable security ]] otherwise the developer key will need to be in the USB for every boot.
Note: This procedure can be used for builds signed with the OLPC key. If it is used for builds signed with other keys, it is necessary to [[Developer_key#Disable_the_security_system|disable security ]] otherwise the developer key will need to be in the USB for every boot.

Latest revision as of 01:52, 8 December 2011

Stop hand.png WARNING:
The content of this section is considered
DEPRECATED and OBSOLETE
It is preserved for historical or documenting reasons.
Release 8.2 is obsolete, please see the installation section of the release notes in the latest stable release.

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.

What version is available?

You need to identify the "build" to which you want to update your system.

For G1G1 users, the 8.2.0 release notes offer the most concise instructions for restoring the factory configuration.


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 higher. It should be formatted as FAT or FAT32, and only contain 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 or http://u3uninstall.s3.amazonaws.com/U3Uninstall.exe

  1. Attach the USB storage device to your local (NOT the XO!) computer.
  2. Perform a clean (Full, not Quick!) format of the USB storage device.
  3. Download the OS image named someversion.img (e.g. gg-802-1.img) and the signature file 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 (in the root) named something like: gg-802-1.img and fs.zip.
  5. Unmount the USB storage device and disconnect it from your computer when it is safe to do so.
  6. Plug your XO laptop into an electrical outlet and make sure the battery is locked in place.
  7. Shutdown the XO.
  8. Power & Game buttons for B2 and older XOs. B3 and newer have "O" at the top and "✓" (check) at the right.
    Connect the USB storage device to the XO Laptop and power up while holding all the four game keys. (this is VERY important!)
  9. 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.
  10. Reboot the XO. If the new build includes newer firmware, then your XO will reboot twice. When the XO restarts the update will be complete.
  11. Check that the XO has the correct build loaded:
  12. You may then need to install activities.

Development builds

  • Read OS images and its table of releases to choose an appropriate build.
  • 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 these links just by clicking on 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..."
    • Firefox will also work, use "Save Link As...").
  • Prepare a clean (Full (not Quick!) formatted) USB flash drive.
  • Get a developer key for your XO laptop and save it as develop.sig in a folder security on the USB flash drive.
  • Copy the OS image files onto the USB flash drive,
    • the files should be next to the security folder and not in it.
    • your USB flash drive should now contain two files named, for example, osos860.img and osos860.crc (and possibly the /security directory).
  • Unmount the USB flash drive and disconnect it from your computer when it is safe to do so.
  • Shutdown the XO laptop.
  • Insert the USB flash drive into the XO laptop and power up to the "ok" prompt, (see Ok for how),
  • Install the image by typing
 probe-usb copy-nand disk:\osNNN.img

where osNNN.img is the file you downloaded (e.g. os2230.img, or en708-1.img).

  • Press Enter, then wait while your machine reflashes.
  • When the "ok" prompt returns, reboot the machine by typing:
 bye

Note: This procedure can be used for builds signed with the OLPC key. If it is used for builds signed with other keys, it is necessary to disable security otherwise the developer key will need to be in the USB for every boot.