Sugar-update

From OLPC
Jump to: navigation, search

WARNING: Most command line options seem to be broken at the moment, i.e. the "-s" option produces error

"Could not locate build </body></html>in joyride stream"

This makes the tool useless for reinstalling the latest stable image. It appears that it needs to be updated for new URLs on the laptop.org site.


The sugar-update.py script automates the steps for creating an Autoreinstallation image. This is a Python script, and as such requires Python to run.

Usage 
sugar-update.py [-cdflLqs] [-s stream] [-b build] [directory]
Description 
This script will create an autoinstallation image boot directory within the specified directory. If the boot directory already exists, it will only download the necessary image files (.img, .crc, and .rom). Any of these files already present within this boot directory will be deleted before the download begins. If no directory is specified, the current working directory will be used.
This script has also has automatic support for downgrades, and will add the necessary force.os file to the boot directory if the build image already present there is newer than the build specified.
Options 
-b    Specify a build number; defaults to latest development build
-c    Create a clean auto-installation image, replacing existing boot directory
-d    Force downgrade image; implicit when a newer build exists in boot
-f    Skip firmware update
-l    Print the associated change log
-L    Print the change log for the specified build and quit
-q    Quiet; do not print progress output
-s    Download the latest stable build; overrides the -b option
-S    Specify the stream to pull a build from
Examples 
If you're creating a boot directory from scratch, you'll simply want to use:
      sugar-update.py /path/to/USBdrive/
By adding the -s flag to the above, the latest stable image will be prepared instead:
      sugar-update.py -s /path/to/USBdrive/
For frequent updates it's useful to show the change log for the new builds:
      sugar-update.py -l /path/to/USBdrive/