Operating system image installation methods: Difference between revisions

From OLPC
Jump to navigation Jump to search
(Created page with '{| border="1" cellspacing="0" cellpadding="2" width="100%"class="wikitable" |- | XO-1 signed method | requires .img and fs.zip files | hold down the four game pad buttons |- | XO…')
 
No edit summary
 
(13 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<noinclude>[[Category:Update paths]]
⚫
{| border="1" cellspacing="0" cellpadding="2" width="100%"class="wikitable"
</noinclude>
We use a few different methods to install operating system images.

⚫
{| border="1" cellspacing="0" cellpadding="2" width="100%" class="wikitable"
! installation method
! what files are required
! how to install
! references
|-
|-
| XO-1 signed method
| block signed
| requires .img and fs.zip files
| .zd and fs.zip
| hold down the four game pad buttons
| hold down the four game pad buttons and then turn on the laptop
| [[Release notes]]
|-
|-
| XO-1 unsigned method
| block unsigned
⚫
| .zd alone
| requires .img and .crc files
| obtain developer key, disable-security, interrupt boot, then use the ''copy-nand'' command
| check if security is enabled, if so obtain [[Developer_key|developer key]] and [[Developer_key#Disabling_the_security_system|disable-security]], [[Ok|interrupt boot]], then use the ''fs-update'' command
| [[Release notes]]
|-
|-
⚫
| nand signed
⚫
| XO-1 partitioned method
| requires .dat and .img files
| .img and fs.zip
⚫
| hold down the four game pad buttons and then turn on the laptop
⚫
| obtain developer key, disable-security, interrupt boot, then use the ''update-nand'' command
| [[Release notes]] [[Clean-install_procedure#Official_releases_and_candidate_builds|Clean Install Procedure]] [[Nandblaster_for_XO-1]]
|-
|-
⚫
| nand unsigned
⚫
| XO-1.5 signed method
| requires .zd and fs.zip files
| .img and .crc
⚫
| check if security is enabled, if so obtain [[Developer_key|developer key]] and [[Developer_key#Disabling_the_security_system|disable-security]], [[Ok|interrupt boot]], then use the ''copy-nand'' command
⚫
| hold down the four game pad buttons
| [[Release notes]] [[Clean-install_procedure#Development_builds|Clean Install Procedure]] [[Nandblaster_for_XO-1]]
|-
|-
⚫
| nand partitioned<br>
⚫
| XO-1.5 unsigned method
| .dat and .img
⚫
| requires .zd file alone
| check if security is disabled, if so obtain developer key and disable-security, interrupt boot, then use the ''fs-update'' command
| check if security is enabled, if so obtain [[Developer_key|developer key]] and [[Developer_key#Disabling_the_security_system|disable-security]], [[Ok|interrupt boot]], then use the ''update-nand'' command
| Used by [[DebXO]]. Used by [[UBIFS_initial_experiments|UBIFS experiments]]. See also [[OFW_NAND_FLASH_Updater|Technical description]].
|
|}
|}


Note that signed methods are the same for XO-1 and XO-1.5. Intentional design, since we do not wish to increase the training burden for the deployment teams.
The signed installation methods are the same for XO-4, XO-1.75, XO-1.5 and XO-1. This was by design, since we do not wish to increase the training burden for the deployment teams.

A deployment will typically [[OSBuilder#Signing_preparation|sign their builds]] and [[Firmware_security#Adding_Deployment_Keys_to_Manufacturing_Data|inject deployment keys]] at manufacture or on site.

The unsigned installation methods depend on the type of internal storage. XO-1 has raw NAND Flash. XO-1.5, XO-1.75 and XO-4 have microSD or eMMC managed Flash.

See also [[Firmware/Storage]].

Latest revision as of 02:14, 1 January 2014


We use a few different methods to install operating system images.

installation method what files are required how to install references
block signed .zd and fs.zip hold down the four game pad buttons and then turn on the laptop Release notes
block unsigned .zd alone check if security is enabled, if so obtain developer key and disable-security, interrupt boot, then use the fs-update command Release notes
nand signed .img and fs.zip hold down the four game pad buttons and then turn on the laptop Release notes Clean Install Procedure Nandblaster_for_XO-1
nand unsigned .img and .crc check if security is enabled, if so obtain developer key and disable-security, interrupt boot, then use the copy-nand command Release notes Clean Install Procedure Nandblaster_for_XO-1
nand partitioned
 .dat and .img check if security is enabled, if so obtain developer key and disable-security, interrupt boot, then use the update-nand command Used by DebXO. Used by UBIFS experiments. See also Technical description.

The signed installation methods are the same for XO-4, XO-1.75, XO-1.5 and XO-1. This was by design, since we do not wish to increase the training burden for the deployment teams.

A deployment will typically sign their builds and inject deployment keys at manufacture or on site.

The unsigned installation methods depend on the type of internal storage. XO-1 has raw NAND Flash. XO-1.5, XO-1.75 and XO-4 have microSD or eMMC managed Flash.

See also Firmware/Storage.

Retrieved from "http://wiki.laptop.org/mediawiki/index.php?title=Operating_system_image_installation_methods&oldid=294431"