759e14bbe5abf3d50cd0d5499b4fade7871f40d3
[judd.git] / supybot / plugins / Judd / README
1 Judd: A supybot plugin to view into the Ultimate Debian Database
2 ===============================================================
3
4 Data
5 ====
6 * Ultimate Debian Database -- packages, sources, bugs
7   Running on same host with permanent db connection from bot to db.
8   Data is updated from cron:
9     - packages and sources information loaded into the db by the gatherers
10     - bugs data loaded from SQL snapshot of udd.debian.org
11 * Contents files
12   Files from mirror searched using zgrep.
13   Data is updated by udd cron jobs.
14 * Alternatives list
15   Snapshot generated periodically by Jakub Wilk.
16     - wget http://people.debian.org/~jwilk/alternatives/Contents -O- |
17         gzip -c > supybot/data/judd/debian-sid/main/Contents-alt.gz
18
19
20 Maintenance notes for UDD
21 =========================
22
23 udd oldstable removal actions:
24 * update cron job (~/bin/udd-update-stable)
25 * stop importing oldstable (config-judd/Makefile)
26 * delete oldoldstable data from database:
27   psql
28     => SELECT count(*) FROM packages WHERE release LIKE 'lenny%';
29     num archs * num packages (200k?)
30     => DELETE FROM packages WHERE release LIKE 'lenny%';
31     => SELECT count(*) FROM sources WHERE release LIKE 'lenny%';
32     num src packages (15k?)
33     => DELETE FROM sources WHERE release LIKE 'lenny%';
34 * delete oldoldstable data from disk cache
35     /srv/mirrors/debian/dists/lenny /srv/mirrors/debian-backports/dists/lenny-backports /srv/mirrors/debian-backports/dists/lenny-backports-sloppy /srv/mirrors/debian-security/lenny /srv/mirrors/debian-multimedia.org/dists/lenny /srv/mirrors/debian-volatile
36 * add oldoldstable to the list of old timestamps to ignore in udd-check-updates
37
38 udd release actions:
39 * update cron jobs (~/bin/udd-update-{stable,changing})
40 * update archs with release architectures (config-judd/archlist)
41 * check components (volatile vs updates, backports-sloppy etc:
42   config-judd/config-generic-release.yaml)
43
44 udd new testing actions:
45 * add new testing (config-judd/Makefile)
46 * update cron jobs (~/bin/udd-update-changing)
47 * update archs (config-judd/archlist)
48
49
50 Maintenance notes for Judd
51 ==========================
52
53 judd oldstable removal:
54 * shift/remove oldstable alias in uddcache/data.py
55 * fix tests that no longer work :(
56 * delete unneeded contents links from supybot/data/judd
57
58 judd release actions:
59 * add new -backports, -backports-sloppy, -updates etc in uddcache/data.py
60 * shift stable alias in uddcache/data.py
61
62 judd new testing actions
63 * add new (testing) release to plugin.py
64 * shift testing alias
65 * mkcontentslinks
66
67
68 Miscellaneous configuration options for the bot
69 ===============================================
70
71 The following commands are highly recommended for the bot:
72
73 load Alias
74 defaultcapability add -Alias.add
75 defaultcapability add -Alias.remove
76 alias add whatprovides rprovides $*
77 alias add source src $*
78 alias add maintainer maint $*
79 alias add uploader maint $*
80 alias add changer maint $*
81 alias add arches archs $*
82 alias add version versions $*
83 alias add v versions $*
84 alias add i info $*
85
86 alias add find file $*
87 alias add alternatives alternative $*
88
89 alias add rfs bug rfs $*
90 alias add wnpp bug wnpp $*
91
92 defaultplugin source Alias
93 defaultplugin version Alias
94
95 alias add bot echo No, I'm not a bot, I'm a frontend to a database.
96
97 In #debian-next:
98 ----------------
99 config channel supybot.plugins.Judd.default_release testing
100
101 In #debian-mentors:
102 -------------------
103 config channel supybot.plugins.Judd.default_release sid
104
105