Setting tag linux-2.6-32-17
[build.git] / README-pldistros.txt
1 We've tried to isolate the distro-dependent configurations from the code
2
3 Most of the .pgks files are optional to define a new distro:
4 missing files are searched in the planetlab distro
5
6 ========== build environment
7 ./build/<pldistro>.mk
8         that defines the contents of the build -- see Makefile
9 ./build/<pldistro>-tags.mk
10         that defines the svn locations of the various modules
11 ./build/<pldistro>-install.mk
12         optional make file to define the install target
13
14 ========== kernel config
15 ./Linux-2.6/configs/kernel-2.6.<n>-<arch>-<pldistro>.config
16         (subject to change location in the future)
17
18 ========== various system images
19 ./build/config.<pldistro>/devel.pkgs
20         set of packages required for building
21 ./build/config.<pldistro>/bootcd.pkgs
22         contents of the bootcd image
23 ./build/config.<pldistro>/bootstrapfs.pkgs
24         the standard contents of the node root 
25         used to generate yumgroups.xml
26 ./build/config.<pldistro>/bootstrapfs.pkgs
27         specification for the contents of the core for the node
28         software
29         this results in a tarball (tar.bz2) 
30 ./build/config.<pldistro>/bootstrapfs-*.pkgs
31         each of these files results in an extension tarball
32 ./build/config.<pldistro>/myplc.pkgs
33         contents of the myplc image
34 ./build/config.<pldistro>/vserver.pkgs
35         the contents of the standard vserver reference image
36 ./build/config.<pldistro>/vserver-*.pkgs
37         all *.pkgs files here - produce additional vserver images
38 ./build/config.<pldistro>/vtest.pkgs
39         used to create test vservers for myplc-native
40
41 === extensions
42 as of this writing extensions are managed as follows:
43 - at node installation, the tarball produced from bootstrapfs.pkgs is
44 downloaded and untared to produce the core node setup
45 - then we attempt to install an extension corresponding to each of the
46 nodegroups that the node is part of
47 - the first method is to try and download a tarball named after the
48 extension. such tarballs are produced by the build from a .pkgs file,
49 see above
50 - if that fails, then the extension install is attempted through a
51  yum groupinstall  extension<nodegroup>
52