X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;f=README-pldistros.txt;h=cdb3fee94fc0390e8e84ad39f2fe52ebaf668f32;hb=refs%2Fheads%2Flxc_devel;hp=5d00617a5656846a7a23a00c38d5a1f7fd4cb7d2;hpb=6a284adbacec8ff3e57728f8223b79f1fe54ff53;p=build.git

diff --git a/README-pldistros.txt b/README-pldistros.txt
index 5d00617a..cdb3fee9 100644
--- a/README-pldistros.txt
+++ b/README-pldistros.txt
@@ -1,22 +1,52 @@
-we've tried to isolate the distro-dependent configurations from the code
-the places where these distro-dependent config files lie are
+We've tried to isolate the distro-dependent configurations from the code
 
-./build/groups/<pldistro>.xml 
-	that is used as the yumgroups.xml 
+Most of the .pgks files are optional to define a new distro:
+missing files are searched in the planetlab distro
+
+========== build environment
 ./build/<pldistro>.mk
-	that defines the contents of the build
+	that defines the contents of the build -- see Makefile
 ./build/<pldistro>-tags.mk
 	that defines the svn locations of the various modules
 ./build/<pldistro>-install.mk
 	optional make file to define the install target
-./build/<pldistro>-devel.lst
+
+========== kernel config
+./Linux-2.6/configs/kernel-2.6.<n>-<arch>-<pldistro>.config
+	(subject to change location in the future)
+
+========== various system images
+./build/config.<pldistro>/devel.pkgs
 	set of packages required for building
+./build/config.<pldistro>/bootcd.pkgs
+	contents of the bootcd image
+./build/config.<pldistro>/bootstrapfs.pkgs
+	the standard contents of the node root 
+	used to generate yumgroups.xml
+./build/config.<pldistro>/bootstrapfs.pkgs
+	specification for the contents of the core for the node
+	software
+        this results in a tarball (tar.bz2) 
+./build/config.<pldistro>/bootstrapfs-*.pkgs
+	each of these files results in an extension tarball
+./build/config.<pldistro>/myplc.pkgs
+	contents of the myplc image
+./build/config.<pldistro>/vserver.pkgs
+	the contents of the standard vserver reference image
+./build/config.<pldistro>/vserver-*.pkgs
+	all *.pkgs files here - produce additional vserver images
+./build/config.<pldistro>/vtest.pkgs
+	used to create test vservers for myplc-native
+
+=== extensions
+as of this writing extensions are managed as follows:
+- at node installation, the tarball produced from bootstrapfs.pkgs is
+downloaded and untared to produce the core node setup
+- then we attempt to install an extension corresponding to each of the
+nodegroups that the node is part of
+- the first method is to try and download a tarball named after the
+extension. such tarballs are produced by the build from a .pkgs file,
+see above
+- if that fails, then the extension install is attempted through a
+ yum groupinstall  extension<nodegroup>
 
-./bootcd/<pldistro>-bootcd.lst
-./bootstrapfs/<pldistro>-base.lst
-./bootstrapfs/<pldistro>-filesystems
-	all *.lst files here - produce tar.bz2 images
-./myplc/<pldistro>-plc.lst
-./vserver/<pldistro>-vserver.lst
-./vserver/<pldistro>-vservers
-	all *.lst files here - produce vserver images