Template:Software Install: Difference between revisions

From OLPC
Jump to navigation Jump to search
(Gigabyte is GB, not "Gb")
(swing terminology from memory stick (tm) to drive, as these instructions also work with USB HDD)
Line 23: Line 23:
| #default = storage
| #default = storage
}}
}}
device. You will need a USB memory stick of at least 1 GB capacity, but only for the duration of the installation.
device. You will need a [[USB drive]] of at least 1 GB capacity, but only for the duration of the installation.


'''ALL USER DATA WILL BE ERASED FROM THE LAPTOP!'''
'''ALL USER DATA WILL BE ERASED FROM THE LAPTOP!'''


*Prepare the USB memory stick:
*Prepare the USB drive:
**Download [{{{path}}}/{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img | XO-1.5 = zd}} {{{build}}}.{{ #switch: {{{model}}} | XO-1 = img | XO-1.5 = zd}}],
**Download [{{{path}}}/{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img | XO-1.5 = zd}} {{{build}}}.{{ #switch: {{{model}}} | XO-1 = img | XO-1.5 = zd}}],
**Save the file to the top directory of a USB memory stick, {{ #ifeq: {{{signed}}} | yes |
**Save the file to the top directory of the USB drive, {{ #ifeq: {{{signed}}} | yes |
**Download [{{{path}}}/{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img.fs.zip | XO-1.5 = zsp.fs.zip}} {{{build}}}.{{ #switch: {{{model}}} | XO-1 = img.fs.zip | XO-1.5 = zsp.fs.zip}}],
**Download [{{{path}}}/{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img.fs.zip | XO-1.5 = zsp.fs.zip}} {{{build}}}.{{ #switch: {{{model}}} | XO-1 = img.fs.zip | XO-1.5 = zsp.fs.zip}}],
**Save the file to the top directory of a USB memory stick,
**Save the file to the top directory of the same USB drive,
**Rename the file to fs.zip, (removing the {{{build}}}.{{ #switch: {{{model}}} | XO-1 = img | XO-1.5 = zsp}} part of the name),
**Rename the file to fs.zip, (removing the {{{build}}}.{{ #switch: {{{model}}} | XO-1 = img | XO-1.5 = zsp}} part of the name),
**Check the USB memory stick contains at least the two files fs.zip and {{{build}}}.{{ #switch: {{{model}}} | XO-1 = img | XO-1.5 = zd}}. | {{ #ifeq: {{{model}}} | XO-1 |
**Check the USB drive contains at least the two files fs.zip and {{{build}}}.{{ #switch: {{{model}}} | XO-1 = img | XO-1.5 = zd}}. | {{ #ifeq: {{{model}}} | XO-1 |
**Download [{{{path}}}/{{{build}}}.crc {{{build}}}.crc],
**Download [{{{path}}}/{{{build}}}.crc {{{build}}}.crc],
**Save the file to the top directory of a USB memory stick,
**Save the file to the top directory of a USB memory stick,
**Check the USB memory stick contains at least the two files {{{build}}}.img and {{{build}}}.crc
**Check the USB drive contains at least the two files {{{build}}}.img and {{{build}}}.crc
}}
}}
}}
}}
Line 46: Line 46:
**Connect the laptop to external power,
**Connect the laptop to external power,
**[[Shutdown|Turn off]] the laptop, unless it is already off.
**[[Shutdown|Turn off]] the laptop, unless it is already off.
**Insert the USB memory stick into any USB port on the laptop,
**Insert the USB drive into any USB port on the laptop,


*Start installing:
*Start installing:
Line 64: Line 64:
minutes. Once finished,
minutes. Once finished,
{{ #switch: {{{signed}}}
{{ #switch: {{{signed}}}
| yes = the laptop will reboot automatically. Remove the USB memory stick during or after the reboot.
| yes = the laptop will reboot automatically. Remove the USB drive during or after the reboot.
| no = the Ok prompt will return. Remove the USB memory stick. The laptop {{ #switch: {{{model}}} | XO-1 = may be rebooted. | XO-1.5 = must be rebooted using ''bye'' or the power button, not with the ''boot'' command.}}
| no = the Ok prompt will return. Remove the USB drive. The laptop {{ #switch: {{{model}}} | XO-1 = may be rebooted. | XO-1.5 = must be rebooted using ''bye'' or the power button, not with the ''boot'' command.}}
}}
}}
The USB memory stick can be used on other laptops.
The USB drive can be used on other laptops.


{{ #switch: {{{signed}}} | yes =
{{ #switch: {{{signed}}} | yes =
If you see a message ''Boot failed'' then either:
If you see a message ''Boot failed'' then either:
*the USB memory stick has not been properly prepared, or;
*the USB drive has not been properly prepared, or;
*the firmware is out of date and should be updated (see [[Firmware]]).}}
*the firmware is out of date and should be updated (see [[Firmware]]).}}

Revision as of 05:16, 27 August 2010

This page is generic installation instructions activated by template transclusion, and looking at the page like this (and not in Edit) won't help you understand it. The parameters expected are:

  • model: MODEL (XO-1 or XO-1.5, case is significant)
  • build: BUILD (which build, e.g. os206)
  • signed: SIGNED (yes or no)
  • release: RELEASE (which release version this build is intended for, e.g. 10.1.2)
  • path: PATH (the path via HTTP to the directory that contains the build file)


How to install

build BUILD of release RELEASE on MODEL.

The build is installed to the internal storage device. You will need a USB drive of at least 1 GB capacity, but only for the duration of the installation.

ALL USER DATA WILL BE ERASED FROM THE LAPTOP!

  • Prepare the USB drive:
    • Download [{{{path}}}/{{{build}}}. {{{build}}}.],
    • Save the file to the top directory of the USB drive,
  • Prepare the laptop:
    • Make a copy of any data you wish to keep,
    • Ensure the battery is in the laptop,
    • Connect the laptop to external power,
    • Turn off the laptop, unless it is already off.
    • Insert the USB drive into any USB port on the laptop,
  • Start installing:


Installation progress will be displayed. Green colour will fill grey blocks. It will take about

minutes. Once finished,

The USB drive can be used on other laptops.