PyMSNt Server Administrator Documentation

Please visit http://msn-transport.jabberstudio.org to download the transport and see news updates

If you have any insights or comments to add to this page please use the Add comment link below to do so.

Installation Guide

Instructions/suggestions for other servers and OSs are welcome

Basic Installation

Make sure have installed Python 2.3 or newer. Most distributions should handle this automatically for you.
On Mandrake:
```
urpmi python
```
On Debian:
```
apt-get install python2.3
```
On Windows: Download and run the binary installer from http://www.python.org. When complete, add the directory that python.exe is in to your PATH (look in Windows help for details on doing this)
Others: Use your distribution's installation method, or download and compile the source from http://www.python.org

Install the Twisted framework (library). Version 1.1 or newer should be fine.
On Mandrake: You will need to download the pycrypto and python openssl RPMs and install them as well as twisted using urpmi. Unfortunately I cannot provide links. I know you can get them from Mandrake Club though.

On Debian:

apt-get install python2.3-twisted python2.3-crypto python2.3-pyopenssl

On Windows: Download and run the binary installers for Twisted, PyCrypto and PyOpenSSL from http://www.twistedmatrix.com"
Others: Use your distribution's installation method, or download (and compile when necessary) from http://www.twistedmatrix.com" Twisted, PyCrypto and PyOpenSSL

Edit config.py (look in the src/ directory) to reflect your environment.
The 'jid' setting should be what ID you want PyMSNt to take on the network.
The 'name' setting should be what name you wish users to see in a service discovery request.
The 'mainServer' setting should be the IP address or DNS of the main Jabberd server.
The 'secret' setting should match the secret specified for component connections in your main Jabberd server.
The 'port' setting is the port that PyMSNt is to connect to (more details on this below.
You can also turn on debugging options, and customise some of the text that is sent to the users in this file.

If you are upgrading from the old C version of MSN-t then copy your existing spool directory (it will be called msn.host.com) into the same place as the README and TODO files.
If you are starting a new installation create the spool directory in the same place as the README and TODO files
In both cases the spool directory must be writeable by whatever user will be running PyMSNt, and it must have the same name as the 'jid' value you specified above in config.py

Configuration of Jabber Servers

The instructions below assume you are running PyMSNt on the same machine as your main Jabber server

If you are using Jabberd2 then you shouldn't have to do much configuration. Make sure the 'mainServer' setting is the IP or DNS of your Jabber server, and leave the 'port' setting alone. Double-check that the secret for legacy components in router.xml (for Jabberd2) is the same as the secret setting in config.py. That should be all. You don't even need to restart Jabberd2.

If you are using Jabberd1.4.x then you need to add this to your jabber.xml file

  <service id="msn.host.com">
          <host>msn.host.com</host>
          <accept>
                  <ip>127.0.0.1</ip>
                  <port>XXXX</port>
                  <secret>secret</secret>
          </accept>
  </service>

Check that msn.host.com is the same as the 'jid' setting from config.py and that XXXX is the same as the 'port' setting. Also 'secret' must correspond, and the 'mainServer' setting should be pointing to the same interface as the <ip/> tag is (in this example the loopback interface is used. So 'mainServer' would be '127.0.0.1').

You must also add this to the browse section of your jabber.xml file

 <service type="msn" jid="msn.host.com" name="MSN Transport">
   <ns>jabber:iq:register</ns>
 </service>

Once again, msn.host.com must correspond to the 'jid' setting in config.py

Once you have made all these changes, restart your Jabberd1.4.x server, then start PyMSNt and it should all work.

Usage Guide

On Linux you can now run the transport by executing the PyMSNt script.
On Windows you can run it by opening a DOS console in the PyMSNt/src directory and running "python main.py"
If this does not work make sure you have Python installed correctly (as well as all of Twisted and PyCrypto/PyOpenSSL), and that python.exe is in your PATH (see above).
See the User's Guide to PyMSNt for more details on using the transport

Bug reports and comments go to James Bunton
I'll gladly help you with any problems, but please look through this wiki, the README & config.py files first.

Add a comment

Edit this page

Want to get notified on updates of this page?
Subscribe to this page's RSS feed: http://jabbermanual.jabberstudio.org/docs/pymsnt.rdf

Admin panel
(no unhandled propositions)