User:Mchua/Braindumps/upgrade draft: Difference between revisions

From OLPC
Jump to navigation Jump to search
mNo edit summary
 
(14 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Deprecated}}

= Getting 8.2.0 on your XO =
= Getting 8.2.0 on your XO =


So you want to get 8.2.0 on your XO! It has shiny new things.
So you want upgrade to 8.2.0 on your XO! It has shiny new features.


If you want to wipe out everything on your XO and have fresh versions of the 8.2.0 release and Activities, see the "Making my XO like new" section. '''Your Journal entries will be lost - you are erasing all your data and starting over with the new software!'''
If you want to wipe out everything on your XO and start with a fresh version of the 8.2.0 release and its Activities, see the "Making my XO like new" section below. '''If you use this method, your Journal entries will be lost--all of your data will be erased!'''


If you want to keep the work you've done in your Journal but get the new software, see the "Keep my work, but give me the new software" section. You will need to have your XO connected to the internet - otherwise, you will have to use the instructions above. '''When you upgrade to 8.2.0, you might not be able to use all the Activities you were using with the previous build, so you might not be able to use all your Journal entries if they were made using Activities that do not work with 8.2.0.'''
If you want to upgrade to the new software but keep the work you've done in your Journal, see the "Keep my work, but give me the new software" section below. Your XO needs to be connected to the internet--otherwise, you will have to use the "Making my XO like new" instructions. '''When you upgrade to 8.2.0, you may not be able to use all the Activities you were using with the previous build. You might also be unable to use any Journal entries that were made using Activities that do not work with 8.2.0.'''


== Making my XO like new ==
== Making my XO like new ==


With Internet connectivity, you can prepare yourself to reflash (restore) an XO to its factory-default settings. This procedure is called a "clean-install" and is described in more detail at http://wiki.laptop.org/go/Clean-install_procedure. Clean-installing works by completely reformatting your XO with a software image stored on a USB storage device. YOU WILL LOSE ALL YOUR DATA!
If you have access to the Internet, you can prepare yourself to restore an XO to its factory default settings, or ''reflash'' the XO. This procedure is called a "clean-install" and is described in more detail at http://wiki.laptop.org/go/Clean-install_procedure. Clean-installing works by completely reformatting your XO with a software image stored on a USB storage device. '''This will erase all of your data!'''


=== What you will need ===
=== What you will need ===


* A USB storage device that is at least 1GB in size. It should be empty.
* An '''empty''' USB storage device that is at least 1GB in size.
* A computer with fast Internet access.
* A computer with fast Internet access.


Line 19: Line 21:


This depends on how fast your internet connection is. You will be downloading two special files that are about 300-400MB in size. On a fast internet connection, this should take less than an hour.
This depends on how fast your internet connection is. You will be downloading two special files that are about 300-400MB in size. On a fast internet connection, this should take less than an hour.

After you download these two files, you will put them on your USB storage device and then perform a reflashing process on your XO that will take about 10 minutes.


=== Preparing your USB Storage Device ===
=== Preparing your USB Storage Device ===


# Download these files (do not open them - on a non-XO computer, you will usually want to do a right-click and "Save As."):
# Download the following files (do not open them--on a non-XO computer). You will usually want to right-click (Ctrl-click for Mac) on each of the above two URLs in the browser and choose "Save Target As" ("Save Link As" for Firefox):
## http://download.laptop.org/xo-1/custom/g1g1/releases/8.2-latest/os-image.html
## http://download.laptop.org/xo-1/custom/g1g1/releases/8.2-latest/os-image.html
## http://download.laptop.org/xo-1/custom/g1g1/releases/8.2-latest/fs-zip.html
## http://download.laptop.org/xo-1/custom/g1g1/releases/8.2-latest/fs-zip.html
# You now have two files: '''gg-767.img''' and ''fs.zip''. Copy these two files onto your USB storage device. They should be the only files there.
# You now have two files: ''gg-767-4.img'' and ''fs.zip''. Copy these files onto your USB storage device. Make sure they are the only files there.
# Eject the USB storage device and disconnect it from your computer when it is safe to do so. <!-- Should we have instructions for ejecting a USB storage device here? Caryl tweaked this a little, but I like this version a little better. It saves the step of moving the files from the computer to the USB It is from the "Secure Upgrade" section..To download those files, plug the USB flash drive into another computer that is connected to the Internet. Right-click (Ctrl-click for Mac) on each of the above two URLs in the browser and choose "Save Target As" ("Save Link As" for Firefox). Save both files to the USB flash drive. Eject/Remove the USB flash drive, and unplug it. -->
# Unmount the USB storage device and disconnect it from your computer when it is safe to do so.


=== Reflashing your XO ===
=== Reflashing your XO ===
Line 34: Line 34:
# Turn off your XO.
# Turn off your XO.
# Connect your USB storage device to your XO.
# Connect your USB storage device to your XO.
# Hold down all four gamepad keys (on the right side of the screen, above the power button). While continuing to hold down the four gamepad keys, push the power button to turn the XO on. Do not release the gamepad keys yet.
# 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. '''Do not release the gamepad keys yet.'''
# When you see a message that tells you to "Release the game key to continue", release the gamepad keys.
# When the message "Release the game key to continue" appears, release the gamepad keys.
# If you see a grid of colored boxes on your screen, congratulations - your XO is reflashing.
# If you see a grid of colored boxes on your screen, congratulations! Your XO is reflashing.


=== Finishing up ===
=== Finishing up ===


That's it! The reflashing process will run automatically. The XO will color in the grid of boxes, and then you will see the words "Rebooting in 10 seconds..." right before the XO reboots itself. You can remove the USB storage device after the XO reboots itself.
That's it! The reflashing process will run automatically. The XO will color in the grid of boxes, and the words will appear "Rebooting in 10 seconds..." shortly before the XO reboots itself. You can safely remove the USB storage device after the XO reboots itself.


Your XO now has a clean image of release 8.2.0 along with the Activities that came with it. You can now choose a name and colors for your XO and then start playing with the Activities. Congratulations!
Your XO now has a clean image of release 8.2.0 along with the Activities that came with it. You can now choose a name and colors for your XO and then start playing with the Activities. Congratulations!
Line 46: Line 46:
=== If something goes wrong ===
=== If something goes wrong ===


If you see a "Bad hash at eblock #0" message while reflashing your XO, it means there was a mistake copying the files to your USB storage device. You should try repeating these instructions again, but with a different USB storage device.
If the message "Bad hash at eblock #0" appears while reflashing your XO, it means there was a mistake copying the files to your USB storage device. You should try repeating these instructions again, but with a different USB storage device.


== Keep my work, but give me the new software ==
== Keep my work, but give me the new software ==
<!-- Feed me text! -->
=== What you will need ===


You will need your XO and a fast connection to the Internet. <!-- I just sort of guessed here. -->
# Determine which version your XO is running.
# Plug the XO into AC Power
# Connect XO to the internet
# Launch the update command
# Update activities


=== How long it will take ===
=== 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.


This depends on how fast your internet connection is. On a fast internet connection, it should take less than an hour.
# Press ctrl+alt+F2 (the F2 key is the same as the Group key [[Image:Friends key f2 small.png]]. The Ctrl key has a solid diamond on it (♦); the Alt key has an open diamond on it (♢). See [[Keyboard Shortcuts]] for more details.)
# Read the build number from the first line of text that appears in the console window


=== Preparing your XO ===
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:


Make sure your XO is plugged in, turned on, and connected to the Internet (you should be able to load http://laptop.org in the Browse Activity).
The OS build number in the above example is '''656'''.


=== Upgrading your XO ===
To return to the Sugar graphical display press ctrl+alt+F3 . (The F3 key is the same as the Home key ([[Image:Home key f3 small.png]]).)

=== 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 [http://laptop.org/laptop/start/connecting.shtml Connecting Guide] or [[Wifi Connectivity]] for instructions. Use Browse activity to test your connection.

=== Step 4: Launch the update command ===
Open the '''[[Terminal Activity]]''' [[Image:Activity-terminal.svg|35px]] 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 ''{{:Friends in testing/current image}}''

If your XO is on build 703 or later:

sudo olpc-update ''{{:Friends in testing/current image}}'' <!-- reboot, verbose -->

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


# Open the Terminal Activity.
# In the Terminal Activity, type <code>su -</code> (lowercase letter 's', lowercase letter 'u', a space, and a hyphen). Press Enter.
# Now type <code>/usr/sbin/olpc-update 8.2.0</code>. (a forward slash, 'usr', a forward slash, 'sbin', a forward slash, 'olpc-update,' a space, and '8.2.0'). Press Enter.
# You should see text that looks something like this.
<pre>
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 100: Line 78:
Verifying update.
Verifying update.
Installing update in /versions/{pristine,run}/''xxxx''
Installing update in /versions/{pristine,run}/''xxxx''
</pre>

# At the end of the upgrade, you will see the words "Update Successful!" appear on the screen.
This process may take more than thirty minutes. When the process is complete, you need to [[reboot]].
# Reboot your XO by entering 'reboot' and press Enter.

Congratulations, you've upgraded!
'''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.

