xen/README.userv

   1 Virtualisation service for use via userv
   2 ----------------------------------------
   3
   4 adt-virt-xenlvm supports use of Xen virtual machines and LVM COW via
   5 the userv `security boundary tool'.  By default the files
   6 corresponding to this setup are installed but not enabled.
   7
   8 What is provided to non-root accounts is the ability to start the
   9 testbed and run commands on it (functionality equivalent to
  10 adt-xenlvm-with-testbed and adt-xenlvm-on-testbed) but not the ability
  11 to create new testbeds.
  12
  13 To make this feature available:
  14  * Install userv.
  15  * Create a group named AdtXenUs containing the users which should
  16    be able to manipulate and use the testbed.
  17  * Collect the public ssh key(s) of the user(s) and put them in
  18    /etc/autopkgtest/xenlvm_adt_sshauthkeys (this will allow them
  19    to ssh to root@testbed).
  20  * Run adt-xenlvm-setup.  NB that the contents of the _sshauthkeys
  21    file (above) are copied into the testbed by adt-xenlvm-setup;
  22    any changes mean that setup needs to be run again.
  23
  24 Typically adt-xenlvm-setup ought to be run periodically anyway to
  25 make sure that the snapshot doesn't get too out of date.
  26
  27
  28 Client interface
  29 ----------------
  30
  31 The service is as invoked as
  32   userv [-Ddistro=<distro> -Dnominum=<nominum>] \
  33         [-Dssh_privkey=...|-Dssh_keyident_args=...] \
  34         root adt-xenlvm-testbed <act>
  35 where <act> is one of
  36   with
  37         Starts adt-xenlvm-with-testbed, prints `y', waits for
  38         eof on stdin, and then exits adt-xenlvm-with-testbed.
  39   pon0
  40         Prints the command that ought to be run to execute
  41         commands on the testbed.  The output is a command and
  42         arguments, each followed by a null byte.  These should
  43         be put into an array of strings and passed to exec,
  44         with the actual command to be run added as a final
  45         argument (in sh syntax).
  46   console
  47         Runs  xm console <name-of-guest>
  48         (NB without a pty).
  49
  50 Only guests for which
  51   /var/lib/autopkgtest/xenlvm/<nominum>_<distro>
  52 exists and is a directory are allowed.