Docs: new README.schroot-setup

diff --git a/debian/changelog b/debian/changelog
index 34a1ffae7b5e518c6e89fe6c735371823c6d39a3..ccbeb80b64d6446b94291f1296cebe7a4825d94d 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,4 +1,4 @@
-autopkgtest (2.0.0) unstable; urgency=low
+autopkgtest (2.0.0~~0) unstable; urgency=low
 
   * Incompatible test declaration spec changes:
      - no-build-needed is now the default; build-needed is a Restriction
@@ -6,12 +6,13 @@ autopkgtest (2.0.0) unstable; urgency=low
   * Incompatible virtualisation server spec changes:
      - print-execute-command replaced by print-{auxverb,shscript}-command.
      - "revert" capability split into "revert" and "revert-full-system"
-  * New adt-virt-schroot for driving schroot.
+  * New adt-virt-schroot for driving schroot.  Sorry, no manpage yet.
+  * New README.schroot-setup.
   * Remove dependency on python in testbed.
   * Spec wording improvements, clarifications, editorial changes, etc.
   * Many bugfixes.
 
- --
+ -- Ian Jackson <ijackson@chiark.greenend.org.uk>  Sat, 30 Jul 2011 15:44:15 +0100
 
 autopkgtest (1.2.0~) unstable; urgency=low
 

diff --git a/doc/README.schroot-setup b/doc/README.schroot-setup
new file mode 100644 (file)
index 0000000..5ff6d6a
--- /dev/null
+++ b/doc/README.schroot-setup
@@ -0,0 +1,48 @@
+This file is a quick summary of how to get autopkgtest working with
+schroot-mediated lvm snapshots.
+
+1. Install schroot and make sure you have an LVM VG with enough space
+   In what follows replace "vg-liberator" with that VG name
+
+2. Create a suitable LVM LV (10Gish?) called "schroot-wheezy"
+
+3. Fill that LV with an install:
+  mkfs -t ext3 /dev/vg-liberator/schroot-wheezy
+  mkdir /volatile/chroots/adt/wheezy
+  mount /dev/vg-liberator/schroot-wheezy /volatile/chroots/adt/wheezy
+  http_proxy=http://proxy.dc11.debconf.org:3128/ really debootstrap \
+    wheezy /volatile/chroots/adt/wheezy http://ftp.ba.debian.org/debian/
+  umount /volatile/chroots/adt/wheezy
+
+4. Put this in /etc/schroot/schroot.conf:
+
+  [wheezy-snap]
+  type=lvm-snapshot
+  description=Debian wheezy LVM snapshot
+  groups=root,ian
+  root-users=ian
+  root-groups=root,ian
+  source-root-users=ian
+  device=/dev/vg-liberator/schroot-wheezy
+  mount-options=-o atime,sync,user_xattr
+  lvm-snapshot-options=--size 10G
+  script-config=minimal/config
+
+5. Optionally add some stuff to the source schroot.  This is not needed
+   but can make things faster, particularly on slow hardware or with
+   only a distant mirror.
+  schroot -u root -c wheezy-snap-source \
+    apt-get install dpkg-dev build-essential
+
+5. Download the mawk source with tests from here:
+  http://packages.ubuntu.com/hardy/mawk
+
+6. Clone autopkgtest, and you can do this
+      cd autopkgtest.git/runner
+      mkdir tmp
+      AUTOPKGTEST_BASE=.. ./adt-run --tmp-dir=`pwd`/tmp -d \
+        ../../Mawk/ancient/mawk_1.3.3-11ubuntu2.dsc --- \
+        ../virt-subproc/adt-virt-schroot wheezy-snap
+   Or install autopkgtest.deb and run
+       adt-run ../../Mawk/ancient/mawk_1.3.3-11ubuntu2.dsc --- \
+        adt-virt-schroot wheezy-snap