|
88
|
1 Idavoll using Twisted Python. |
|
10
|
2 |
|
88
|
3 What is Idavoll? |
|
|
4 ================ |
|
10
|
5 |
|
|
6 A pubsub service, as defined in JEP-0060, aiming to be fully compliant and |
|
|
7 mostly complete. The goal is to build a /generic/ pubsub service, but of which |
|
|
8 parts can be reused for building custom pubsub services for specific |
|
|
9 applications. |
|
|
10 |
|
|
11 |
|
|
12 Current Status |
|
|
13 ============== |
|
|
14 |
|
88
|
15 There are two different backends: one using PostgreSQL for storage, and one |
|
|
16 just keeping everything in memory. |
|
10
|
17 |
|
88
|
18 In Idavoll the mimimal requirements of JEP-0060 version 1.6 are implemented. |
|
|
19 It also returns the following features: |
|
10
|
20 |
|
88
|
21 http://jabber.org/protocol/pubsub#outcast-affiliation |
|
|
22 http://jabber.org/protocol/pubsub#publisher-affiliation |
|
|
23 http://jabber.org/protocol/pubsub#persistent-items |
|
|
24 http://jabber.org/protocol/pubsub#subscribe |
|
|
25 http://jabber.org/protocol/pubsub#create-nodes |
|
|
26 http://jabber.org/protocol/pubsub#instant-nodes |
|
10
|
27 |
|
88
|
28 When using the PostgreSQL backend the following features are also supported: |
|
|
29 |
|
|
30 http://jabber.org/protocol/pubsub#retrieve-items |
|
10
|
31 |
|
|
32 Requirements |
|
|
33 ============ |
|
|
34 |
|
132
|
35 - Twisted >= 2.0.0 |
|
88
|
36 - A jabber server like jabberd 1.4.x |
|
|
37 |
|
|
38 For the PostgreSQL backend, the following is also required: |
|
|
39 |
|
|
40 - PostgreSQL |
|
|
41 - pyPgSQL |
|
10
|
42 |
|
|
43 Usage |
|
|
44 ===== |
|
|
45 |
|
|
46 For jabberd 1.4 configuration, put the following in jabber.xml: |
|
|
47 |
|
|
48 <service id='pubsub.localhost'> |
|
|
49 <accept> |
|
|
50 <ip>127.0.0.1</ip> |
|
|
51 <port>1238</port> |
|
|
52 <secret>mysecret</secret> |
|
|
53 </accept> |
|
|
54 </service> |
|
|
55 |
|
|
56 and restart jabberd. |
|
|
57 |
|
|
58 Then, in the same directory as this file run: |
|
|
59 |
|
|
60 mktap idavoll --rport=1238 --jid=pubsub.localhost --secret=1238 |
|
|
61 twistd -rf idavoll.tap |
|
|
62 |
|
132
|
63 This uses the (default) memory based backend. You can ignore the deprecation |
|
|
64 warnings. |
|
88
|
65 |
|
|
66 For using the PostgreSQL backend, create a database (for example named pubsub) |
|
|
67 like so: |
|
|
68 |
|
|
69 createdb pubsub |
|
|
70 psql pubsub <db/pubsub.db |
|
|
71 |
|
|
72 Then do: |
|
|
73 |
|
|
74 mktap idavoll --rport=1238 --jid=pubsub.localhost --secret=1238 \ |
|
|
75 --backend=pgsql |
|
|
76 twistd -rf idavoll.tap |
|
|
77 |
|
|
78 For viewing all options, run: |
|
|
79 |
|
|
80 mktap idavoll --help |
|
|
81 |
|
|
82 Contact |
|
|
83 ======= |
|
|
84 |
|
|
85 Questions, comments or suggestions are welcome! |
|
|
86 |
|
|
87 Ralph Meijer |
|
|
88 <xmpp:ralphm@ik.nu> |
