Wiki

Version 10 (Tijmen de Mes, 05/08/2012 06:09 pm)

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