Upgrading to 8.2: Difference between revisions

From OLPC
Jump to navigation Jump to search
(New page: If you have a machine running 8.1 (builds 700-715), here is how to upgrade your system to 8.2. == Background == For background information and other options see [[Clean-install procedure...)
 
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
If you have a machine running 8.1 (builds 700-715), here is how to upgrade your system to 8.2.
If you have a machine running update.1 (builds 650-656) or 8.1 (builds 700-715), here is how to upgrade your system to '''8.2'''. As of November, 2008 this is the latest stable release.


<div style="float:right">
== Background ==
__TOC__
</div>

== Background on upgrading ==
For background information and other options see [[Clean-install procedure]] and [[olpc-update]].
For background information and other options see [[Clean-install procedure]] and [[olpc-update]].


If you run into [[upgrade troubleshooting|trouble]], the [[Support FAQ]] and [[Support]] team can provide live help.
If you run into [[upgrade troubleshooting|trouble]], the [[Support FAQ]] and [[Support]] team can provide live help.


Build 767 is the last stable build for version 8.2.
== 8.2 ==
The MD5 checksum for this image is 64c599eea92e29abb1b6ed72e7541734 .
As of November 2008, this is the latest stable OLPC build. You can install this build onto secure machines.


== Upgrading over the Internet ==
== Upgrading over the Internet ==
This process can take more than 30 minutes so be sure to reserve enough time.
Reserve enough time for this : the process can take more than 30 minutes. If you are interrupted in the middle of an update, you can continue where you left off.


0. '''Turn on''' your XO.
1. '''Backup''' any files you want to save. Upgrading may make some activities work differently, and may make Journal items that depend on them stop working.


1. '''Backup''' any files you want to save.
2. Make sure your XO is plugged in, turned on, and [http://laptop.org/manual/XO_GiveMeTheInternet.html connected to the Internet].
: Upgrading may make some activities work differently, and may make Journal items that depend on old activities stop working.


2. [http://laptop.org/manual/XO_GiveMeTheInternet.html '''Connect''' to the Internet].
3. From the Terminal [[Image:Activity-terminal.svg]], type:

3. Launch the '''[[Terminal]]''' activity [[Image:Activity-terminal.svg]] and type:
su -
su -
olpc-update 767
olpc-update 767


This will take 5-30 minutes depending on your connection speed. You should see text that looks like this:
This updates your system to Build 767 and takes 5-30 minutes depending on your connection speed. You should see text like this:
Downloading contents of build ''{{:Friends in testing/current image}}''
Downloading contents of build ''{{:Friends in testing/current image}}''
Updating to version hash ''xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx''
Updating to version hash ''xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx''
Line 32: Line 37:
Installing update in /versions/{pristine,run}/''xxxx''
Installing update in /versions/{pristine,run}/''xxxx''


Sometimes you will also get a message about irsync_pristine failing, and that "irsync_dirty" is being tried; this is normal.
Sometimes you will get a message about irsync_pristine failing, or that "irsync_dirty" is being tried; this is normal.


'''If the update halts''' (for instance, if you lose your network connection in the middle) you will be returned to the [[Terminal]] prompt. You can repeat the command to resume the update where it stopped:
4. At the end of the upgrade, you will see "Installing update in...." or "Update Succeeded!"
olpc-update 767
At this point, you can '''reboot''' (for instance, type <code>reboot</code> from the terminal).


5. Download new versions of your existing Activities.
: When the XO boots you will see a bar at the top of the screen that says "Software Update" and the options being "Cancel" / "Later" / "Check now". Before you choose "Check now", make sure that your XO is once more connected to the Internet. (You can leave the home view to set up your network connection; when you return to your home view the options should still be there).
: First the XO will check online for any updates, then it will ask if you want to install them. Click "Install selected" to update all to the newest versions. <br>


4. '''Reboot''' after you see the "Update Succeeded!" message.
6. Reinstall your [[Collections|Library]] (which shows up in the Browse homepage), and add new [[Activities]].
: At the end of the upgrade, you will see "Installing update in...." and "Update Succeeded!"; you are halfway done. Type <code>reboot</code> from the terminal.

5. '''Connect to the Internet''' again.
:As soon as you reboot, you will see a bar at the top of the screen that says "Software Update" with options "Cancel" / "Later" / "Check now"... and you will not have most of your old activities available from your Home view. Get online before choosing ''Check now''.

6. '''Download and update activities'''.
: Choose ''Check now'' from the options at the top of your Home view. If you don't see these option, you can launch it from the [[Control Panel]]'s Software Update feature. The Control Panel is an option on the hover menu at the center of your Home view.
: Your XO will check online for new activities and updates. Click "Install selected" once it is done to update everything. By default, the activities checked are any already on your machine and those included on [[G1G1 2008]] builds.
<br>

7. '''Add more''' [[Collections]] and [[Activities]].
: After you upgrade your current activities, while still in the Software Update screen:
: After you upgrade your current activities, while still in the Software Update screen:
: a) click on the triangle next to "Modify activity groups" at the bottom of the screen
: a) click on the triangle next to "Modify activity groups" at the bottom of the screen
: b) for the Group URL, enter <code>http://wiki.laptop.org/go/Activities/G1G1 </code> and select the '''Add''' button
: b) for the Group URL, enter <code>http://wiki.laptop.org/go/Activities/All</code> or some other subpage of the Activities page, and choose the '''Add''' button
: c) click on the '''Refresh''' button, and wait for the activity list to refresh, then choose "Install selected" to download them.
: c) choose the '''Refresh''' button, wait for the activity list to refresh, and '''Install selected''' to download them.

