Changes

== Build host requirements ==

== Build host requirements ==

The Dextrose build system runs on '''Fedora 11 i386''' through '''Fedora 13 x86_64''' ('''Fedora 14 beta''' can be used also). The host system runs '''shouldn't''' matter, because the build runs in a chroot environment. olpc-os-builder does not yet run on Ubuntu due to a missing dependency.

The Dextrose build system runs on '''Fedora 11 i386''' through '''Fedora 14 x86_64'''. What the host system runs '''shouldn't''' matter, because the build runs in a chroot environment. olpc-os-builder does not yet run on Ubuntu due to a missing dependency (bitfrost).

The initial build requires about '''700MB''' of rpm packages and Sugar activity bundles. The packages and bundles are cached for futures builds.

The initial build requires about '''700MB''' of rpm packages and Sugar activity bundles. The packages and bundles are cached for futures builds.

   make

   make

* Generate initial sequence number for the builds (42 is just for an example)

* Generate initial sequence number for the builds (42 is just an example)

   echo 42 >buildnr-dx

   echo 42 >buildnr-dx

== Creating a build ==

== Creating a build ==

* Run the Build (again you need to be root to able to do this)

* Run the build system as root:

   time ./osbuilder.py examples/dextrose2-xo1.ini

   time sudo ./osbuilder.py examples/dextrose2-xo1.ini

obviusly you can use sudo if your user is configured to do this, and the you can use this

(if <code>sudo</code> isn't configured for your user, become root beforehand)

  time ./osbuilder.py examples/dextrose2-xo1.ini

The initial build may take several hours, depending on available bandwith.

Subsequent builds will take about 15-20 minutes on average machines.

The initial build may take several hours depending on available bandwith. Subsequent builds will take about 15-20 minutes

Upon completion the new image will be available in <tt>build/output</tt>.

Because several build tools (olpc-os-builder, imgcreate and yum) run chrooted

 

and nested into each other, error output could be misleading or obscure.

Because several build tools, olpc-os-builder, imgcreate and yum, are nested, error output could be misleading or obscure. Before digging into code, you please ask on IRC in case someone has already seen the same problem.

Before digging into code, you can ask on IRC in case someone has already seen the same problem.

== Publishing the images ==

== Publishing the images ==