Update paths

From OLPC

Contents 1 Users 1.1 With Internet Connectivity (faster update) 1.2 Off-line (big download) 1.2.1 Verify your update 1.3 Make sure you won't lose your activation lease 1.4 Upgrade a Secured Laptop with a Signed Image 1.5 Upgrading to an Unsigned Image by disabling security 2 Developers 2.1 Determine the state of your laptop

[edit] Users

Update paths for users:

• With internet connectivity (if your internet works) - Keeps changes made to your laptop
  
• Without internet connectivity - Wipes all changes to your laptop

It would be a good idea to plug in your laptop, so as to minimize hassle if your laptop loses power. However, it is not required, and the update process can safely be interrupted and redone later.

[edit] With Internet Connectivity (faster update)

---

Main article: olpc-update

olpc-update is designed to work with even the worst internet connections, and will do no harm if it is interrupted during download. If you don't like your new software update, you can revert to the older version by holding down the O key on the game pad (between the right speaker and the power button) when you next turn the laptop on.

To manually upgrade your machine when a new version is released:

1. Plug the XO into an electrical outlet
2. Connect to the internet. If you are upgrading because you have a WPA hotspot at home, you might want to go to a Public Hotspot to connect to the internet for an online upgrade, such as a T-Mobile hotspot or a local libary.
   Firewall note: olpc-upgrade requires outgoing TCP PORT:873 to be unfiltered by the hotspot's firewall. In otherwords if the laptop has functional-access to the internet but olpc-upgrade returns the message "I don't think you're connected to the internet." check the hotspot's firewall is not blocking the outgoing TCP Port 873.
3. Open the Terminal Activity and type the following (press the Enter key after each line) OR press CTRL+ALT+(Three Dots Icon) and log in as "root", and enter the following commands:

su -l
olpc-update build-number 

Where

• in su -l, it's lower case "L", not the number "1"

Note: su does not work in terminal with some builds which require a password until you become "root". You can become "root" by pressing the "#_" icon at the top of the terminal screen. In some other builds you may need to type "sudo olpc-update build-number" instead.

• build-number is the number of the build to be updated to.

The latest stable build is 656.

• Please note that upgrading to build 656 may disassociate the external applications installed in the previous build. See Trac #6317. --Chihyu 13:26, 1 February 2008 (EST)

If you want to help test a new and highly experimental version of the XO software (unsupported as of yet), a developer key is not needed ,you can then update to candidate-703. joyride-1914 (30 April 2008 build) requires a developer key, contains experimental and test version software and may be unstable (for intrepid software testers and developers).

If the update program successfully connects to the update server some messages should display

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

Where ... is a version specific number.

This process may take more than thirty minutes. When the process is complete, the XO will restart (if the -r option was passed to olpc-update) and the update will be complete.

[edit] Off-line (big download)

---

Main article: Secure Upgrade

0. Before performing the upgrade, please note that EVERYTHING previously created will be deleted!

1. You need a formatted USB stick that is larger than 300 MB, and it is better that you format it before copying any files over.

2. Download the following two files from the Internet and put them on the USB stick:

http://download.laptop.org/xo-1/os/official/656/jffs2/fs.zip

http://download.laptop.org/xo-1/os/official/656/jffs2/os656.img

• To download those files, plug in the USB stick to 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 stick. Eject/Remove the USB stick, and unplug it.

The first file is about 194KB, and the second file is quite large (about 293 MB), which might take a while to download.

After you have finished this step, there should be two files on the USB stick, the fs.zip file, and the img file.

3. Make sure the XO laptop is OFF. Make sure that the battery is installed, and that you have external (AC) power plugged in as well. Plug in the USB stick, and do not unplug it until instructed.

4. With the USB stick inserted, power up the laptop while holding down ALL four game buttons on the right side of screen (the four buttons above the power button, and they are marked with O, V, X, and square). Please be sure to press all of them firmly; use two thumbs if that helps.

5. When the screen says 'release the game key to continue', release all four buttons.

6. You will see arrays of colored grids running on the screen. We are now re-writing the laptop with the new operating system.

7. Once done with re-writing, the laptop will reboot itself.

