Clean-install procedure for 8.2: Difference between revisions
mNo edit summary |
No edit summary |
||
(54 intermediate revisions by 22 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]]. |
|||
See [[olpc-update]] for an update that keeps some changes. |
|||
⚫ | |||
⚫ | |||
== What version is available? == |
|||
<!-- 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. |
|||
* This page describes how to update to the 8.2 release from 2009. |
|||
* 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. |
|||
⚫ | |||
{{users}} |
{{users}} |
||
[[Image:YamaDone.JPG|thumb|''for new users'' [[USB_update|<br>'''illustrated guide to updating using a USB stick<br>''']]]] |
|||
<!-- The USB flash drive requirements are in common with other pages --> |
|||
⚫ | |||
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 |
|||
# Attach the USB storage device to your local (NOT the XO!) computer. |
|||
⚫ | |||
# Perform a clean (Full, not Quick!) format of the USB storage device. |
|||
#* Official OS images can be downloaded from http://download.laptop.org/xo-1/os/official/ (older, well-tested images), http://download.laptop.org/xo-1/os/candidate/ (newer, candidate images). |
|||
⚫ | # 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 — in your browser click the right mouse button over the link and choose "Save Link/Target As...". |
||
#** ''We really need to create a better landing point on download.laptop.org for G1G1 folks. The official/candidate/... distinction and the distinction between raw images and derivative images is harmful for this audience.'' --[[User:Mstone|Michael Stone]] 01:13, 4 September 2008 (UTC) |
|||
#* 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 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/ |
|||
⚫ | |||
# 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. |
||
# [[Shutdown]] the XO. |
|||
⚫ | |||
⚫ | |||
# Reboot. |
|||
⚫ | |||
⚫ | |||
# [[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. |
|||
⚫ | |||
#* 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 may then need to [[Activity installation|install activities]]. |
|||
== Development |
== 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. |
|||
⚫ | |||
* 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 these links just by clicking on them. |
|||
# 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, os708.img and os708.crc. |
|||
**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..."). |
|||
# Release the 'x' key when it asks you to. You should be at the [[Firmware|OpenFirmware]] "ok" prompt. |
|||
* Prepare a clean (Full (not Quick!) formatted) USB flash drive. |
|||
# Assuming that your disk image is named _____.img, type |
|||
* 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. |
|||
⚫ | |||
* Copy the OS image files onto the USB flash drive, |
|||
: (e.g. os708.img, os2230.img, en708-1.img, ...) |
|||
**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, <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). |
|||
⚫ | |||
* [[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 |
|||
⚫ | |||
where os''NNN''.img is the file you downloaded (e.g. os2230.img, or en708-1.img). |
|||
⚫ | |||
⚫ | |||
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. |
|||
⚫ | |||
[[Category:Procedures]] |
|||
[[Category:Update paths]] |
[[Category:Update paths]] |
Latest revision as of 01:52, 8 December 2011
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
Development builds For Developers
probe-usb copy-nand disk:\osNNN.img where osNNN.img is the file you downloaded (e.g. os2230.img, or en708-1.img).
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. |