Template:Software Install2: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
(incorporate SD card instructions)
Line 2: Line 2:


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


Line 25: Line 25:
| #default = storage
| #default = storage
}}
}}
device. You will need a [[USB drive]] of at least 1 GB capacity, but only for the duration of the installation.
device. You will need a [[USB drive]] or [[Secure Digital card]] 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 drive:
*Prepare the USB or SD drive:
**Download [{{{path}}}/os{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img | XO-1.5 = zd4}} os{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img | XO-1.5 = zd4}}],
**Download [{{{path}}}/os{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img | XO-1.5 = zd4}} os{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img | XO-1.5 = zd4}}],
**Save the file to the top directory of the USB drive, {{ #ifeq: {{{signed}}} | yes |
**Save the file to the top directory of the drive, {{ #ifeq: {{{signed}}} | yes |
**Download [{{{path}}}/os{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img.fs.zip | XO-1.5 = zd4.zsp.fs.zip}} os{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img.fs.zip | XO-1.5 = zd4.zsp.fs.zip}}],
**Download [{{{path}}}/os{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img.fs.zip | XO-1.5 = zd4.zsp.fs.zip}} os{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img.fs.zip | XO-1.5 = zd4.zsp.fs.zip}}],
**Save the file to the top directory of the same USB drive,
**Save the file to the top directory of the same drive,
**Rename the file to fs.zip, (removing the os{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img | XO-1.5 = zd4.zsp}} part of the name),
**Rename the file to fs.zip, (removing the os{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img | XO-1.5 = zd4.zsp}} part of the name),
**Check the USB drive contains at least the two files fs.zip and os{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img | XO-1.5 = zd4}}. | {{ #ifeq: {{{model}}} | XO-1 |
**Check that the drive contains at least the two files, fs.zip and os{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img | XO-1.5 = zd4}}. | {{ #ifeq: {{{model}}} | XO-1 |
**Download [{{{path}}}/os{{{build}}}.crc os{{{build}}}.crc],
**Download [{{{path}}}/os{{{build}}}.crc os{{{build}}}.crc],
**Save the file to the top directory of a USB memory stick,
**Save the file to the top directory of a USB or SD drive,
**Check the USB drive contains at least the two files os{{{build}}}.img and os{{{build}}}.crc
**Check that the drive contains at least the two files, os{{{build}}}.img and os{{{build}}}.crc
}}
}}
}}
}}
Line 58: Line 58:
| no =
| no =
**Obtain the [[Ok]] prompt,
**Obtain the [[Ok]] prompt,
**Type the command:
**Type the command: (If you are using an SD card, substitute sd:\ for u:\ below.)
{{ #switch: {{{model}}} | XO-1 = copy-nand u:\os{{{build}}}.img | XO-1.5 = fs-update u:\os{{{build}}}.zd4 | #default = ERROR}}
{{ #switch: {{{model}}} | XO-1 = copy-nand u:\os{{{build}}}.img | XO-1.5 = fs-update u:\os{{{build}}}.zd4 | #default = ERROR}}
}}
}}
Line 68: Line 68:
minutes. Once finished,
minutes. Once finished,
{{ #switch: {{{signed}}}
{{ #switch: {{{signed}}}
| yes = the laptop will reboot automatically. Remove the USB drive during or after the reboot.
| yes = the laptop will reboot automatically. You may remove the USB or SD drive during or after the reboot.
| 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 the power button, not with the ''boot'' command.}}
| no = the Ok prompt will return. You may remove the USB or SD drive. The laptop {{ #switch: {{{model}}} | XO-1 = may be rebooted. | XO-1.5 = must be rebooted using the power button, not with the ''boot'' command.}}
}}
}}
The USB drive can be used on other laptops.
The USB or SD 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 drive has not been properly prepared, or;
*the USB or SD 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]]).}}


{{ #switch: {{{model}}} | XO-1.5 =
{{ #switch: {{{model}}} | XO-1.5 =
The above instructions assume that you are installing onto a 4GB internal microSD card. For the 2GB version, use the zd2 files, and for the 8GB version, use the zd8 files.
The above instructions assume that you are installing onto a 4 GB internal microSD card. For the 2 GB version, use the zd2 files, and for the 8 GB version, use the zd8 files.
}}
}}

Revision as of 14:03, 20 July 2011

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., 206)
  • 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)

It differs from "Sofware Install" in that it is modified for the zd2/zd4/zd8 notation


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 or Secure Digital card 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 or SD drive:
    • Download [{{{path}}}/os{{{build}}}. os{{{build}}}.],
    • Save the file to the top directory of the drive,
  • Prepare the laptop:
    • Make a copy of any data you wish to keep,
    • Check the battery is inserted and locked,
    • Check that the power cord is in place and the battery indicator is green,
    • 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

blocks. It will take about

minutes. Once finished,

The USB or SD drive can be used on other laptops.