8. Next, the laptop may update the firmware, if necessary, and reboot itself. It will insist on being plugged in and having a battery present if it needs to update the firmware. (You don't have to do anything; just watch.)

9. After done with the update, the laptop will boot to the prompt for your preferred user name. You can now remove the USB key, and it is no longer needed.

[edit] Verify your update

10. Go to the Terminal activity (click on the taskbar icon )

• The screen should say something like [olpc@xo-05-2D-2F ~]$
• The numbers don't matter, but be sure that you type things after the $ sign.

11. Type the following to check which version you XO is running:

  cat /etc/issue

12. Press the Enter key

13. If the screen says something that begins with

  OLPC build 656

then we are one step closer to finishing the upgrade process!

14. Go to Home view and mouse over the XO guy in the center.

15. Select the "Shutdown" option to power off the machine. Now you should be able to power it up as usual, with build 656.

<noinclude>

[edit] Make sure you won't lose your activation lease

G1G1 recipients do not need a lease, and should skip this section.

(Here we check to see whether your laptop has the ak flag set or an activation lease. This doesn't work if your laptop won't boot, so if you're doing this upgrade to get your laptop to start booting again, just proceed to the next section and do the upgrade.)

1. Get to a terminal on the laptop, and type: ls /security
   • On XO-1 this requires root permissions. Press the Ctrl+Alt+ keys together to get to the console, log in as root and then enter the command above as stated.
   • If there is a lease.sig file, you will want to save this lease before re-flashing the laptop.
     1. To do so, insert a USB stick, wait for it to mount, and then type: cp /security/lease.sig /media/{name_of_usb_stick}
     2. Then, switch to the home view, go to the journal, mouse over the USB icon, and click unmount.
     3. Remove the USB stick from the USB slot, but make sure the lease.sig file is stored on it. You will have to boot the laptop with this USB stick inserted after the upgrade.
   • If there is no lease.sig file, your manufacturing data is probably set for pre-activation, and you probably don't need to do anything.
   • If you want to check that this is in fact true, in a terminal, type: ls /ofw/mfg-data/
   • If there is an 'ak' there, then the laptop is pre-activated.

[edit] Upgrade a Secured Laptop with a Signed Image

To put the latest signed image (stable build) on the laptop, follow these steps:

1. Create a USB stick with the files os{number}.img and fs.zip on the disk in the top-level directory. (We recommend that you use a "factory-formatted" USB stick.)
   • You can download these files from the latest official release.
2. With the USB stick inserted into your XO, and the battery installed, and AC power plugged in, power up the laptop while holding down all four game buttons on the right side of screen.
3. When prompted to release the game keys, do so.
   • This will re-write the internal flash memory image.
4. Once done with this re-flash, the laptop will reboot itself.
5. Next, the laptop may update the boot firmware, if necessary, and reboot itself.
6. After done with the upgrade(s), the laptop will either boot to the prompt you for a name. (If the laptop is not activated, it will fail to boot; all G1G1 laptops are shipped activated.)
7. From the Terminal activity check that the laptop is at the version you wanted by typing the command:

cat /etc/issue

(If your laptop failed to boot, insert the USB stick with lease.sig on it, and boot the laptop. This can be the same USB stick you used in Step 1 above. This should get you to the prompt for a name.)

[edit] Upgrading to an Unsigned Image by disabling security

To put an unsigned image (not a stable release), you will first need to disable activation security. In a country deployment, this may make your laptop more vulnerable to theft — but it's assumed that if you're running a unstable build you're a developer and willing to take the risk.

First, disable security on the laptop:

1. Create a folder security on the top-level of your USB stick and place your develop.sig in this folder. Go to the Activation and Developer Keys page for details on how to get a develop.sig developer key
2. Plug in the USB key and boot
3. Immediately hit the "X" Escape key
4. At the firmware ok prompt, type disable-security The XO should reboot. Pay attention to the messages given; you may have to repeat these two steps. Leave in the USB key.

Now, you can follow the normal "developer upgrade" instructions, using either olpc-update or this OFW technique:

1. Create a USB stick with the files os{number}.img and os{number}.img.crc on the disk in the top-level directory. (We recommend that you use a "factory-formatted" USB stick.) (Note that the 'fs.zip' file is used only for 'secure' upgrade, not for this process, and does not exist for unstable builds.)
2. Boot the laptop. OFW will prompt you to hit "Escape" (the X key in the upper-left) to interrupt the boot process. Do so!
3. At the firmware ok prompt, type copy-nand disk:\os698.img. The XO should reboot once it is finished.
4. Beware: these instructions may change in the future as we transition to a Customization key process.

You can re-enable security in the future if you want to return to signed builds by typing 'enable-security' at the OFW ok prompt. (Again, pay attention to what OFW says; you may need to do this twice.)

[edit] Developers

[edit] Determine the state of your laptop

This is about determining which way to re-flash a laptop (for upgrading without re-flashing, which deletes all data on the laptop, use olpc-update

Action: Boot your laptop

If...

1. Your laptop gives you the option to get to the ok prompt by pressing escape
   • Your laptop is insecure, and you can use the Insecure Upgrade
2. Your laptop shows pretty boot, meaning you have no option to get to the ok prompt, and you see an XO with dots going around it
   • Your laptop is activated, and you can use the Activated Upgrade
3. Your laptop shows an XO with a red blinking usb key icon below it, and then a blinking wi-fi icon.
   • Your laptop is not activated.
   • If you want to Activate or Pre-Activate your laptop, see Activation and Developer Keys and/or Pre-Activate an XO, and then follow Activated Upgrade
   • If you want to leave your laptop de-activated but need to upgrade before shipping it, you can use De-Activated Upgrade

• Upgrade for OLPC shipping
• Upgrade for G1G1 at Brightstar