Wiki

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