File: INSTALL.asciidoc

package info (click to toggle)
os-autoinst 4.5.1527308405.8b586d5-4.1
  • links: PTS, VCS
  • area: main
  • in suites: buster, sid
  • size: 22,688 kB
  • sloc: perl: 10,424; cpp: 1,527; python: 217; makefile: 211; sh: 71; xml: 11
file content (106 lines) | stat: -rw-r--r-- 3,896 bytes parent folder | download
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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
[[pragmatic-development-environment-on-opensuse]]
pragmatic development environment on openSUSE
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1.  install openQA package to get all the runtime dependencies as described in
the
https://github.com/os-autoinst/openQA/blob/master/docs/Installing.asciidoc[openQA
installation guide]
+
2.  check out os-autoinst
+
------------------------------------------------
git clone YOUR-WRITEABLE-COPY-OF/os-autoinst.git
cd os-autoinst
------------------------------------------------
3.  install the BuildRequires, as per the https://build.opensuse.org/package/show/devel:openQA/os-autoinst[spec file] 
+
-----------------------------------------------------------------------------------------------------------------------------------
sudo zypper in git-core make libtheora-devel opencv-devel fftw3-devel libsndfile-devel pkg-config libtool autoconf automake gcc-c++
-----------------------------------------------------------------------------------------------------------------------------------
4.  build the beastie locally
+
----------------
autoreconf -f -i
./configure
make
----------------
5.  get the test cases and the needles.
+
The needles have to be a subdir of the test cases!
+
-----------------------------------------------------------------------------
mkdir distri
cd distri
git clone git@github.com:os-autoinst/os-autoinst-distri-opensuse.git opensuse
cd opensuse
git clone git@github.com:os-autoinst/os-autoinst-needles-opensuse.git needles
-----------------------------------------------------------------------------
6.  create a test dir to run os-autoinst in
+
--------------------------
mkdir /tmp/os-autoinst-run
cd /tmp/os-autoinst-run
--------------------------
7.  create a minimal "vars.json" config file
+
.vars.json
[source,json]
---------------------------------------------------------
{
   "ARCH" : "x86_64",
   "BACKEND" : "qemu",
   "CASEDIR" : "/path/to/os-autoinst-distri-opensuse",
   "DESKTOP" : "gnome",
   "DISTRI" : "opensuse",
   "ISO" : "/path/to/openSUSE-Tumbleweed-DVD-x86_64-Snapshot20160715-Media.iso",
   "PRODUCTDIR" : "/path/to/os-autoinst-distri-opensuse/products/opensuse",
   "VNC" : 90,
}
---------------------------------------------------------
+
You will need to correct the file paths to point to real locations. Some of
the variables you can use are listed
https://github.com/os-autoinst/os-autoinst/blob/master/doc/backend_vars.asciidoc[here].
Test case specific variables are listed in the distri directories
e.g. https://github.com/os-autoinst/os-autoinst-distri-opensuse/blob/master/variables[os-autoinst-distri-opensuse/variables].
+
8.  give it a shot
+
------------------------------
PATH_TO/os-autoinst/isotovideo
------------------------------
9.  hack away :)

[[use-of-git-repo-with-with-openqa]]
use of git repo with with openQA
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

to use os-autoinst with openQA it needs to be "installed". Placing a
symlink to /usr/lib/os-autoinst that points to the git checkout should
work. To make tests and needles writable don't touch distri/ and use
tools/fetchneedles instead to set it up.

[[opensuse-setup]]
openSUSE setup
~~~~~~~~~~~~~~

-------------------------------------------------------
zypper ar -r http://download.opensuse.org/repositories/devel:/openQA/openSUSE_Leap_42.1/devel:openQA.repo
zypper in os-autoinst

usermod -G kvm -a $USERNAME || usermod -A kvm $USERNAME
-------------------------------------------------------

[[more-linux-setup]]
more Linux setup
~~~~~~~~~~~~~~~~

-----------------------------------------------------------
modprobe kvm-intel || modprobe kvm-amd
chgrp kvm /dev/kvm ; chmod g+rw /dev/kvm # maybe redundant
# optionally use a new user; just to keep things separate
useradd -m USERNAME -G kvm
passwd USERNAME # and/or add ~USERNAME/.ssh/authorized_keys
-----------------------------------------------------------