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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
# Developer setup
In this document, we assume that you are developing on a Debian system. We also
assume that the version is Bullseye (or any more recent versions).
??? note "Other distributions"
Even if we assume the use of Debian, you can also use any non-Debian
distributions. Just adapt the steps above to match your distribution.
We currently recommend two methods for developing LAVA.
* [from the Debian packages](#from-debian-packages)
* [from sources](#from-sources)
Both methods are currently used by LAVA core developers. Choosing one or the other is a matter of taste.
## From Debian packages
Install the Debian packages:
```shell
apt-get install git postgresql
apt-get install lava-coordinator lava-dispatcher lava-server
```
Fetch the sources somewhere in your home directory.
```shell
cd ~/
git clone https://gitlab.com/lava/lava
cd ~/lava/
```
Remove the lava binaries and packages from the system directories:
```shell
# python libraries
rm -rf /usr/lib/python3/dist-packages/lava/
rm -rf /usr/lib/python3/dist-packages/lava_common/
rm -rf /usr/lib/python3/dist-packages/lava_dispatcher/
rm -rf /usr/lib/python3/dist-packages/lava_dispatcher_host/
rm -rf /usr/lib/python3/dist-packages/lava_rest_app/
rm -rf /usr/lib/python3/dist-packages/lava_results_app/
rm -rf /usr/lib/python3/dist-packages/lava_scheduler_app/
rm -rf /usr/lib/python3/dist-packages/lava_server/
rm -rf /usr/lib/python3/dist-packages/linaro_django_xmlrpc/
# binaries
rm -f /usr/bin/lava-coordinator
rm -f /usr/bin/lava-dispatcher-host
rm -f /usr/bin/lava-run
rm -f /usr/bin/lava-server
rm -f /usr/bin/lava-worker
```
Add symbolic links to your local clone:
```shell
# python libraries
cd /usr/lib/python3/dist-packages/
ln -s ~/lava/lava/ .
ln -s ~/lava/lava_common/ .
ln -s ~/lava/lava_dispatcher/ .
ln -s ~/lava/lava_dispatcher_host/ .
ln -s ~/lava/lava_rest_app/ .
ln -s ~/lava/lava_results_app/ .
ln -s ~/lava/lava_scheduler_app/ .
ln -s ~/lava/lava_server/ .
ln -s ~/lava/linaro_django_xmlrpc/ .
# binaries
cd /usr/bin/
ln -s ~/lava/lava/coordinator/lava-coordinator .
ln -s ~/lava/lava/dispatcher/lava-run .
ln -s ~/lava/lava/dispatcher/lava-worker .
ln -s ~/lava/lava_dispatcher_host/lava-dispatcher-host .
ln -s ~/lava/manage.py lava-server
```
Install the lava-dispatcher-host udev rules:
```shell
lava-dispatcher-host rules install
```
Restart the services:
```shell
systemctl restart lava-coordinator
systemctl restart lava-publisher
systemctl restart lava-scheduler
systemctl restart lava-server-gunicorn
systemctl restart lava-worker
```
LAVA is now accessible at [http://localhost/](http://localhost/)
## From sources
Install basic tools:
```shell
apt-get install black git nfs-kernel-server \
postgresql postgresql-client \
python3 python3-yaml python3-django-extensions python3-werkzeug \
ruby-foreman
```
Fetch the sources somewhere in your home directory.
```shell
cd ~/
git clone https://gitlab.com/lava/lava
cd ~/lava/
```
Install `lava-dispatcher` and `lava-server` dependencies:
```shell
apt-get install \
$(python3 share/requires.py -p lava-common -d debian -s bullseye -n) \
$(python3 share/requires.py -p lava-dispatcher -d debian -s bullseye -n) \
$(python3 share/requires.py -p lava-dispatcher -d debian -s bullseye -n -u) \
$(python3 share/requires.py -p lava-dispatcher-host -d debian -s bullseye -n) \
$(python3 share/requires.py -p lava-server -d debian -s bullseye -n) \
$(python3 share/requires.py -p lava-server -d debian -s bullseye -n -u)
```
Create the test database:
```shell
sudo -u postgres psql -c "CREATE ROLE devel NOSUPERUSER CREATEDB NOCREATEROLE INHERIT LOGIN ENCRYPTED PASSWORD 'devel'"
sudo -u postgres psql -c "CREATE DATABASE devel OWNER devel"
```
Apply the django migrations
```shell
python3 manage.py migrate
```
Install the lava-dispatcher-host udev rules
```shell
$(pwd)/lava_dispatcher_host/lava-dispatcher-host rules install
```
The above will make the installed udev rules call the lava-dispatcher-host
program inside your source directory. If you move your source directory to a
different location, you will have to install the rules again.
Start the services
```shell
foreman start
```
LAVA is now accessible at [http://localhost:8000/](http://localhost:8000/)
|
