Talk:Secure upgrade
Steps for Activated Upgrade, in Plain English
(for G1G1 Recipients)
0. Before performing the upgrade, please note that EVERYTHING previously created will be deleted!
1. You need a USB stick that is larger than 300 MB, and it is better that you format it before copying any files over.
2. Once you have the formatted USB stick, download the following two files from the Internet:
http://download.laptop.org/xo-1/os/official/653/jffs2/fs.zip
http://download.laptop.org/xo-1/os/official/653/jffs2/os653.img
(the second file is quite large, so it might take a while to download)
- To download those files, please plug in the USB stick to another computer that is connected to the Internet. Open each of the above two URLs in the browser. You should see a message asking you whether to save/open the file. Save both files to the USB stick. Eject/Remove the USB stick, and unplug it.
3. Make sure the XO laptop is OFF. Plug in the USB stick.
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 keys', release all four buttons.
6. You will see arrays of colored grids running on the screen. We are now re-writing the NAND image.
7. Once done with re-writing the NAND, the laptop will reboot itself.
8. Next, the laptop may update the firmware, if necessary, and reboot itself. (You don't have to do anything; just watch.)
9. After done with the upgrade(s), the laptop will boot to the prompt for your preferred user name.
10. Go to the Terminal activity (click on the taskbar icon; it looks like a rectangle with a $ on the upper left corner) and type the following:
cat /etc/issue
- 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. Press the Enter key
12. If the screen says something that begins with
OLPC build 653
then we are one step closer to finishing the upgrade process!
13. Type the following:
poweroff
14. Press the Enter key
15. Now the laptop is off. You should be able to remove the USB stick and power it up as usual.
Which are the game keys?
- The four buttons to the lower right of the screen, with a square, circle, X, and checkmark on them. —Joe 09:32, 21 December 2007 (EST)
How to determine version?
How do you determine which version you are running?
- There are instructions for determining this on the autoreinstallation image page. —Joe 09:41, 21 December 2007 (EST)
- Run the command 'cat /etc/issue'. --Michael Stone 16:56, 22 December 2007 (EST)
Key/USB key/USB stick/game key
The terminology used here is very confusing. "the key" in 1.3 is not clear what it is and there are references to "game key" and "usb stick" as well.
"Hold onto the key" is also confusing with "hold all four game buttons" (at least for non-native English speakers).
(It is maintained by the "team" so I didn't make changes directly.)
Ohshima 16:30, 23 December 2007 (EST)
- Well I did edit the page. I tried to preserve the original meaning so please take a look at it and do further corrections. Ohshima 00:20, 24 December 2007 (EST)
Instr. Rewrite
From a computer:
Go here in a web browser:
http://download.laptop.org/xo-1/os/official/latest/jffs2/
Download os###.img and fs.zip from that directory.
From the laptop:
Plug the flash drive into the laptop.
Push and hold all of the game keys on right of the laptop while powering
it on, and hold the keys for 5 seconds.
The laptop will then update itself.
ffm 20:06, 31 December 2007 (EST)
Safe to stop after step 9?
Is it safe to power off after Step 9 if you want to revert to an "Out of the box" state for someone else? Maybe you're passing the laptop down to a younger child after it was outgrown, ie: hand me down laptop. Or perhaps you were just test driving the laptop for a short while before giving it to it's intended recipient.
- 9. After done with the upgrade(s), the laptop will boot to the prompt for your preferred user name.
If so then perhaps a we could add a new step
- 9.a. When prompted for your preferred user name it is safe to power off by holding the power button for 5 seconds. You may wish to do so if you've used the laptop and have then performed an Activated Upgrading in order to erase your journal entries, network settings, nickname, and other preferences. Perhaps because you intend to pass the laptop along to some child who will wish to choose their own user name, XO colors, and start out fresh.
Or something to that effect. I have confirmed that this does in fact work, you can power off and then resume later with the next boot prompting for user name and colors preferences. So unless by some chance there are some discrete cryptographic key or unique XO identity which is not generated because of this new step then I would like to request that the new (optional) step above be added to the article. --D0li0 06:51, 4 January 2008 (EST)
Change to instructions - add SD card
The page as is only mentions using a USB stick to perform the activated upgrade, but an SD card works too. Should the instructions be changed to reflect this? It's just a little thing but can save a little frustration for some users if they have an SD card but not a USB stick handy. --Karindalziel 17:36, 4 January 2008 (EST)
Steps slightly out of order...
... proposed edit
FROM:
[..deletia..]
10. Go to the Terminal activity (click on the taskbar icon; it looks like a
rectangle with a $ on the upper left corner) and type the following:
cat /etc/issue
* 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. Press the Enter key
12. If the screen says something that begins with
[..deletia..]
TO
10. Go to the Terminal activity (click on the taskbar icon; it looks like a rectangle with
a $ on the upper left corner)
11. 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.)
12. Type the following command:
cat /etc/issue
13. Press the Enter key
14. If the screen says something that begins with
Makes a little more sense to me... what do you think ? --IainD 00:11, 6 January 2008 (EST)
Agree. But I'm still waiting for the permission to edit the page. --Chihyu 00:45, 11 January 2008 (EST)
I just made the changes. --Chihyu 15:06, 14 January 2008 (EST)
File sizes..
Please add to wiki page...
194 K http://download.laptop.org/xo-1/os/official/653/jffs2/fs.zip 293 M http://download.laptop.org/xo-1/os/official/653/jffs2/os653.img
"... is a large file ... " is not very descriptive. :)
--IainD 05:37, 6 January 2008 (EST)
Added. --Chihyu 15:26, 14 January 2008 (EST)
Steps 10-14 Neccesary?
Are steps 10 through 14 necessary enough to be included in the Upgrade instructions?
Yes, a couple of non tech-savvy users have found these steps very helpful. --Chihyu 16:24, 15 January 2008 (EST)
Keywords For Retrieval
While searching for a way to wipe my (G1G1) XO in order to start from scratch, I did not come across this page. Someone on IRC had to point me in the right direction instead. Could we add some keywords (e.g. "revert", "reinstall", "factory default" etc.) to the page to make it easier to retrieve? -- Ace NoOne 12:31, 22 January 2008 (EST)
- It's already in the Support FAQ. --Chihyu 17:51, 22 January 2008 (EST)
- That's still not ideal IMHO; I don't think that "factory configuration" is what most people would look for in this situation. I was thinking of something like this (rough draft):
- This page describes how to do a re-flash of an activated laptop. This will erase all modifications, reverting to factory defaults by reinstalling the operating system.
- -- Ace NoOne 04:44, 23 January 2008 (EST)
- That's still not ideal IMHO; I don't think that "factory configuration" is what most people would look for in this situation. I was thinking of something like this (rough draft):