1 Notes on using this build
3 The PlanetLab builds has the concept of a 'distribution' that allows
4 advanced user to customize the contents of the build. If you're not
5 an advanced user, please just use the regular 'planetlab'
8 If you want to take advantage of a custom distribution, see
9 README-pldistros.txt for further details. Please feel free to contact
10 devel@planet-lab.org, as all this is not precisely foolproof :)
13 * install a vserver-enabled kernel and util-vserver on your build box
14 * create a local fedora mirror - see vbuild-fedora-mirror.sh
15 * create a vserver - see vbuild-initvm.sh
16 * enter the vserver and retrieve this build module into /build using git
18 # make stage1=true PLDISTRO=<yourdistro>
23 * the nightly build script wraps all this in a rather complicated way
24 it is not intended to be used as is without a few manual tweaks on your
27 ** recreates a fresh build vserver named after the arguments
28 ** enters this to perform the actual build
29 ** pushes the results to a web location so the tests can pull the
31 ** invokes a runtest on a separate machine
32 ** manages logs - that's the trickiest part, so the root context and
33 the vserver add their logs on the same file
36 * always run the stage1 make prior to anything else
37 * if you clean or patch a spec file you need to run the stage1 again
38 * see make help for how to do things incrementally
40 * typically if you want to test a change without commiting first, you
42 ** make package-codebase
43 ** patch CODEBASE/module/
46 if further changes are needed, then do
47 ** make package-clean-tarball package-clean-build package-clean-rpm
48 so the codebase remains intact, patch it again and run