Mercurial > libervia-pubsub
annotate INSTALL @ 192:a219fe70a762
Use ServiceMaker to setup twistd plugins, if available.
| author | Ralph Meijer <ralphm@ik.nu> |
|---|---|
| date | Fri, 30 May 2008 09:56:08 +0000 |
| parents | c61034369463 |
| children | 8ab16e319bb8 |
| rev | line source |
|---|---|
| 155 | 1 Requirements |
| 2 ============ | |
| 3 | |
| 189 | 4 - Twisted >= 8.0.1 |
|
168
e2c2c2baf483
Fix use of uuid module now shipping with Python 2.5.
Ralph Meijer <ralphm@ik.nu>
parents:
167
diff
changeset
|
5 - uuid.py (Python 2.5 std. lib. or http://pypi.python.org/pypi/uuid) |
| 189 | 6 - A Jabber server that supports the component protocol (JEP-0114) |
| 7 - Wokkel >= 0.3.1 (http://wokkel.ik.nu/) | |
| 155 | 8 |
| 9 For the PostgreSQL backend, the following is also required: | |
| 10 | |
| 11 - PostgreSQL | |
| 12 - pyPgSQL | |
| 13 | |
| 14 Installation | |
| 15 ============ | |
| 16 | |
| 17 Run: | |
| 18 | |
| 19 python setup.py install | |
| 20 | |
| 21 Configuration | |
| 22 ============= | |
| 23 | |
| 24 The configuration file is created using Twisted's mktap, which needs a number | |
| 25 of parameters: | |
| 26 | |
| 27 --jid: The Jabber ID the component will assume. | |
| 28 --rport: the port number of the Jabber server to connect to | |
| 29 --secret: the secret used to authenticate with the Jabber server. | |
| 30 --backend: the backend storage facility to be used (memory or PostgreSQL). | |
| 31 | |
| 32 The default settings of mktap for Idavoll use the memory database and assume | |
| 33 the default settings of jabberd 2.x for --rport and --secret. | |
| 34 | |
| 35 jabberd 2.x | |
| 36 =========== | |
| 37 You can use the 'legacy' component support that defaults to port 5347 with | |
| 38 secret 'secret'. You do not need to add anything specific for this service. | |
| 39 | |
| 40 jabberd 1.4.x | |
| 41 ============= | |
| 42 | |
| 43 Put the following in the jabber.xml configuration file of jabberd: | |
| 44 | |
| 45 <service id='pubsub.localhost'> | |
| 46 <accept> | |
| 47 <ip>127.0.0.1</ip> | |
| 48 <port>5347</port> | |
| 49 <secret>secret</secret> | |
| 50 </accept> | |
| 51 </service> | |
| 52 | |
| 53 and restart jabberd. Unlike jabber 2.x, you can only have one component per | |
| 54 port, so the port number may need to be changed. | |
| 55 | |
| 56 For other server implementations, please refer to its documentation on | |
| 57 how to interact with server side components using the protocol defined in | |
| 58 JEP-0114. | |
| 59 | |
| 60 Then, in the same directory as this file run: | |
| 61 | |
| 62 mktap idavoll --rport=5347 --jid=pubsub.localhost --secret=secret | |
| 63 | |
| 64 This uses the (default) memory based backend. | |
| 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.sql | |
| 71 | |
| 72 To use this backend, add the --backend=pgsql parameter to mktap. | |
| 73 | |
| 74 For viewing all options, run: | |
| 75 | |
| 76 mktap idavoll --help | |
| 77 | |
| 78 The generated file idavoll.tap now holds the configuration. | |
| 79 | |
| 80 Running | |
| 81 ======= | |
| 82 | |
| 83 Using the configuration file idavoll.tap, run: | |
| 84 | |
| 85 twistd -of idavoll.tap | |
| 86 | |
| 87 This will start the service and run it in the background. It generates a | |
| 88 file twistd.pid that holds the PID of the service and a log file twistd.log. | |
| 89 The twistd utility has a fair number of options that might be useful, and | |
| 90 can be viewed with: | |
| 91 | |
| 92 twistd --help |