Stable Upgrade: Difference between revisions

From OLPC
Jump to navigation Jump to search
(G1G1 don't need devkeys; category)
(use Template:obsolete, remove categories, remove some obsolete info and links)
 
(28 intermediate revisions by 16 users not shown)
Line 1: Line 1:
{{obsolete|link=[[olpc-update]] or [[clean-install procedure]]}}
'''Network upgrade (only works well from 643 or later)'''


This page is about updating the system software on your XO laptop to a "stable" release. It arrived running a stable release, and perhaps other stable releases have been made. A stable release is distinguished from other software "builds" by being signed with a crypto key that ony OLPC has, marking it as a suitable software release for ordinary people using the laptop. (As opposed to more adventurous people, who might want to run builds in development, or even improved software not written by OLPC. Anyone is free to do so; this capability is required by the [http://www.gnu.org/licenses/gpl.html GNU General Public License] that governs much of the software. And by [[OLPC on free/open source software]], the company policy on freedom for the users of its software. See [[#Advanced upgrades]] below.)
# Go into the virtual terminal: Hold down Alt, Ctrl, and [[Image:Mesh_key_f1_small.png]] (the 'Mesh' key - third key from the left along the top row).
# Login in as 'root'
# Type: olpc-update <version>
#* The stable version released on December 1 is '649'.
# When the download and upgrade are complete and verified; type 'reboot' to start the laptop up in the new version.
# After booting into sugar, check the code version as described below.


The latest stable build is:
: {{Latest_Releases/stable}}.
(the [[Releases]] page lists other releases that have been made and are planned.)


To see what version of the system software your laptop is running, follow [[How to check the OS and firmware versions]].
If you have an earlier build, you can upgrade to this build using the [[olpc-update]] command if you have Internet access. ''Read the release notes for the build first.''


'''To Upgrade from a USB stick''' (<font color=red>will overwrite all saved data</font>) Copy any files you would like to keep onto another data storage device (usb key, another laptop, etc...)


This page also describes another approach using a USB flash drive.
First you need to create a USB stick with the latest stable build:



# Make sure that your USB stick is FAT formatted, not FAT 32, and only contains 1 partition.
== To upgrade using a USB flash drive(<font color=red>will overwrite all saved data</font>) ==

Copy any files you would like to keep onto another data storage device (USB flash drive, another laptop, etc...)

First you need to create a USB flash drive with the latest stable build:

# Make sure that your USB flash drive is formatted as FAT or FAT32, and only contains 1 partition. Most ordinary USB flash drives are set up this way, except "U3" flash drives which won't work. U3 can be removed with this software: http://www.u3.com/uninstall
# Go to the jffs2 download page for stable build, http://download.laptop.org/xo-1/os/official/
# Go to the jffs2 download page for stable build, http://download.laptop.org/xo-1/os/official/
# Download two files to your local computer: fs.zip (about 200k), and osXXX.img (about 300M); where XXX is the build number.
# Download two files to your local computer: fs.zip (about 200k), and osXXX.img (about 300M); where XXX is the build number.
#* These files will be found in /build_number/jffs2
#* These files will be found in '''/build_number/jffs2'''
# Put these two files on the USB stick at the root directory. Remove any other files on the USB stick.
# Put these two files on the USB flash drive at the root directory. Remove any other files on the USB flash drive.




Next, upgrade your laptop:
Next, upgrade your laptop:


# Ensure you have both a power adapter and a battery plugged into the laptop.
# Ensure you have both a power adapter and a battery plugged into the laptop (verify that the power adaptor is plugged into the wall outlet ;-) .
# Insert the USB stick into the laptop while it is powered off.
# Insert the USB flash drive into the laptop while it is powered off.
# Hold down all four gamekeys on the right then push the power button.
# Hold down all four gamekeys on the right then push the power button.
# Release the gamekeys when directed.
# Release the gamekeys when directed.


A map of blocks of the internal NAND Flash memory will be displayed. First the memory blocks of the internal
'''Check the version of code your laptop is running:'''
memory will be erased (your USB flash drive might indicate activity, but don't worry) and then will be overwritten

with the content of the USB flash drive. This process takes a few minutes. Finally a message appears stating that
# Boot the laptop; and wait until you get the sugar home screen.
the latop will reboot in 10 seconds. It does so. The first boot takes a bit longer than subsequent ones.
# Hold down Alt, Ctrl, and 'mesh' (the third key from the left along the top row).
# Check the version by reading the label just above the login: OLPC Build 649 (match that against expected build number). You may have to hit enter once.
# Hold down Alt, Ctrl, and 'home' (the 5th key from the left on the top row) to get back to Sugar UI.


'''Advanced Upgrades'''


== Advanced upgrades ==
To upgrade to a non-stable release, you must have a developer's key (or a machine that was never locked down, such as a G1G1 MP machine). Consult [[Activation and Developer Keys]] and [[Autoreinstallation]] for more details.


To upgrade to a non-stable release, you must have a developer key.
[[Category:Documentation]] [[Category:Developers]] [[Category:OS]]

Latest revision as of 22:22, 4 October 2008

542-stopicon.png This page has a more up-to-date location: olpc-update or clean-install procedure


This page is about updating the system software on your XO laptop to a "stable" release. It arrived running a stable release, and perhaps other stable releases have been made. A stable release is distinguished from other software "builds" by being signed with a crypto key that ony OLPC has, marking it as a suitable software release for ordinary people using the laptop. (As opposed to more adventurous people, who might want to run builds in development, or even improved software not written by OLPC. Anyone is free to do so; this capability is required by the GNU General Public License that governs much of the software. And by OLPC on free/open source software, the company policy on freedom for the users of its software. See #Advanced upgrades below.)

The latest stable build is:

13.2.11 || 2020-01-29.

(the Releases page lists other releases that have been made and are planned.)

To see what version of the system software your laptop is running, follow How to check the OS and firmware versions. If you have an earlier build, you can upgrade to this build using the olpc-update command if you have Internet access. Read the release notes for the build first.


This page also describes another approach using a USB flash drive.


To upgrade using a USB flash drive(will overwrite all saved data)

Copy any files you would like to keep onto another data storage device (USB flash drive, another laptop, etc...)

First you need to create a USB flash drive with the latest stable build:

  1. Make sure that your USB flash drive is formatted as FAT or FAT32, and only contains 1 partition. Most ordinary USB flash drives are set up this way, except "U3" flash drives which won't work. U3 can be removed with this software: http://www.u3.com/uninstall
  2. Go to the jffs2 download page for stable build, http://download.laptop.org/xo-1/os/official/
  3. Download two files to your local computer: fs.zip (about 200k), and osXXX.img (about 300M); where XXX is the build number.
    • These files will be found in /build_number/jffs2
  4. Put these two files on the USB flash drive at the root directory. Remove any other files on the USB flash drive.


Next, upgrade your laptop:

  1. Ensure you have both a power adapter and a battery plugged into the laptop (verify that the power adaptor is plugged into the wall outlet ;-) .
  2. Insert the USB flash drive into the laptop while it is powered off.
  3. Hold down all four gamekeys on the right then push the power button.
  4. Release the gamekeys when directed.

A map of blocks of the internal NAND Flash memory will be displayed. First the memory blocks of the internal memory will be erased (your USB flash drive might indicate activity, but don't worry) and then will be overwritten with the content of the USB flash drive. This process takes a few minutes. Finally a message appears stating that the latop will reboot in 10 seconds. It does so. The first boot takes a bit longer than subsequent ones.

Advanced upgrades

To upgrade to a non-stable release, you must have a developer key.