: d) once this is done, exit the Software Update screen and '''reboot'''.
These changes should take effect without a reboot.

<big>''Congratulations, you've upgraded!''</big>


''Congratulations, you've upgraded!''


== Upgrading offline ==
''This process takes 10 minutes once you have downloaded the files onto a USB key.''


You can use another computer that is connected to the internet (a desktop at home, a computer lab, etc.) and a USB storage device to upgrade your XO. This process will '''cmopletely erase ALL files''' on your XO.
== If your XO is not online ===
''This process should take 10 minutes once you have downloaded the files onto a USB key.''


# Make sure your XO is '''plugged in''' and has its '''battery in'''.
You can use another computer that is connected to the internet (a desktop at home, a computer lab, etc.) and a USB storage device to upgrade your XO. This process will '''COMPLETELY erase ALL files''' on your XO. Make sure you have backed up any files you want to save.
# '''Back up''' any files or Journal entries on your XO that you want to keep.
#: This helps ensure the process is not interrupted in the middle.
# '''Get an empty USB stick''' with at least 500MB of space.
#: The USB stick does not have to be completely empty. However, avoid using the same USB stick for this and other types of OLPC backups.
# '''Download''' the following files to your stick. Do not open or unzip the files.
#* [http://download.laptop.org/xo-1/custom/g1g1/gg-767-4/gg-767-4.img gg-767-4.img] (450 MB)
#* [http://download.laptop.org/xo-1/custom/g1g1/gg-767-4/fs.zip fs.zip] (297 KB)
# '''Turn off your XO''' and '''connect your USB stick''' to it.
# '''Hold down all four gamepad keys''' (on the right side of the screen, above the power button) and then '''turn on the XO'''. Keep holding the gamepad keys until the message "Release the game key to continue" appears on the screen.
# '''Release the game keys''' and wait for the reflash to complete.
#: You should see a grid of black boxes appear on your screen, and then fill with color. Your XO is now reflashing. It will take 8-10 minutes and your XO should automatically show a 'complete' message and reboot when it is done.
# '''Reboot''' if it didn't happen automatically, and '''wait for the firmware to update'''.
#: This happens the next time you reboot, and should take 1 minute. It will not proceed unless your battery is in and your laptop plugged in. The XO will reboot automatically once more after this.


Your update is done! Explore your new Home view (the available activities are now laid out in a circle around the central XO, and active activities appear in the top of the [[frame]]) and make sure that your favorite activities are installed.
1. Backup any files or journal entries you want to keep.


If you need to install new activities, you can do so via the new [[Control Panel]] (see above).
2. Download the following files to an otherwise empty USB storage device attached to your non-XO computer (do not open the files):
* http://download.laptop.org/xo-1/custom/g1g1/gg-767-4/gg-767-4.img 450 MB
* http://download.laptop.org/xo-1/custom/g1g1/gg-767-4/fs.zip 297 KB


== Checksum and other technical details ==
3. Turn off your XO and connect your USB storage device to it.
The MD5 checksum for this image is 64c599eea92e29abb1b6ed72e7541734 . As of November 2008, this is the latest stable OLPC build. You can install this build onto secure machines.


4. Hold down all four gamepad keys (on the right side of the screen, above the power button). While still holding the four gamepad keys, push the power button to turn the XO on. Keep holding down the four gamepad keys until the message "Release the game key to continue" appears on the screen.


