Wiki

Version 5 (Adrian Georgescu, 05/08/2012 05:38 pm) → Version 6/10 (Adrian Georgescu, 05/08/2012 05:40 pm)

h1. Description

This library implements Message Session Relay Protocol (MSRP). MSRP is defined in RFC 4975. The relay extension that can be used for NAT traversal purposes is defined in RFC 4976.

Message Session Relay Protocol (MSRP) is a protocol for transmitting a series of related instant messages in the context of a session. Message sessions are treated like any other media stream when set up via a rendezvous or session creation protocol such as the Session Initiation Protocol (SIP).

A series of related instant messages between two or more parties can be viewed as part of a "message session", that is, a conversational exchange of messages with a definite beginning and end. This is in contrast to individual messages each sent independently. Messaging schemes that track only individual messages can be described as "page-mode" messaging, whereas messaging that is part of a "session" with a definite start and end is called "session-mode" messaging.

Page-mode messaging is enabled in SIP via the SIP MESSAGE method, as defined in RFC 3428. Session-mode messaging has a number of benefits over page-mode messaging, however, such as explicit rendezvous, tighter integration with other media-types, direct client-to-client operation, and brokered privacy and security.

h1. Installtion


h2. Tar Archives



The software is available as a tar archive at:

http://download.ag-projects.com/SipClient/

h2. Debian Packages

Install the AG Projects debian software signing key:

<pre>
wget http://download.ag-projects.com/agp-debian-gpg.key
sudo apt-key add agp-debian-gpg.key
</pre>

Add these lines to /etc/apt/sources.list:

h3. Debian Stable (Squeeze)

<pre>
# AG Projects software
deb http://ag-projects.com/debian stable main
deb-src http://ag-projects.com/debian stable main
</pre>

h3. Debian Unstable (Sid)

<pre>
# AG Projects software
deb http://ag-projects.com/debian unstable main
deb-src http://ag-projects.com/debian unstable main
</pre>

h3. Ubuntu Lucid (10.04)

<pre>
# AG Projects software
deb http://ag-projects.com/ubuntu lucid main
deb-src http://ag-projects.com/ubuntu lucid main
</pre>

h3. Ubuntu Maverick (10.10)

<pre>
# AG Projects software
deb http://ag-projects.com/ubuntu maverick main
deb-src http://ag-projects.com/ubuntu maverick main
</pre>

h3. Ubuntu Natty (11.04)

<pre>
# AG Projects software
deb http://ag-projects.com/ubuntu natty main
deb-src http://ag-projects.com/ubuntu natty main
</pre>

h3. Ubuntu Oneiric (11.10)

<pre>
# AG Projects software
deb http://ag-projects.com/ubuntu oneiric main
deb-src http://ag-projects.com/ubuntu oneiric main
</pre>

Install the software:

<pre>
sudo apt-get update
sudo apt-get install python-msrplib
</pre>

h2. h3. Source Code

The source code is managed using "darcs":http://darcs.net version control tool. The darcs repository can be fetched with:

<pre>
darcs get http://devel.ag-projects.com/repositories/python-msrplib
</pre>

To manually install the software
<pre>
sudo python setup.py install
</pre>