Differential D783

Update install guide to reflect Fedora setup
ClosedPublic
Actions

Authored by jskladan on Mar 17 2016, 2:37 PM.

Tags

None

Subscribers

Details

Reviewers

adamwill
garretraziel

Commits

rOPENQA6e200584cf38: Update install guide to reflect Fedora setup

Summary

Updates the install guide

Test Plan

None

Diff Detail

Repository

rOPENQA fedora_openqa

Lint

Automatic diff as part of commit; lint not applicable.

Unit

Automatic diff as part of commit; unit tests not applicable.

jskladan retitled this revision from to Update install guide to reflect Fedora setup.Mar 17 2016, 2:37 PM

jskladan updated this object.

jskladan edited the test plan for this revision. (Show Details)

jskladan added reviewers: adamwill, garretraziel.

Herald added a subscriber: tflink. · View Herald TranscriptMar 17 2016, 2:37 PM

LGTM.

This revision is now accepted and ready to land.Mar 17 2016, 2:42 PM

xfs

Yikes, sorry, I should have mentioned - I actually looked at this, then decided to fix upstream's docs instead:

https://github.com/os-autoinst/openQA/pull/606

this is all fine, I just figured we could cut down on up/downstream duplication...

In D783#14948, @adamwill wrote:

this is all fine, I just figured we could cut down on up/downstream duplication...

Cool, the primary reason for keeping the InstallGuide downstream was the poor quality of the official docs on the matter (read - it really was impossible to install using the official docs).

I'll have a look at the official document, and probably remove the install guide on our side, after I check that installation by that guide is straightforward, and working :)

the upstream guide is kinda longer, so it might make sense to keep a really bare-bones walkthrough downstream with a link to the upstream guide, i guess.

Closed by commit rOPENQA6e200584cf38: Update install guide to reflect Fedora setup (authored by Josef Skladanka <jskladan@redhat.com>). · Explain WhyMar 22 2016, 12:42 PM

This revision was automatically updated to reflect the committed changes.

Revision Contents

			Path	Packages
M			InstallGuide.md (133 lines)

Diff 2014

InstallGuide.md

1	OpenQA install guide	1		OpenQA install guide
2	====================	2		====================
3		3
4	Install OpenSuse 13.2	4		For Fedora 22+
5	---------------------
6		5
7	* Add online repos before installation	6		Install the required packages:
8	* Create partition setup & use the right HDD
9	* Select Update & Non-OSS repos & Main Update Repository
10	* Select GNOME desktop
11	* Create user (test/fedora), make user system administrator
12	* Disable firewall, enable SSH
13		7
14	Install OpenQA	8		sudo dnf install openqa openqa-httpd openqa-worker
15	--------------
16		9
17	1. become a root	10		Configure httpd:
18		11
19	sudo su -	12		cd /etc/httpd/conf.d/
20		13		cp openqa.conf.template openqa.conf
21	2. add repos	14		cp openqa-ssl.conf.template openqa-ssl.conf
22
23	zypper ar -f http://download.opensuse.org/repositories/devel:openQA:stable/openSUSE_13.2/devel:openQA:stable.repo
24	zypper ar -f obs://devel:openQA/openSUSE_13.2 openQA
25	zypper ar -f obs://devel:openQA:13.2/openSUSE_13.2 openQA-perl-modules
26	zypper ar -f obs://Virtualization/openSUSE_13.2 Virtualization
27
28	3. install OpenQA and ovmf (for UEFI testing)
29
30	zypper in openQA
31	zypper in openQA-worker
32	zypper in --from Virtualization qemu-ovmf-x86_64
33
34	4. create filesystem layout
35
36	cd /var/lib/openqa
37	mkdir factory/hdd
38		15
39	5. setup apache
40		16
41	gensslcert	17		Configure OpenQA WebUI by editing `/etc/openqa/openqa.ini`:
42	cd /etc/apache2/vhosts.d/
43	a2enmod headers
44	a2enmod proxy
45	a2enmod proxy_http
46	a2enmod proxy_wstunnel
47	a2enmod ssl
48	a2enflag SSL
49		18
50	cp openqa-ssl.conf.template openqa-ssl.conf	19		[global]
51	cp openqa.conf.template openqa.conf	20		branding=plain
		21		download_domains = fedoraproject.org opensuse.org
		22		[auth]
		23		method = Fake