5. Release the gamepad keys. You should soon see a grid of black boxes on your screen, which begin to fill with color. Your XO is now reflashing. It will take about 10 minutes and your XO will automatically reboot when it is done. Once your XO reboots, you should be ready to go.


[[category:upgrades]]
[[category:upgrades]]

Latest revision as of 06:47, 27 December 2008

If you have a machine running update.1 (builds 650-656) or 8.1 (builds 700-715), here is how to upgrade your system to 8.2. As of November, 2008 this is the latest stable release.

Background on upgrading

For background information and other options see Clean-install procedure and olpc-update.

If you run into trouble, the Support FAQ and Support team can provide live help.

Build 767 is the last stable build for version 8.2.

Upgrading over the Internet

Reserve enough time for this : the process can take more than 30 minutes. If you are interrupted in the middle of an update, you can continue where you left off.

0. Turn on your XO.

1. Backup any files you want to save.

Upgrading may make some activities work differently, and may make Journal items that depend on old activities stop working.

2. Connect to the Internet.

3. Launch the Terminal activity Activity-terminal.svg and type:

su - 
olpc-update 767 

This updates your system to Build 767 and takes 5-30 minutes depending on your connection speed. You should see text like 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

Sometimes you will get a message about irsync_pristine failing, or that "irsync_dirty" is being tried; this is normal.

If the update halts (for instance, if you lose your network connection in the middle) you will be returned to the Terminal prompt. You can repeat the command to resume the update where it stopped:

olpc-update 767


4. Reboot after you see the "Update Succeeded!" message.

At the end of the upgrade, you will see "Installing update in...." and "Update Succeeded!"; you are halfway done. Type reboot from the terminal.

5. Connect to the Internet again.

As soon as you reboot, you will see a bar at the top of the screen that says "Software Update" with options "Cancel" / "Later" / "Check now"... and you will not have most of your old activities available from your Home view. Get online before choosing Check now.

6. Download and update activities.

Choose Check now from the options at the top of your Home view. If you don't see these option, you can launch it from the Control Panel's Software Update feature. The Control Panel is an option on the hover menu at the center of your Home view.
Your XO will check online for new activities and updates. Click "Install selected" once it is done to update everything. By default, the activities checked are any already on your machine and those included on G1G1 2008 builds.


7. Add more Collections and Activities.

After you upgrade your current activities, while still in the Software Update screen:
a) click on the triangle next to "Modify activity groups" at the bottom of the screen
b) for the Group URL, enter http://wiki.laptop.org/go/Activities/All or some other subpage of the Activities page, and choose the Add button
c) choose the Refresh button, wait for the activity list to refresh, and Install selected to download them.

These changes should take effect without a reboot.

Congratulations, you've upgraded!


Upgrading offline

This process takes 10 minutes once you have downloaded the files onto a USB key.

You can use another computer that is connected to the internet (a desktop at home, a computer lab, etc.) and a USB storage device to upgrade your XO. This process will cmopletely erase ALL files on your XO.

  1. Make sure your XO is plugged in and has its battery in.
  2. Back up any files or Journal entries on your XO that you want to keep.
    This helps ensure the process is not interrupted in the middle.
  3. Get an empty USB stick with at least 500MB of space.
    The USB stick does not have to be completely empty. However, avoid using the same USB stick for this and other types of OLPC backups.
  4. Download the following files to your stick. Do not open or unzip the files.
  5. Turn off your XO and connect your USB stick to it.
  6. Hold down all four gamepad keys (on the right side of the screen, above the power button) and then turn on the XO. Keep holding the gamepad keys until the message "Release the game key to continue" appears on the screen.
  7. Release the game keys and wait for the reflash to complete.
    You should see a grid of black boxes appear on your screen, and then fill with color. Your XO is now reflashing. It will take 8-10 minutes and your XO should automatically show a 'complete' message and reboot when it is done.
  8. Reboot if it didn't happen automatically, and wait for the firmware to update.
    This happens the next time you reboot, and should take 1 minute. It will not proceed unless your battery is in and your laptop plugged in. The XO will reboot automatically once more after this.

Your update is done! Explore your new Home view (the available activities are now laid out in a circle around the central XO, and active activities appear in the top of the frame) and make sure that your favorite activities are installed.

If you need to install new activities, you can do so via the new Control Panel (see above).

Checksum and other technical details

The MD5 checksum for this image is 64c599eea92e29abb1b6ed72e7541734 . As of November 2008, this is the latest stable OLPC build. You can install this build onto secure machines.