]> git.donarmstrong.com Git - debbugs.git/blob - README_sql.md
add cache_key support to binary_to_source when schema is set
[debbugs.git] / README_sql.md
1 # Bringing up SQL for Debbugs
2
3 ## Creation of database
4
5 Debbugs needs a postgresql database (≥ 9.4) with the debversion
6 extension installed. `apt-get install postgresql-9.5
7 postgreql-9.5-debversion` to install those two packages.
8
9 Then create a database and enable the debversion extension:
10
11     echo 'create database debbugs' | psql;
12     echo 'create extension debversion' | psql debbugs;
13     
14 Debbugs also expects to be able to connect to databases using
15 a
16 [postgresql service definition](https://www.postgresql.org/docs/current/static/libpq-pgservice.html) which
17 defines the host, port, database, and any other connection information
18 which is needed. The default service is 'debbugs', but this can be
19 configured using `/etc/debbugs/config` or the `--service` option to
20 most commands. The most simplistic `~/.pg_service.conf` looks like this:
21
22     [debbugs]
23      host=localhost
24      database=debbugs
25
26 ## Insert database schema
27
28 To create the database schema, run `debbugs-installsql
29 --service=debbugs --install` (replacing debbugs with whatever the
30 appropriate service is.) The `debbugs-installsql` command also has an
31 `--upgrade` option which can be used to upgrade the schema between
32 schema revisions.
33
34 ## Populate database initially
35
36 1. Insert configuration `debbugs-loadsql configuration`
37 2. Add suites `debbugs-loadsql suites --ftpdist /srv/ftp.debian.org/dists`
38 3. Add packages `debbugs-loadsql packages --progress --ftpdist /srv/ftp.debian.org/dists`
39 4. Add debinfo
40    find /srv/bugs.debian.org/versions/archive/ftp-master -type f -iname '*.debinfo' -print0 \
41    debbugs-loadsql --progress debinfo --null;
42 5. Add versions
43    find /srv/bugs.debian.org/versions/archive/ftp-master -type f -iname '*.versions' -print0 \
44    debbugs-loadsql --progress debinfo --null;
45 4. Add bugs `debbugs-loadsql bugs --progress --preload`
46 5. Add bug logs `debbugs-loadsql logs --progress`
47 6. Add maintainers `debbugs-loadsql maintainers`
48