Mercurial > libervia-pubsub
annotate INSTALL @ 291:61fb4817b77f
delegation: iq forwarded management:
in addition to the onForward observer, the xmlstream.send message is monkey patched, so we can inject the forwarded stanza as if it was received normally, and intercept the result to send it back to the server.
| author | Goffi <goffi@goffi.org> |
|---|---|
| date | Mon, 04 May 2015 18:40:47 +0200 |
| parents | b757c29b20d7 |
| children | b76cbf59772b |
| rev | line source |
|---|---|
| 155 | 1 Requirements |
| 2 ============ | |
| 3 | |
| 193 | 4 - Twisted >= 8.0.1: |
| 5 - Twisted Core | |
| 6 - Twisted Words | |
|
168
e2c2c2baf483
Fix use of uuid module now shipping with Python 2.5.
Ralph Meijer <ralphm@ik.nu>
parents:
167
diff
changeset
|
7 - uuid.py (Python 2.5 std. lib. or http://pypi.python.org/pypi/uuid) |
|
212
edabaa535476
These files also belong to the Idavoll 0.9.0 release.
Ralph Meijer <ralphm@ik.nu>
parents:
207
diff
changeset
|
8 - Wokkel >= 0.5.0 (http://wokkel.ik.nu/) |
| 264 | 9 - A Jabber server that supports the component protocol (XEP-0114), |
| 10 and, to enable the micro-blogging feature, the remote roster | |
| 11 management protocol (XEP-0321). We recommend using Prosody. | |
| 155 | 12 |
| 13 For the PostgreSQL backend, the following is also required: | |
| 14 | |
|
276
b757c29b20d7
import changes from idavoll changeset 233 (24be3a11ddbc), by Ralph Meijer and based on a patch by Nuno Santos
souliane <souliane@mailoo.org>
parents:
264
diff
changeset
|
15 - PostgreSQL (including development files for psycopg2) |
|
b757c29b20d7
import changes from idavoll changeset 233 (24be3a11ddbc), by Ralph Meijer and based on a patch by Nuno Santos
souliane <souliane@mailoo.org>
parents:
264
diff
changeset
|
16 - psycopg2 |
| 155 | 17 |
| 193 | 18 |
| 155 | 19 Installation |
| 20 ============ | |
| 21 | |
| 264 | 22 sat_pubsub uses setuptools for package building and installing. |
| 23 To build from the source run: | |
| 193 | 24 |
| 25 python setup.py build | |
| 26 | |
| 27 Then, to install run the following, possibly as root: | |
| 155 | 28 |
| 29 python setup.py install | |
| 30 | |
| 193 | 31 See the setuptools documentation for further information on changing |
| 32 installation locations. | |
| 33 | |
| 34 | |
| 155 | 35 Configuration |
| 36 ============= | |
| 37 | |
| 264 | 38 sat_pubsub uses Twisted's twistd command for running its services. Starting with |
| 193 | 39 Twisted 2.5.0, twistd supports running Twisted Application Plugins directly, |
| 40 without the use of mktap. In Twisted 8.1.0, the use of mktap for configuration | |
| 264 | 41 is deprecated. |
| 193 | 42 |
| 264 | 43 Idavoll, on which sat_pubsub is based, provides two types of storage for the backend: |
| 44 a memory-based storage facility, which is volatile, and a persistent storage facility | |
| 45 using PostgreSQL. For now, sat_pubsub only uses the persistent storage facility. | |
| 193 | 46 |
| 264 | 47 For using the PostgreSQL backend, create a database (for example named pubsub): |
| 193 | 48 |
| 264 | 49 sudo -u postgres createuser -d -P `whoami` |
| 50 createdb pubsub | |
| 51 psql pubsub < sat_pubsub/db/pubsub.sql | |
| 193 | 52 |
| 53 | |
| 264 | 54 Your Jabber server must also be configured to accept component connections and, |
| 55 to enable the micro-blogging feature, remote roster management. See below for details. | |
| 56 | |
| 193 | 57 |
| 264 | 58 Running sat_pubsub |
| 59 ================== | |
| 193 | 60 |
| 264 | 61 The minimal example for running sat_pubsub is: |
| 193 | 62 |
| 264 | 63 twistd sat_pubsub |
| 193 | 64 |
| 65 This will start the service and run it in the background. It generates a | |
| 66 file twistd.pid that holds the PID of the service and a log file twistd.log. | |
| 67 The twistd utility has a fair number of options that might be useful, and | |
| 68 can be viewed with: | |
| 69 | |
| 70 twistd --help | |
| 71 | |
| 72 When the service starts, it will connect to the Jabber server at the local | |
| 73 machine using the component protocol, and assumes the JID 'pubsub'. This | |
| 74 assumes a couple of defaults which can be overridden by passing parameters to | |
| 75 the twistd plugin. You can get an overview of the parameters and their defaults | |
| 76 using: | |
| 77 | |
| 264 | 78 twistd sat_pubsub --help |
| 193 | 79 |
| 80 In particular, the following parameters will be of interest: | |
| 155 | 81 |
| 82 --jid: The Jabber ID the component will assume. | |
| 83 --rport: the port number of the Jabber server to connect to | |
| 84 --secret: the secret used to authenticate with the Jabber server. | |
| 85 | |
| 264 | 86 For example: |
| 87 | |
| 88 twistd sat_pubsub --jid=sat-pubsub.<xmpp_domain> --secret=<password> | |
| 193 | 89 |
| 90 You may also want to provide the --verbose flag to see the traffic flow, | |
| 91 for example to debug the configuration. Below some specifics for the | |
| 264 | 92 Prosody XMPP server implementation. |
| 193 | 93 |
| 155 | 94 |
| 264 | 95 Running sat_pubsub with Prosody |
| 96 =============================== | |
| 155 | 97 |
| 264 | 98 To enable the micro-blogging feature with Prosody XMPP server, you need |
| 99 the remote_roster plugin. Check if the remote_roster plugin is already | |
| 100 in your Prosody installation: | |
| 155 | 101 |
| 264 | 102 cd prosody/plugins |
| 103 ls mod_remote_roster.lua | |
| 104 | |
| 105 If you can't see it, download it from here: | |
| 155 | 106 |
| 264 | 107 wget http://prosody-modules.googlecode.com/hg/mod_remote_roster/mod_remote_roster.lua |
| 108 | |
| 109 You need to patch the file (commenting two lines to make all contacts available): | |
| 110 | |
| 111 wget http://paste.debian.net/download/12106 | |
| 112 patch -p2 < paste_1206 | |
| 155 | 113 |
| 264 | 114 Edit the prosodi.cfg.lua file to add this module: |
| 155 | 115 |
| 264 | 116 modules_enabled = { |
| 117 [...] | |
| 118 "remote_roster"; | |
| 119 [...] | |
| 120 } | |
| 155 | 121 |
| 264 | 122 Also add these two lines at the end of the file, adapting them to your XMPP server |
| 123 domain (virtual host) and selecting a password of your choice: | |
| 155 | 124 |
| 264 | 125 Component "sat-pubsub.<xmpp_domain>" |
| 126 component_secret = "<password>" | |
| 155 | 127 |
| 264 | 128 For a more complete installation and configuration of Prosody to be used with |
| 129 sat_pubsub, please report yourself to the Salut à Toi wiki: | |
| 130 | |
| 131 http://wiki.goffi.org/wiki/Libervia/en#XMPP_server |