1ee572fa90013b7c6ee6eee5d0d9d65f16b951c8
[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 arch removal actions:
50 * remove the architecture from config-judd/archlist; make; review changes
51 * delete packages from database:
52     DELETE FROM packages WHERE release='jessie' AND architecture='ia64';
53 * if removed completely, also update udd-cache/data.py's archs list
54
55
56 Maintenance notes for Judd
57 ==========================
58
59 judd oldstable removal:
60 * shift/remove oldstable alias in uddcache/data.py
61 * fix tests that no longer work :(
62 * delete unneeded contents links from supybot/data/judd
63
64 judd release actions:
65 * add new -backports, -backports-sloppy, -updates etc in uddcache/data.py
66 * shift stable alias in uddcache/data.py
67 * update list of release and mapping in uddcache/data.py
68
69 judd new testing actions
70 * add new (testing) release to uddcache/data.py
71 * shift testing alias
72 * mkcontentslinks
73
74
75 Miscellaneous configuration options for the bot
76 ===============================================
77
78 The following commands are highly recommended for the bot:
79
80 load Alias
81 defaultcapability add -Alias.add
82 defaultcapability add -Alias.remove
83 alias add whatprovides rprovides $*
84 alias add source src $*
85 alias add maintainer maint $*
86 alias add uploader maint $*
87 alias add changer maint $*
88 alias add arches archs $*
89 alias add version versions $*
90 alias add v versions $*
91 alias add i info $*
92
93 alias add find file $*
94 alias add alternatives alternative $*
95
96 alias add rfs bug rfs $*
97 alias add wnpp bug wnpp $*
98
99 defaultplugin source Alias
100 defaultplugin version Alias
101
102 alias add bot echo No, I'm not a bot, I'm a frontend to a database.
103
104 In #debian-next:
105 ----------------
106 config channel supybot.plugins.Judd.default_release testing
107
108 In #debian-mentors:
109 -------------------
110 config channel supybot.plugins.Judd.default_release sid
111
112