Project

General

Profile

Wiki » History » Version 8

Adrian Georgescu, 05/08/2012 05:51 PM

1 2 Tijmen de Mes
h1. Description 
2
3 4 Tijmen de Mes
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.
4 3 Adrian Georgescu
5 4 Tijmen de Mes
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).
6 1 Tijmen de Mes
7 4 Tijmen de Mes
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.
8 1 Tijmen de Mes
9 4 Tijmen de Mes
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.
10 5 Adrian Georgescu
11 8 Adrian Georgescu
h1. Documentation
12
13
http://projects.ag-projects.com/projects/sipsimpleclient/wiki/SipMSRPApi
14 1 Tijmen de Mes
15 7 Adrian Georgescu
h1. Installation
16 1 Tijmen de Mes
17 6 Adrian Georgescu
h2. Tar Archives
18
19 5 Adrian Georgescu
The software is available as a tar archive at:
20
21
http://download.ag-projects.com/SipClient/
22
23
24
h2. Debian Packages
25
26
27
Install the AG Projects debian software signing key:
28
29
<pre>
30
wget http://download.ag-projects.com/agp-debian-gpg.key
31
sudo apt-key add agp-debian-gpg.key
32
</pre>
33
34
Add these lines to /etc/apt/sources.list:
35
36
37
h3. Debian Stable (Squeeze)
38
39
40
<pre>
41
# AG Projects software
42
deb	http://ag-projects.com/debian stable main
43
deb-src http://ag-projects.com/debian stable main
44
</pre>
45
46
47
h3. Debian Unstable (Sid)
48
49
50
<pre>
51
# AG Projects software
52
deb	http://ag-projects.com/debian unstable main
53
deb-src http://ag-projects.com/debian unstable main
54
</pre>
55
56
57
58
h3. Ubuntu Lucid (10.04)  
59
60
61
<pre>
62
# AG Projects software
63
deb	http://ag-projects.com/ubuntu lucid main
64
deb-src http://ag-projects.com/ubuntu lucid main
65
</pre>
66
67
68
h3. Ubuntu Maverick (10.10) 
69
70
71
<pre>
72
# AG Projects software
73
deb	http://ag-projects.com/ubuntu maverick main
74
deb-src http://ag-projects.com/ubuntu maverick main
75
</pre>
76
77
78
h3. Ubuntu Natty (11.04) 
79
80
81
<pre>
82
# AG Projects software
83
deb	http://ag-projects.com/ubuntu natty main
84
deb-src http://ag-projects.com/ubuntu natty main
85
</pre>
86
87
88
h3. Ubuntu Oneiric (11.10) 
89
90
91
<pre>
92
# AG Projects software
93
deb	http://ag-projects.com/ubuntu oneiric main
94
deb-src http://ag-projects.com/ubuntu oneiric main
95
</pre>
96
97
Install the software:
98
99
<pre>
100
sudo apt-get update
101
sudo apt-get install python-msrplib
102
</pre>
103 1 Tijmen de Mes
104 5 Adrian Georgescu
105 6 Adrian Georgescu
h2. Source Code
106 5 Adrian Georgescu
107
The source code is managed using "darcs":http://darcs.net version control tool. The darcs repository can be fetched with:
108
109
<pre>
110 1 Tijmen de Mes
darcs get http://devel.ag-projects.com/repositories/python-msrplib
111
</pre>
112 6 Adrian Georgescu
113
To manually install the software 
114
<pre>
115
sudo python setup.py install
116
</pre>
117