Template:Software Install3: Difference between revisions

From OLPC
Jump to navigation Jump to search
(Created page with '<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. T…')
 
No edit summary
 
(21 intermediate revisions by 4 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, XO-1.5 or XO-1.75, case is significant)}}}
*model: {{{model|MODEL (XO-1, XO-1.5, XO-1.75, or XO-4 case is significant)}}}
*filename: {{{filename|FILENAME (e.g. 21014o1)}}}
*filename: {{{filename|FILENAME (e.g. 21014o1)}}}
*build: {{{build|BUILD (which build, e.g., 206)}}}
*build: {{{build|BUILD (which build, e.g., 206)}}}
Line 24: Line 24:
| 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]] or [[Secure Digital card]] 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. We recommend the drive be FAT formatted, but other formats are supported, see [[Firmware/Storage/Formats|how to prepare a drive for use by the firmware]] for more details.


'''ALL USER DATA WILL BE ERASED FROM THE LAPTOP!'''
'''ALL USER DATA WILL BE ERASED FROM THE LAPTOP!'''
Line 33: Line 32:
*Prepare the USB or SD drive:
*Prepare the USB or SD drive:
**Download [{{{path}}}/{{{filename}}}.{{ #switch: {{{model}}} | XO-1 = img | zd }} {{{filename}}}.{{ #switch: {{{model}}} | XO-1 = img | zd }}], see [[Download#How_to_Download|How to Download]],
**Download [{{{path}}}/{{{filename}}}.{{ #switch: {{{model}}} | XO-1 = img | zd }} {{{filename}}}.{{ #switch: {{{model}}} | XO-1 = img | zd }}], see [[Download#How_to_Download|How to Download]],
**Save the file to the top directory of the drive, {{ #ifeq: {{{signed}}} | yes |
**Save the file to the top directory of the drive,
{{ #switch: {{{signed}}} | yes =
**Download [{{{path}}}/{{{filename}}}.fs{{ #switch: {{{model}}} | XO-1 = 0 | XO-1.5 = 1 | XO-1.75 = 2}}.zip {{{filename}}}.fs{{ #switch: {{{model}}} | XO-1 = 0 | XO-1.5 = 1 | XO-1.75 = 2}}.zip],
**Download [{{{path}}}/fs{{ #switch: {{{model}}} | XO-1 = 0 | XO-1.5 = 1 | XO-1.75 = 2 | XO-4 = 4 }}.zip fs{{ #switch: {{{model}}} | XO-1 = 0 | XO-1.5 = 1 | XO-1.75 = 2 | XO-4 = 4 }}.zip],
**Save the file to the top directory of the same drive,
**Save the file to the top directory of the same drive,
**Rename the file to fs{{ #switch: {{{model}}} | XO-1 = 0 | XO-1.5 = 1 | XO-1.75 = 2}}.zip, (removing the {{{filename}}}.{{ #switch: {{{model}}} | XO-1 = 0 | XO-1.5 = 1 | XO-1.75 = 2}} part of the name),
**Check that the drive contains at least the two files fs{{ #switch: {{{model}}} | XO-1 = 0 | XO-1.5 = 1 | XO-1.75 = 2 | XO-4 = 4 }}.zip and {{{filename}}}.{{ #switch: {{{model}}} | XO-1 = img | zd }}.
}}
**Check that the drive contains at least the two files fs{{ #switch: {{{model}}} | XO-1 = 0 | XO-1.5 = 1 | XO-1.75 = 2}}.zip and {{{filename}}}.{{ #switch: {{{model}}} | XO-1 = img | zd }}.

*Prepare the laptop:
*Prepare the laptop:
**Make a copy of any data you wish to keep, {{ #ifeq: {{{signed}}} | no |
**Make a copy of any data you wish to keep, {{ #ifeq: {{{signed}}} | no |
**Obtain a [[Developer key]] and disable security, }}
**Obtain a [[Developer key]] and disable security, }}
**Check the battery is inserted and locked,
**Check that the battery is inserted and locked,
**Check that the power cord is in place and the battery indicator is green,
**Check that the power cord is in place and the battery indicator is green,
**[[Shutdown|Turn off]] the laptop, unless it is already off,
**[[Shutdown|Turn off]] the laptop, unless it is already off,
Line 49: Line 48:
*Start installing:
*Start installing:
{{ #switch: {{{signed}}} | yes =
{{ #switch: {{{signed}}} | yes =
**Hold down all four game keys above the power button (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 56: Line 55:
**Obtain the [[Ok]] prompt,
**Obtain the [[Ok]] prompt,
**Type the command: (If you are using an SD card, substitute sd:\ for u:\ below.)
**Type the command: (If you are using an SD card, substitute sd:\ for u:\ below.)
{{ #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}}}}
{{ #switch: {{{model}}} | XO-1 = copy-nand u:\{{{filename}}}.img | XO-1.5 = fs-update u:\{{{filename}}}.zd | XO-1.75 = fs-update u:\{{{filename}}}.zd | XO-4 = fs-update u:\{{{filename}}}.zd | #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 | XO-1.75 = grey }}
{{ #switch: {{{model}}} | XO-1 = yellow | XO-1.5 = grey | XO-1.75 = grey | XO-4 = grey }}
blocks. It will take about
blocks. It will take about
{{ #switch: {{{model}}} | XO-1 = five | XO-1.5 = ten | XO-1.75 = five }}
{{ #switch: {{{model}}} | XO-1 = five | XO-1.5 = ten | XO-1.75 = five | XO-4 = five }}
minutes. Once finished,
minutes. Once finished,
{{ #switch: {{{signed}}}
{{ #switch: {{{signed}}}
| yes = the laptop will reboot automatically. You may remove the USB or SD 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. 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.}}}}
| 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. | may be rebooted using the ''boot'' command or the power button.}}}}


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

If installation progress is not displayed, you may be running an old firmware version which does not recognise the fs{{ #switch: {{{model}}} | XO-1 = 0 | XO-1.5 = 1 | XO-1.75 = 2 | XO-4 = 4}}.zip file. Please rename <tt>fs{{ #switch: {{{model}}} | XO-1 = 0 | XO-1.5 = 1 | XO-1.75 = 2 | XO-4 = 4 }}.zip</tt> to <tt>fs.zip</tt> and try again.
}}
{{ #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 or SD drive has not been properly prepared, or;
*the USB or SD drive has not been properly prepared, or;

Latest revision as of 01:30, 18 November 2015

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, XO-1.75, or XO-4 case is significant)
  • filename: FILENAME (e.g. 21014o1)
  • 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, and from "Software Install2" in that it uses one .zd file and uses the "filename" option rather than harcoded "osX" filenames.

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. We recommend the drive be FAT formatted, but other formats are supported, see how to prepare a drive for use by the firmware for more details.

ALL USER DATA WILL BE ERASED FROM THE LAPTOP!

  • Prepare the USB or SD drive:
    • Download [{{{path}}}/{{{filename}}}.zd {{{filename}}}.zd], 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 that 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.


Retrieved from "http://wiki.laptop.org/mediawiki/index.php?title=Template:Software_Install3&oldid=298152"