Testing Update.1

From OLPC
Revision as of 16:13, 24 March 2008 by Cjb (talk | contribs)
Jump to: navigation, search

As of build candidate-699, activities are no longer bundled with the core build -- they must be installed separately. This page attempts to describe the motivation for the change, and how to get your activities back.

Motivation

OLPC has many deployments, as well as the G1G1 user community, and can't afford to create a build for each deployment. Instead, OLPC will create a "core build" without activities that allows for easy customization of which resources (activities, content bundles) will be installed alongside it. The mechanism for performing this customization is the Customization key.

I ran olpc-update to an update.1 build; how do I get my activities back?

You can download the G1G1_Activity_Pack, unzip it onto a USB key, and reboot with the X game key held down. Linux will boot and unpack each of the bundles into place.

What's the recommended way to upgrade?

Using a USB key, you can install both a new core build and an activity pack at the same time; this involves unpacking both the G1G1_Activity_Pack and a Customization key onto the same USB key.

Upgrading an secure/insecure machine

"Secure" machines without developer keys will boot a customization key at startup without any intervention. "Insecure" machines with a developer key installed require the X game key to be held at boot to boot a customization key.

Which builds are signed, and why does it matter?

There are three streams for update.1 builds -- "update.1", "candidate", and "release". The first two are signed, the last isn't. The workflow is:

  • Update.1 builds are created (for example, "update.1-699"), and if they pass testing such that they're an improvement over previous candidates, they become a signed "candidate" build.
  • Candidate builds are represented in the form "candidate-699", and are our latest proposed final build for a release.
  • Release builds are builds that have been passed to Quanta for installation on new laptops. Notwithstanding an Unscheduled software release, we expect only one of these builds per release cycle.

Creating your own activity pack

The create-customization-key Python script will create a customization key for G1G1 (or Mexico, or Peru, or "all"). You should first unpack a customization key image on to a USB disk, and then in the root of the USB disk:

python create-customization-key G1G1