[[Image:820_firstactivityinstall.png|thumb|G1G1 Activity install]]
[[Image:820 updateproposal.png|thumb|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.

Latest revision as of 16:01, 20 December 2009

Stop hand.png WARNING:
The content of this section is considered
DEPRECATED and OBSOLETE
It is preserved for historical or documenting reasons.

Getting 8.2.0 on your XO

So you want upgrade to 8.2.0 on your XO! It has shiny new features.

If you want to wipe out everything on your XO and start with a fresh version of the 8.2.0 release and its Activities, see the "Making my XO like new" section below. If you use this method, your Journal entries will be lost--all of your data will be erased!

If you want to upgrade to the new software but keep the work you've done in your Journal, see the "Keep my work, but give me the new software" section below. Your XO needs to be connected to the internet--otherwise, you will have to use the "Making my XO like new" instructions. When you upgrade to 8.2.0, you may not be able to use all the Activities you were using with the previous build. You might also be unable to use any Journal entries that were made using Activities that do not work with 8.2.0.

Making my XO like new

If you have access to the Internet, you can prepare yourself to restore an XO to its factory default settings, or reflash the XO. This procedure is called a "clean-install" and is described in more detail at http://wiki.laptop.org/go/Clean-install_procedure. Clean-installing works by completely reformatting your XO with a software image stored on a USB storage device. This will erase all of your data!

What you will need

  • An empty USB storage device that is at least 1GB in size.
  • A computer with fast Internet access.

How long it will take

This depends on how fast your internet connection is. You will be downloading two special files that are about 300-400MB in size. On a fast internet connection, this should take less than an hour.

Preparing your USB Storage Device

  1. Download the following files (do not open them--on a non-XO computer). You will usually want to right-click (Ctrl-click for Mac) on each of the above two URLs in the browser and choose "Save Target As" ("Save Link As" for Firefox):
    1. http://download.laptop.org/xo-1/custom/g1g1/releases/8.2-latest/os-image.html
    2. http://download.laptop.org/xo-1/custom/g1g1/releases/8.2-latest/fs-zip.html
  2. You now have two files: gg-767-4.img and fs.zip. Copy these files onto your USB storage device. Make sure they are the only files there.
  3. Eject the USB storage device and disconnect it from your computer when it is safe to do so.

Reflashing your XO

  1. Turn off your XO.
  2. Connect your USB storage device to your XO.
  3. 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. Do not release the gamepad keys yet.
  4. When the message "Release the game key to continue" appears, release the gamepad keys.
  5. If you see a grid of colored boxes on your screen, congratulations! Your XO is reflashing.

Finishing up

That's it! The reflashing process will run automatically. The XO will color in the grid of boxes, and the words will appear "Rebooting in 10 seconds..." shortly before the XO reboots itself. You can safely remove the USB storage device after the XO reboots itself.

Your XO now has a clean image of release 8.2.0 along with the Activities that came with it. You can now choose a name and colors for your XO and then start playing with the Activities. Congratulations!

If something goes wrong

If the message "Bad hash at eblock #0" appears while reflashing your XO, it means there was a mistake copying the files to your USB storage device. You should try repeating these instructions again, but with a different USB storage device.

Keep my work, but give me the new software

What you will need

You will need your XO and a fast connection to the Internet.

How long it will take

This depends on how fast your internet connection is. On a fast internet connection, it should take less than an hour.

Preparing your XO

Make sure your XO is plugged in, turned on, and connected to the Internet (you should be able to load http://laptop.org in the Browse Activity).

Upgrading your XO

  1. Open the Terminal Activity.
  2. In the Terminal Activity, type su - (lowercase letter 's', lowercase letter 'u', a space, and a hyphen). Press Enter.
  3. Now type /usr/sbin/olpc-update 8.2.0. (a forward slash, 'usr', a forward slash, 'sbin', a forward slash, 'olpc-update,' a space, and '8.2.0'). Press Enter.
  4. You should see text that looks something like this.
 Downloading contents of build ''{{:Friends in testing/current image}}''
 Updating to version hash ''xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx''
 Making clean /versions/updates/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
 Trying irsync_pristine update from rsync://updates.laptop.org/''build-{{:Friends in testing/current image}}''
 - Cleaning tree.
 - Fetching contents.
 - Performing incremental rsync.
 Verifying update.
 Installing update in /versions/{pristine,run}/''xxxx''
  1. At the end of the upgrade, you will see the words "Update Successful!" appear on the screen.
  2. Reboot your XO by entering 'reboot' and press Enter.
Congratulations, you've upgraded!
Retrieved from "http://wiki.laptop.org/mediawiki/index.php?title=User:Mchua/Braindumps/upgrade_draft&oldid=228792"