1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
|
Overview
++++++++
This branch contains the test suites, preseeds and master run lists for
execution of tests associated with Ubuntu Server using UTAH.
See http://utah.readthedocs.org/en/latest/index.html for more information
on all aspects of UTAH.
Getting Started
+++++++++++++++
The preseeds assume that squid-deb-proxy is running on the VM host:
sudo apt-get install squid-deb-proxy
Currently the stable packages are good to execute tests:
sudo add-apt-repository ppa:utah/stable
sudo apt-get install utah vm-tools
You can then run tests using the 'runtest' wrapper in the root of the
branch::
./runtest <testname> <ISO path>
for example::
./runtest ceph ~/isos/ubuntu-server/quantal-server-amd64.iso
The <testname> assumes that there is a valid runlist and preseed
for the test; in the case of ceph is uses the default preseed by
symbolic link.
Folder Structure
++++++++++++++++
runlists: Top level run lists for individual test executions
preseeds: Preseeds associated with each runlist
testsuites: test suites used by the runlists
runlists
........
This folder contains the UTAH runlist for each test case. This is all that is
required to specify the tests that will be run during testing.
You can validate that it works but running::
sudo utah -r <RUNLIST>
By default UTAH runs the runlist as root - individual test suites can run
test cases as non-root users.
preseeds
........
This folder contains the preseeds use during provisioning ofUTAH instances for
testing.
Note that preseeds are auto-generated using jinja2 templates. These are
contained in the templates subfolder.
Each preseed template (dns for example) extends the 'base' preseed template
and provides overrides as required.
The preseeds can be re-generated by running the 'generate-all' script in the
preseeds folder. This functionality may become part of UTAH at some point in
time.
testsuites
..........
This folder contains the test suites that are used for validation of Ubuntu
Server installations.
Each testsuite is focussed on a particular task or feature.
Most are written as python test cases ATM; but it is possible to use scripts
as UTAH determines test success or failure using the exit code of the script.
See the ceph testsuite for an example.
See the ts* and tc* files within the directory structure for details of each
suite - these are UTAH configuration files (see docs for more information).
Known Issues
++++++++++++
Its not possible to run the raid1 testsuite; UTAH currently fails to create
multiple disks and the provisioning step of the test run fails.
|