Olpc-update: Difference between revisions

From OLPC
Jump to navigation Jump to search
(Notes on important files in the source repo.)
No edit summary
Line 1: Line 1:
Wiki page name set so that someone else will figure out an appropriate name.
Wiki page name set so that someone else will figure out an appropriate name.


This method of updating from one OS build to another is experimental. It works by transferring only the differences across the internet link to an updates server.
This method of updating from one OS build to another is experimental. It works by transferring only the differences across the internet link from an updates server.

As an example of the data efficiency gain, an autoreinstallation from OS build 602 to 603 would normally take about 279Mb of download data, whereas ''olpc-update'' takes 16Mb of download data.

The time efficiency gain is less easy to characterise. It depends on the speed of the internet link, and whether the autoreinstallation image needs to be downloaded. The ''olpc-update'' from 602 to 603 cost under 17 minutes.


The current updates server is updates.laptop.org.
The current updates server is updates.laptop.org.

----


Usage:
Usage:


*ensure the laptop is able to access the internet,
*be root at a command prompt,
*be root at a command prompt,
*type ''olpc-update NNN'' where NNN is the build number.
*type ''olpc-update NNN'' where NNN is the build number.


----
/usr/sbin/olpc-update


What update targets are available?
Q: What update targets are available?


# rsync rsync://updates.laptop.org | sort
# rsync rsync://updates.laptop.org | sort


----
What is the latest version of the updater?

Q: What is the latest version of the updater?

A: for build 602 and 603, a later development version of the updater is at:


# wget http://dev.laptop.org/~mstone/olpccontents-latest.rpm
# wget http://dev.laptop.org/~mstone/olpccontents-latest.rpm
Line 22: Line 33:
# rpm --upgrade --force olpccontents-latest.rpm rainbow-latest.rpm
# rpm --upgrade --force olpccontents-latest.rpm rainbow-latest.rpm


----
How can I re-use the bits for multiple laptops?

Q: How can I re-use the bits for multiple laptops?


A: this feature is not yet available, but in the meanwhile you can make your own updates server based on the updates available. You will need to change the ''olpc-update'' script. For ideas:
A: this feature is not yet available, but in the meanwhile you can make your own updates server based on the updates available. You will need to change the ''olpc-update'' script. For ideas:
Line 29: Line 42:
# rsync FLAGS rsync://udpates.laptop.org/build-NNN/root/
# rsync FLAGS rsync://udpates.laptop.org/build-NNN/root/


----
Where is the source?

Q: Where is the source?


A: the source repo is http://dev.laptop.org/git/users/mstone/security
A: the source repo is http://dev.laptop.org/git/users/mstone/security


The branch you want is currently called "updater", though this will likely change in the future.
The branch you want is currently called ''updater'', though this will likely change in the future.
There are five important files in the repository. They are:
There are five important files in the repository. They are:

Revision as of 03:54, 26 September 2007

Wiki page name set so that someone else will figure out an appropriate name.

This method of updating from one OS build to another is experimental. It works by transferring only the differences across the internet link from an updates server.

As an example of the data efficiency gain, an autoreinstallation from OS build 602 to 603 would normally take about 279Mb of download data, whereas olpc-update takes 16Mb of download data.

The time efficiency gain is less easy to characterise. It depends on the speed of the internet link, and whether the autoreinstallation image needs to be downloaded. The olpc-update from 602 to 603 cost under 17 minutes.

The current updates server is updates.laptop.org.


Usage:

  • ensure the laptop is able to access the internet,
  • be root at a command prompt,
  • type olpc-update NNN where NNN is the build number.

Q: What update targets are available?

# rsync rsync://updates.laptop.org | sort

Q: What is the latest version of the updater?

A: for build 602 and 603, a later development version of the updater is at:

# wget http://dev.laptop.org/~mstone/olpccontents-latest.rpm
# wget http://dev.laptop.org/~mstone/rainbow-latest.rpm
# rpm --upgrade --force olpccontents-latest.rpm rainbow-latest.rpm

Q: How can I re-use the bits for multiple laptops?

A: this feature is not yet available, but in the meanwhile you can make your own updates server based on the updates available. You will need to change the olpc-update script. For ideas:

# rsync FLAGS rsync://updates.laptop.org/build-NNN/manifest
# rsync FLAGS rsync://udpates.laptop.org/build-NNN/root/

Q: Where is the source?

A: the source repo is http://dev.laptop.org/git/users/mstone/security

The branch you want is currently called updater, though this will likely change in the future. There are five important files in the repository. They are:

rainbow/sbin/olpc-update
rainbow/sbin/olpc-update-rsync
rainbow/rainbow/update.py
rainbow/rainbow/launch/targets/update.py
rainbow/rainbow/launch/stages/update.py