WPJabber and MU-Conference Micro-HOWTO

1. Introduction

1.1 Standard Disclaimer

No liability for the contents of this documents can be accepted. Use the concepts, examples and other content at your own risk. As this is a new document, there may be errors and inaccuracies, that may of course be damaging to your system. Proceed with caution, and although this is highly unlikely, I don't take any responsibility for that.

1.2 Feedback

Feedback is most certaintly welcome for this document. Although I do not plan to actively maintain this document, I will include worthy submissions and input that I receive. If you have additions, comments and criticisms, please send them to Kevin Dougherty <spam@kdough.net>.

1.2 Summary

This document will describe briefly how to use the WPJabber Jabber Server with the MU-Conference Multi-User Chat component (as defined in JEP-0045).

Environment:

2. Linux Kernel Setup

Patch your kernel with the following to enable event polling as required by WPJabber: Kernel v2.4.19 epoll patch. There are, however, patches for more recent kernels (e.g. 2.4.20), but they do not appear to work with this release of WPJabber. You may find other epoll patches here.

3. WPJabber Setup

Compile WPJabber v1.0.4 and install normally (as in the README). Ignore the included muc-diff.patch file as the following patch supercedes it.

4. MU-Conference Setup

Patch MU-Conference v0.5.1 with this patch I made: mu-conference-0.5.1-wpjabber_104.patch. Note this patch includes and supercedes the patch in the 1.0.4 WPJabber distribution (doc/mu-diff.patch). Compile and install as described in the README.

5. Runtime Setup

Example startup scripts:

Example config snippets:

Good luck! I hope this document was able to help anyone having issues (as I had) with getting these two great programs to play nicely together.


Last modified: Thu Oct 23 11:01:24 MDT 2003