1 Virtualisation service for use via userv
2 ----------------------------------------
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.
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.
13 To make this feature available:
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.
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.
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>
37 Starts adt-xenlvm-with-testbed, prints `y', waits for
38 eof on stdin, and then exits adt-xenlvm-with-testbed.
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).
47 Runs xm console <name-of-guest>
51 /var/lib/autopkgtest/xenlvm/<nominum>_<distro>
52 exists and is a directory are allowed.