Release Notes/8.2.0-detailed-version

NOTE: The contents of this page are not set in stone, and are subject to change! This page is a draft in active flux ... Please leave suggestions on the talk page.

  This page is monitored by the OLPC team.

  For the general public

Upgrading from previous releases

Be sure to read and carefully follow these instructions before you begin the upgrade process, and allocate enough time to do the full process before you begin.

During pre-release development, you will need a developer key in order to install an 8.2 OS image. This key should be copied in the /security directory BEFORE the upgrading process.

Important Note: Please check with your deployment technical contacts before upgrading. Countries using the XO may have custom configurations which may require special actions to be taken before new releases can be installed.

The process described below is to upgrade the XO while it is connected to Internet, for other ways to upgrade, see the Upgrading the XO.

Here are the steps to upgrade:

1. Determine which version your XO is running.
2. Plug the XO into AC Power
3. Connect XO to the internet
4. Launch the update command
5. Update activities

Step 1: Determine which version your XO is running

Follow these instructions to open a console window which shows you the current build (AKA release) which is running on your XO.

1. Press ctrl+alt+F2 (the F2 key is the same as the Group key . The Ctrl key has a solid diamond on it (♦); the Alt key has an open diamond on it (♢). See Keyboard Shortcuts for more details.)
2. Read the build number from the first line of text that appears in the console window

Sample transcript:

OLPC build 656 (stream ship.2: variant devel_jffs2)
kernel 2.6.22-20070919.2.olpc.0987654321abcdefabcedf on an i586
xo-05-29-BB login:

The OS build number in the above example is 656.

To return to the Sugar graphical display press ctrl+alt+F3 . (The F3 key is the same as the Home key ().)

Step 2: Plug the XO into AC Power

Upgrading could be a long process. For this reason, ensure first that your XO is connected to reliable AC Power. Be sure to have enough time to do the full process (about 1 hour).

Step 3: Connect XO to the internet

During the upgrade process, your XO will download the new release. So you should ensure that the XO is connected to the internet before launching the upgrade. See Connecting Guide or Wifi Connectivity for instructions. Use Browse activity to test your connection.

Step 4: Launch the update command

Open the Terminal Activity or a console and type the following (press the Enter key after each line):

If your XO is on build 650, 653, or 656:

su - 
olpc-update official-os860

If your XO is on build 703 or later:

sudo olpc-update official-os860 

If the update program successfully connects to the update server, some messages should display similar to this:

Downloading contents of build official-os860
Updating to version hash xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Making clean /versions/updates/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Trying irsync_pristine update from rsync://updates.laptop.org/build-official-os860
- Cleaning tree.
- Fetching contents.
- Performing incremental rsync.
Verifying update.
Installing update in /versions/{pristine,run}/xxxx

This process may take more than thirty minutes. When the process is complete, you need to reboot.

Important Note: On the first reboot after upgrading, the XO will run slowly for about 1 minute. After that it will run normally.

Step 5: Update activities

On rebooting the first time after updating to release 8.2, the XO will notify you that your activities should be updated.

G1G1 Activity install

Activities update proposal

If you are connected to the Internet, click "OK" to update your activities. If it is not connected to the Internet, click "Cancel". Connect to the Internet and then open the Software Updater from the Control Panel.

When the Software Update starts you will see a progress bar as your XO looks for updated versions of the activities you have installed. When it is done, choose the activities you want update and click "Install selected". You will see another progress bar, as the activities are updated.

Some activities may not successfully update, due to errors in the activity files or due to transient network errors. In this case, some activities will remain in the "available updates" list after the installation process has completed. If a network error was the cause, you may wish to immediately retry the installation; otherwise, you probably need to wait until the activity author uploads a corrected version of their bundle.