Requirements ============ - Twisted >= 8.0.1 - uuid.py (Python 2.5 std. lib. or http://pypi.python.org/pypi/uuid) - A Jabber server that supports the component protocol (JEP-0114) - Wokkel >= 0.3.1 (http://wokkel.ik.nu/) For the PostgreSQL backend, the following is also required: - PostgreSQL - pyPgSQL Installation ============ Run: python setup.py install Configuration ============= The configuration file is created using Twisted's mktap, which needs a number of parameters: --jid: The Jabber ID the component will assume. --rport: the port number of the Jabber server to connect to --secret: the secret used to authenticate with the Jabber server. --backend: the backend storage facility to be used (memory or PostgreSQL). The default settings of mktap for Idavoll use the memory database and assume the default settings of jabberd 2.x for --rport and --secret. jabberd 2.x =========== You can use the 'legacy' component support that defaults to port 5347 with secret 'secret'. You do not need to add anything specific for this service. jabberd 1.4.x ============= Put the following in the jabber.xml configuration file of jabberd: 127.0.0.1 5347 secret and restart jabberd. Unlike jabber 2.x, you can only have one component per port, so the port number may need to be changed. For other server implementations, please refer to its documentation on how to interact with server side components using the protocol defined in JEP-0114. Then, in the same directory as this file run: mktap idavoll --rport=5347 --jid=pubsub.localhost --secret=secret This uses the (default) memory based backend. For using the PostgreSQL backend, create a database (for example named pubsub) like so: createdb pubsub psql pubsub