52		24
53	6. edit openqa-ssl.conf	25		Start the Services (consider also running `enable` if you want persistence:
54		26
55	vim openqa-ssl.conf	27		systemctl start httpd
		28		systemctl start openqa-gru
		29		systemctl start openqa-webui
56		30
57	Un-comment lines starting with `#SSL`. Replace paths to certificates from	31		Create non-temporary API keys in the Web Interface at http://localhost click `Login`, then `Manage API Keys` and create new keyset.
58	`openqa.{crt,key}` to `server.{crt,key}`.	32		Edit `/etc/openqa/client.conf`:
59		33
60	7. correct OpenID link	34		[localhost]
		35		key = insert key from web api
		36		secret = insert secret from web api
61		37
62	vim /etc/openqa/openqa.ini	38		Start the Worker:
63		39
64	Uncomment & change:	40		systemctl start openqa-worker@1
65		41
66	[openid]	42		Check that it's active in the WebUI's admin interface. To start more workers, change the number after the `@` sign in the above command.
67	provider = https://id.fedoraproject.org/
68	[auth]
69	method = OpenID
70		43
71	8. set up fedora tests from repo	44		Grab the tests, and initialize the database:
72		45
73	zypper in guestfs-tools	46		cd /var/lib/openqa/tests/
74	git clone http://bitbucket.org/rajcze/openqa_fedora.git /var/lib/openqa/tests/fedora	47		git clone https://bitbucket.org/rajcze/openqa_fedora fedora
75	chown -R geekotest /var/lib/openqa/tests/	48		chown -R geekotest:geekotest fedora
		49		cd fedora
		50		./templates
76		51
77	9. set up disks	52		To run the tests, you will also need to provide some disk images:
78		53
79	git clone http://bitbucket.org/rajcze/openqa_fedora_tools.git ~/openqa_fedora_tools	54		git clone http://bitbucket.org/rajcze/openqa_fedora_tools.git ~/openqa_fedora_tools
		55		dnf install libguestfs-tools libguestfs-xfs
		56		mkdir -p /var/lib/openqa/factory/hdd
80	cd /var/lib/openqa/factory/hdd/	57		cd /var/lib/openqa/factory/hdd/
81	~/openqa_fedora_tools/tools/createhdds.py all	58		~/openqa_fedora_tools/tools/createhdds.py all
82	chown geekotest *	59		chown geekotest *
83		60
84	10. setup services	61		[optional] go to OpenQA web interface, go to "admin" -> "Test suites".
85
86	systemctl enable apache2
87	systemctl restart apache2
88	systemctl enable openqa-webui
89	systemctl restart openqa-webui
90
91	11. check if openqa-webui is runing
92
93	curl http://localhost
94
95	12. login via OpenID in the web interface - the first one to login is automagically set to be the admin
96
97	13. setup Worker - go to http://localhost/api_keys & create the keys. Copy the key & secret to `/etc/openqa/client.conf`
98
99	14. [optional] create required worker directories - this isn't needed if you plan to have only one worker (suitable for development):
100
101	mkdir pool/1
102	chown -R _openqa-worker pool/1
103
104	15. start worker
105	systemctl enable openqa-worker@1
106	systemctl start openqa-worker@1
107
108	Check whether worker is active in the web-ui. To add another worker, repeat the steps of "create required worker directories" and "start worker", substituing "1" to next available number.
109
110	16. populate database with fedora-specific tests
111
112	cd /var/lib/openqa/tests/fedora && ./templates
113
114	17. [optional] go to OpenQA web interface, login as admin, go to "admin" -> "Test suites".
115	Set `REPOSITORY_GRAPHICAL` and `REPOSITORY_VARIATION` to your nearest mirror	62		Set `REPOSITORY_GRAPHICAL` and `REPOSITORY_VARIATION` to your nearest mirror
116	according to this list: https://mirrors.fedoraproject.org/mirrorlist?repo=fedora-23&arch=x86_64,	63		according to this list: https://mirrors.fedoraproject.org/mirrorlist?repo=fedora-23&arch=x86_64,
117	excluding `/23/x86_64/os/` at the end of url. For example if your nearest mirror	64		excluding `/23/x86_64/os/` at the end of url. For example if your nearest mirror
118	is http://ftp.linux.cz/pub/linux/fedora/linux/development/23/x86_64/os/, set	65		is http://ftp.linux.cz/pub/linux/fedora/linux/development/23/x86_64/os/, set
119	`REPOSITORY_GRAPHICAL` and `REPOSITORY_VARIATION` to http://ftp.linux.cz/pub/linux/fedora/linux/development.	66		`REPOSITORY_GRAPHICAL` and `REPOSITORY_VARIATION` to http://ftp.linux.cz/pub/linux/fedora/linux/development.
120		67
121	18. enable SSH
122
123	systemctl enable sshd
124	systemctl start sshd
125
126	19. enable SSH, HTTP and HTTPS in firewall
127
128	SuSEfirewall2 open EXT TCP ssh
129	SuSEfirewall2 open EXT TCP http
130	SuSEfirewall2 open EXT TCP https