Commits

stacklet committed 93c5cf2

Reorganized the section on building images

Comments (0)

Files changed (1)

 
 
 Output:
-The output of this run will be a 1GB file containing a 32-bit CentOS 5.3 image in
+The output of this run will be a 10GB file containing a 32-bit CentOS 5.3 image in
 /var/stacklet/centos.5-3.x86.img
 
 This image can be mounted as a loop device or run under Xen.  For convenience there
 
 Properties:
 Each spec file has certain parameters that can be overridden at runtime.
-For instance, by default the CentOS image will be 1GB.  However, this value is not
+For instance, by default the CentOS image will be 10GB.  However, this value is not
 hard-coded into the spec, it is stored in a file called
   /usr/share/stacklet/specs/distro/centos/properties.xml
 
 system type of the image and output directory as well.
 
 
-IV. More Examples
-  All of the following examples have been run successfully under CentOS 5.3.
-  All of the images have been tested under Xen 3.
+IV. Building the Various Images
 
-  CentOS 5.3, 32 & 64-bit (note command line overrides on 64-bit build)
-    stackfactory /usr/share/stacklet/specs/distro/centos/centos.5-3.x86.xml
-    stackfactory /usr/share/stacklet/specs/distro/centos/centos.5-3.x86.xml _bootstrap.url_=http://pubmirrors.reflected.net/centos/5.3/os/x86_64/CentOS/ _image.imgFile_=/var/stacklet/centos.5-3.x86-64.img _build.assetLoc_=assets/centos.5-3.x86-64
+  32-bit Image Builds
 
