Template:Software Install2: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
(removing defunct link to pictures showing holding down all four game keys)
 
(32 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<noinclude>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:
<noinclude>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|MODEL (XO-1 or XO-1.5, case is significant)}}}
*model: {{{model|MODEL (XO-1, XO-1.5 or XO-1.75, case is significant)}}}
*build: {{{build|BUILD (which build, e.g. 206)}}}
*build: {{{build|BUILD (which build, e.g., 206)}}}
*ubifs: {{{ubifs|UBIFS (yes or no)}}}
*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)}}}


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

How to install
How to install
{{ #switch: {{{signed}}} | yes = signed | no = unsigned }}
{{ #switch: {{{signed}}} | yes = signed | no = unsigned }}
Line 23: Line 23:
| XO-1 = NAND flash
| XO-1 = NAND flash
| XO-1.5 = microSD
| XO-1.5 = microSD
| XO-1.75 = microSD
| #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 | XO-1.75 = zd4}} os{{{build}}}.{{ #switch: {{{model}}} | XO-1 = {{ #switch: {{{ubifs}}} | yes = uim and os{{{build}}}.onu | #default = img }} | XO-1.5 = zd4 | XO-1.75 = zd4}}], see [[Download#How_to_Download|How to Download]],
**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 | XO-1.75 = zd4.zsp.fs.zip}} os{{{build}}}.{{ #switch: {{{model}}} | XO-1 = img.fs.zip | XO-1.5 = zd4.zsp.fs.zip | XO-1.75 = 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 | XO-1.75 = 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 | XO-1.75 = 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 52: Line 53:
*Start installing:
*Start installing:
{{ #switch: {{{signed}}} | yes =
{{ #switch: {{{signed}}} | yes =
**Hold down all four game keys (see this [[USB_update#Let.27s_do_it.21_in_3_easy_steps|in pictures]]),
**Hold down all four game keys above the power button,
**Turn on the laptop,
**Turn on the laptop,
**Wait for the message ''Release the game keys to continue'',
**Wait for the message ''Release the game keys to continue'',
Line 58: Line 59:
| 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 = {{ #switch: {{{ubifs}}} | yes = update-nand u:\os{{{build}}}.onu | #default = copy-nand u:\os{{{build}}}.img }} | XO-1.5 = fs-update u:\os{{{build}}}.zd4 | XO-1.75 = fs-update u:\os{{{build}}}.zd4 | #default = ERROR}}}}
}}


Installation progress will be displayed. Green colour will fill
Installation progress will be displayed. Green colour will fill
{{ #switch: {{{model}}} | XO-1 = yellow | XO-1.5 = grey }}
{{ #switch: {{{model}}} | XO-1 = yellow | XO-1.5 = grey | XO-1.75 = grey }}
blocks. It will take about
blocks. It will take about
{{ #switch: {{{model}}} | XO-1 = five | XO-1.5 = ten }}
{{ #switch: {{{model}}} | XO-1 = five | XO-1.5 = ten | XO-1.75 = five }}
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. | XO-1.75 = may be rebooted using the ''boot'' command or the power button.}}}}
}}
The USB drive can be used on other laptops.


The USB or SD drive can be used on other laptops.
{{ #switch: {{{signed}}} | yes =

If you see a message ''Boot failed'' then either:
{{ #switch: {{{signed}}} | yes = 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]]).
| no = Please report any ''Boot failed'' messages.}}

{{ #switch: {{{model}}} | XO-1 = There are no other build sizes for XO-1.
| XO-1.5 = The above instructions assume that you are installing onto a 4 GB internal microSD card. For the 2 GB version, use the
[{{{path}}}/os{{{build}}}.zd2 os{{{build}}}.zd2] file, and for the 8 GB version, use the
[{{{path}}}/os{{{build}}}.zd8 os{{{build}}}.zd8] file. The downloads are roughly the same size.

If you have laptops of different sizes, check out [http://lists.laptop.org/pipermail/devel/2012-March/034598.html How to avoid downloading multiple sizes of a build for a set of XO-1.5 where the microSD or SD card size varies].
| XO-1.75 =
The above instructions assume that you are installing onto a 4 GB internal eMMC. For the 8 GB version, use the
[{{{path}}}/os{{{build}}}.zd8 os{{{build}}}.zd8] {{ #switch: {{{signed}}} | yes = and [{{{path}}}/os{{{build}}}.zd8.zsp.fs.zip os{{{build}}}.zd8.zsp.fs.zip] files.
| no = file.
}}


If you have many laptops of different sizes, check out [http://lists.laptop.org/pipermail/devel/2012-March/034598.html How to avoid downloading multiple sizes of a build], which applies equally to XO-1.75.
{{ #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.
}}
}}

Latest revision as of 23:29, 8 July 2012

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, XO-1.5 or XO-1.75, case is significant)
  • build: BUILD (which build, e.g., 206)
  • ubifs: UBIFS (yes or no)
  • 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}}}.], see How to Download,
    • 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.