Dextrose/Building: Difference between revisions

Line 5:

== 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.

Line 25:

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

Line 31:

== 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>.

~~Upon completion the new image is available at <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 ==

@@ Line 5: / Line 5: @@
 == 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.
@@ Line 25: / Line 25: @@
    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
@@ Line 31: / Line 31: @@
 == 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>.
-Upon completion the new image is available at <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 ==