-    QEMU/VMDK:
-    stackfactory /usr/share/stacklet/specs/distro/centos/centos.5-3.x86.qemu.xml _image.format_=raw _image.imgFile_=/var/stacklet/centos.5-3.x86.qemu.img
+    CentOS 5.3
+      Xen
+        stackfactory /usr/share/stacklet/specs/distro/centos/centos.5-3.x86.xml
+      QEMU/VMDK (*)
+        stackfactory /usr/share/stacklet/specs/distro/centos/centos.5-3.x86.qemu.xml _image.format_=raw _image.imgFile_=/var/stacklet/centos.5-3.x86.qemu.img
+
+    Debian 5
+      Xen
+        stackfactory /usr/share/stacklet/specs/distro/debian/debian.5-0.x86.xml
+      QEMU/VMDK
+        stackfactory /usr/share/stacklet/specs/distro/debian/debian.5-0.x86.qemu.xml _image.format_=raw _image.imgFile_=/var/stacklet/debian.5-0.x86.qemu.img _image.kernel_=linux-image-686
+
+    Fedora 11
+      Xen
+        stackfactory /usr/share/stacklet/specs/distro/fedora/fedora.11.x86.xml
+      QEMU/VMDK (*)
+        stackfactory /usr/share/stacklet/specs/distro/fedora/fedora.11.x86.qemu.xml  _image.format_=raw _image.imgFile_=/var/stacklet/fedora.11.x86.qemu.img
+
+    Gentoo 2008.0
+      Xen
+        stackfactory /usr/share/stacklet/specs/distro/gentoo/gentoo.2008-0.x86.xml
+      QEMU/VMDK (*)
+        stackfactory /usr/share/stacklet/specs/distro/gentoo/gentoo.2008-0.x86.qemu.xml _image.format_=raw _image.imgFile_=/var/stacklet/gentoo.2008-0.x86.qemu.img
+
+    Mandriva 2009-1
+      Xen
+        stackfactory /usr/share/stacklet/specs/distro/mandriva/mandriva.2009-1.x86.xml
+      QEMU/VMDK (*)
+        stackfactory /usr/share/stacklet/specs/distro/mandriva/mandriva.2009-1.x86.qemu.xml _image.format_=raw _image.imgFile_=/var/stacklet/mandriva.2009-1.x86.qemu.img _build.assetLoc_=assets/mandriva.2009-1.x86 _image.kernel_=kernel-server-latest
+
+    Slackware 13-0
+      Xen (optional second command recompiles slackware's glibc for xen compatibility)
+        stackfactory /usr/share/stacklet/specs/distro/slackware/slackware.13-0.x86.xml
+        stackfactory /usr/share/stacklet/specs/distro/slackware/slackware.13-0.x86.recompileGlibc.xml
+      QEMU/VMDK (*)
+        stackfactory /usr/share/stacklet/specs/distro/slackware/slackware.13-0.x86.qemu.xml  _image.format_=raw _image.imgFile_=/var/stacklet/slackware.13-0.x86.qemu.img
+
+    Ubuntu 9
+      Xen
+        stackfactory /usr/share/stacklet/specs/distro/ubuntu/ubuntu.9-04.x86.xml
+      QEMU/VMDK (*)
+        stackfactory /usr/share/stacklet/specs/distro/ubuntu/ubuntu.9-04.x86.qemu.xml  _image.format_=raw _image.imgFile_=/var/stacklet/ubuntu.9-04.x86.qemu.img
+
+
+  64-Bit Image Builds
+
+    CentOS 5.3
+      Xen
+        stackfactory /usr/share/stacklet/specs/distro/centos/centos.5-3.x86.xml _bootstrap.url_=http://pubmirrors.reflected.net/centos/5.3/os/x86_64/CentOS/ _image.imgFile_=/var/stacklet/centos.5-3.x86-64.img _build.assetLoc_=assets/centos.5-3.x86-64
+      QEMU/VMDK (*)
+        stackfactory /usr/share/stacklet/specs/distro/centos/centos.5-3.x86.qemu.xml _bootstrap.url_=http://pubmirrors.reflected.net/centos/5.3/os/x86_64/CentOS/ _image.imgFile_=/var/stacklet/centos.5-3.x86-64.qemu.img _build.assetLoc_=assets/centos.5-3.x86-64 _image.format_=raw
+
+    Debian 5
+      Xen
+        stackfactory /usr/share/stacklet/specs/distro/debian/debian.5-0.x86.xml _image.imgFile_=/var/stacklet/debian.5-0.x86-64.img _image.kernel_=linux-image-xen-amd64 _build.assetLoc_=assets/debian.5-0.amd64
+      QEMU/VMDK (*)
+        stackfactory /usr/share/stacklet/specs/distro/debian/debian.5-0.x86.qemu.xml  _image.format_=raw _image.imgFile_=/var/stacklet/debian.5-0.x86-64.qemu.img _image.kernel_=linux-image-amd64 _build.assetLoc_=assets/debian.5-0.amd64
+
+    Fedora 11
+      Xen
+        stackfactory /usr/share/stacklet/specs/distro/fedora/fedora.11.x86.xml _bootstrap.url_=http://mirrors.reflected.net/fedora/linux/releases/11/Fedora/x86_64/os/Packages/ _image.imgFile_=/var/stacklet/fedora.11.x86-64.img  _build.assetLoc_=assets/fedora.11.x86-64
+      QEMU/VMDK (*)
+        stackfactory /usr/share/stacklet/specs/distro/fedora/fedora.11.x86.qemu.xml  _image.format_=raw _bootstrap.url_=http://mirrors.reflected.net/fedora/linux/releases/11/Fedora/x86_64/os/Packages/ _image.imgFile_=/var/stacklet/fedora.11.x86-64.qemu.img  _build.assetLoc_=assets/fedora.11.x86-64
+
+    Gentoo 2008.0
+      Xen
+        stackfactory /usr/share/stacklet/specs/distro/gentoo/gentoo.2008-0.x86.xml _bootstrap.arch_=amd64 _image.imgFile_=/var/stacklet/gentoo.2008-0.x86-64.img _xen.xernel_=linux-2.6-xenU.x86-64.tar.bz2
+      QEMU/VMDK (*)
+        stackfactory /usr/share/stacklet/specs/distro/gentoo/gentoo.2008-0.x86.qemu.xml _image.format_=raw  _bootstrap.arch_=amd64 _image.imgFile_=/var/stacklet/gentoo.2008-0.x86-64.qemu.img _image.size_=8000
+
+    Mandriva 2009-1
+      Xen
+        stackfactory /usr/share/stacklet/specs/distro/mandriva/mandriva.2009-1.x86.xml  _bootstrap.url_=http://mirrors.kernel.org/mandrake/Mandrakelinux/official/2008.1/x86_64/ _image.imgFile_=/var/stacklet/mandriva.2009-1.x86-64.img _build.assetLoc_=assets/mandriva.2009-1.x86-64 _mirror.list_=http://api.mandriva.com/mirrors/basic.2009.1.x86_64.list
+      QEMU/VMDK (*)
+        stackfactory /usr/share/stacklet/specs/distro/mandriva/mandriva.2009-1.x86.qemu.xml _image.format_=raw  _bootstrap.url_=http://mirrors.kernel.org/mandrake/Mandrakelinux/official/2008.1/x86_64/ _image.imgFile_=/var/stacklet/mandriva.2009-1.x86-64.qemu.img _build.assetLoc_=assets/mandriva.2009-1.x86-64 _mirror.list_=http://api.mandriva.com/mirrors/basic.2009.1.x86_64.list _image.kernel_=kernel-server-latest
+
+    Slackware 13-0
+      Xen
+        stackfactory /usr/share/stacklet/specs/distro/slackware/slackware.13-0.x86.xml _bootstrap.repository_=slackware64 _bootstrap.url_=http://slackware.oregonstate.edu/slackware64-13.0/ _xen.xernel_=linux-2.6-xenU.x86-64.tar.bz2 _image.imgFile_=/var/stacklet/slackware.13-0.x86-64.img _build.assetLoc_=assets/slackware.13-0.x86-64
+      QEMU/VMDK (*)
+        stackfactory /usr/share/stacklet/specs/distro/slackware/slackware.13-0.x86.qemu.xml _image.format_=raw _image.imgFile_=/var/stacklet/slackware.13-0.x86-64.qemu.img _bootstrap.repository_=slackware64 _bootstrap.url_=http://slackware.oregonstate.edu/slackware64-13.0/ _build.assetLoc_=assets/slackware.13-0.x86-64
+
+    Ubuntu 9
+      Xen
+        stackfactory /usr/share/stacklet/specs/distro/ubuntu/ubuntu.9-04.x86.xml _image.imgFile_=/var/stacklet/ubuntu.9-04.x86-64.img _xen.xernel_=linux-2.6-xenU.x86-64.tar.bz2  _build.assetLoc_=assets/ubuntu.9-04.amd64
+      QEMU/VMDK (*)
+        stackfactory /usr/share/stacklet/specs/distro/ubuntu/ubuntu.9-04.x86.qemu.xml  _image.format_=raw _image.imgFile_=/var/stacklet/ubuntu.9-04.x86-64.qemu.img  _build.assetLoc_=assets/ubuntu.9-04.amd64
+
+  (*) Creating the VMDK file from a QEMU raw file
+  The stackfactory code does not directly output vmdk files at present.
+  Use 'qemu-img convert' to create the vmdk file after first building the
+  corresponding qemu image using stackfactory, eg:
+
     qemu-img convert -f raw centos.5-3.x86.qemu.img -O vmdk centos.5-3.x86.vmdk
 
-    64-bit:
-    stackfactory /usr/share/stacklet/specs/distro/centos/centos.5-3.x86.qemu.xml _bootstrap.url_=http://pubmirrors.reflected.net/centos/5.3/os/x86_64/CentOS/ _image.imgFile_=/var/stacklet/centos.5-3.x86-64.qemu.img _build.assetLoc_=assets/centos.5-3.x86-64 _image.format_=raw
-
-  Fedora 11, 32 & 64-bit (note command line overrides on 64-bit build)
-    stackfactory /usr/share/stacklet/specs/distro/fedora/fedora.11.x86.xml
-    stackfactory /usr/share/stacklet/specs/distro/fedora/fedora.11.x86.xml _bootstrap.url_=http://mirrors.reflected.net/fedora/linux/releases/11/Fedora/x86_64/os/Packages/ _image.imgFile_=/var/stacklet/fedora.11.x86-64.img  _build.assetLoc_=assets/fedora.11.x86-64
-
-    QEMU/VMDK
-    stackfactory /usr/share/stacklet/specs/distro/fedora/fedora.11.x86.qemu.xml  _image.format_=raw _image.imgFile_=/var/stacklet/fedora.11.x86.qemu.img
-    qemu-img convert -f raw fedora.11.x86.qemu.img -O vmdk fedora.11.x86.vmdk
-
-    64-bit
-    stackfactory /usr/share/stacklet/specs/distro/fedora/fedora.11.x86.qemu.xml  _image.format_=raw _bootstrap.url_=http://mirrors.reflected.net/fedora/linux/releases/11/Fedora/x86_64/os/Packages/ _image.imgFile_=/var/stacklet/fedora.11.x86-64.qemu.img  _build.assetLoc_=assets/fedora.11.x86-64
-
-  Mandriva 2009-1, 32 & 64-bit (note command line overrides on 64-bit build)
-    stackfactory /usr/share/stacklet/specs/distro/mandriva/mandriva.2009-1.x86.xml
-    stackfactory /usr/share/stacklet/specs/distro/mandriva/mandriva.2009-1.x86.xml  _bootstrap.url_=http://mirrors.kernel.org/mandrake/Mandrakelinux/official/2008.1/x86_64/ _image.imgFile_=/var/stacklet/mandriva.2009-1.x86-64.img _build.assetLoc_=assets/mandriva.2009-1.x86-64 _mirror.list_=http://api.mandriva.com/mirrors/basic.2009.1.x86_64.list
-
-    QEMU/VMDK
-    stackfactory /usr/share/stacklet/specs/distro/mandriva/mandriva.2009-1.x86.qemu.xml _image.format_=raw _image.imgFile_=/var/stacklet/mandriva.2009-1.x86.qemu.img _build.assetLoc_=assets/mandriva.2009-1.x86 _image.kernel_=kernel-server-latest
-    stackfactory /usr/share/stacklet/specs/distro/mandriva/mandriva.2009-1.x86.qemu.xml _image.format_=raw  _bootstrap.url_=http://mirrors.kernel.org/mandrake/Mandrakelinux/official/2008.1/x86_64/ _image.imgFile_=/var/stacklet/mandriva.2009-1.x86-64.qemu.img _build.assetLoc_=assets/mandriva.2009-1.x86-64 _mirror.list_=http://api.mandriva.com/mirrors/basic.2009.1.x86_64.list _image.kernel_=kernel-server-latest
-    qemu-img convert -f raw mandriva.2009-1.x86.qemu.img -O vmdk mandriva.2009-1.x86.vmdk
-
-
-  Slackware 13-0 (optional second command recompiles glibc for xen compatibility)
-    stackfactory /usr/share/stacklet/specs/distro/slackware/slackware.13-0.x86.xml
-    stackfactory /usr/share/stacklet/specs/distro/slackware/slackware.13-0.x86.recompileGlibc.xml
-
-    64-bit
-    stackfactory /usr/share/stacklet/specs/distro/slackware/slackware.13-0.x86.xml _bootstrap.repository_=slackware64 _bootstrap.url_=http://slackware.oregonstate.edu/slackware64-13.0/ _xen.xernel_=linux-2.6-xenU.x86-64.tar.bz2 _image.imgFile_=/var/stacklet/slackware.13-0.x86-64.img _build.assetLoc_=assets/slackware.13-0.x86-64
-    stackfactory /usr/share/stacklet/specs/distro/slackware/slackware.13-0.x86.qemu.xml _image.format_=raw _image.imgFile_=/var/stacklet/slackware.13-0.x86-64.qemu.img _bootstrap.repository_=slackware64 _bootstrap.url_=http://slackware.oregonstate.edu/slackware64-13.0/ _build.assetLoc_=assets/slackware.13-0.x86-64
-
-    QEMU/VMDK
-    stackfactory /usr/share/stacklet/specs/distro/slackware/slackware.13-0.x86.qemu.xml  _image.format_=raw _image.imgFile_=/var/stacklet/slackware.13-0.x86.qemu.img
-    qemu-img convert -f raw slackware.13-0.x86.qemu.img -O vmdk slackware.13-0.x86.vmdk
-
-  Gentoo 2008-0, 32-bit
-    stackfactory /usr/share/stacklet/specs/distro/gentoo/gentoo.2008-0.x86.xml
-
-  Gentoo 2008-0, 64-bit
-    stackfactory /usr/share/stacklet/specs/distro/gentoo/gentoo.2008-0.x86.xml _bootstrap.arch_=amd64 _image.imgFile_=/var/stacklet/gentoo.2008-0.x86-64.img _xen.xernel_=linux-2.6-xenU.x86-64.tar.bz2
-
-  Debian 5, 32 & 64-bit (note command line overrides on 64-bit build)
-    stackfactory /usr/share/stacklet/specs/distro/debian/debian.5-0.x86.xml
-    stackfactory /usr/share/stacklet/specs/distro/debian/debian.5-0.x86.xml _image.imgFile_=/var/stacklet/debian.5-0.x86-64.img _image.kernel_=linux-image-xen-amd64 _build.assetLoc_=assets/debian.5-0.amd64
-
-    QEMU/VMDK
-    stackfactory /usr/share/stacklet/specs/distro/debian/debian.5-0.x86.qemu.xml  _image.format_=raw _image.imgFile_=/var/stacklet/debian.5-0.x86.qemu.img _image.kernel_=linux-image-686
-
-    stackfactory /usr/share/stacklet/specs/distro/debian/debian.5-0.x86.qemu.xml  _image.format_=raw _image.imgFile_=/var/stacklet/debian.5-0.x86-64.qemu.img _image.kernel_=linux-image-amd64 _build.assetLoc_=assets/debian.5-0.amd64
-    qemu-img convert -f raw debian.5-0.x86-64.qemu.img -O vmdk debian.5-0.x86-64.vmdk
-
-  Ubuntu 9, 32 & 64-bit (note command line overrides on 64-bit build)
-    stackfactory /usr/share/stacklet/specs/distro/ubuntu/ubuntu.9-04.x86.xml
-    stackfactory /usr/share/stacklet/specs/distro/ubuntu/ubuntu.9-04.x86.xml _image.imgFile_=/var/stacklet/ubuntu.9-04.x86-64.img _xen.xernel_=linux-2.6-xenU.x86-64.tar.bz2  _build.assetLoc_=assets/ubuntu.9-04.amd64
-
-    QEMU/VMDK
-    stackfactory /usr/share/stacklet/specs/distro/ubuntu/ubuntu.9-04.x86.qemu.xml  _image.format_=raw _image.imgFile_=/var/stacklet/ubuntu.9-04.x86.qemu.img
-    qemu-img convert -f raw ubuntu.9-04.x86.qemu.img -O vmdk ubuntu.9-04.x86.vmdk
-
-    stackfactory /usr/share/stacklet/specs/distro/ubuntu/ubuntu.9-04.x86.qemu.xml  _image.format_=raw _image.imgFile_=/var/stacklet/ubuntu.9-04.x86-64.qemu.img  _build.assetLoc_=assets/ubuntu.9-04.amd64
+V. Miscellaneous
 
   Proxying: When testing image construction it is often necessary to repeatedly rerun the
   specs.  To minimize downloading of packages, you can setup a squid repository locally
 Contact:
   For bugs, questions, feature requests, etc. please email dfn@stacklet.com
 
-+++
 
-stackfactory /usr/share/stacklet/specs/distro/gentoo/gentoo.2008-0.x86.qemu.xml  _image.format_=raw _image.imgFile_=/var/stacklet/gentoo.2008-0.x86.qemu.img _image.size_=8000
-stackfactory /usr/share/stacklet/specs/distro/gentoo/gentoo.2008-0.x86.qemu.xml  _image.format_=raw  _bootstrap.arch_=amd64 _image.imgFile_=/var/stacklet/gentoo.2008-0.x86-64.qemu.img _image.size_=8000
+