Project

General

Profile

Edit History

Wiki » History » Version 7

Adrian Georgescu, 05/08/2012 05:41 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
    1
    Tijmen de Mes
    





    12
    7
    Adrian Georgescu
    
h1. Installation





    13
    1
    Tijmen de Mes
    





    14
    6
    Adrian Georgescu
    
h2. Tar Archives





    15
    
    
    





    16
    5
    Adrian Georgescu
    
The software is available as a tar archive at:





    17
    
    
    





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





    19
    
    
    





    20
    
    
    





    21
    
    
    
h2. Debian Packages





    22
    
    
    





    23
    
    
    





    24
    
    
    
Install the AG Projects debian software signing key:





    25
    
    
    





    26
    
    
    
<pre>





    27
    
    
    
wget http://download.ag-projects.com/agp-debian-gpg.key





    28
    
    
    
sudo apt-key add agp-debian-gpg.key





    29
    
    
    
</pre>





    30
    
    
    





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





    32
    
    
    





    33
    
    
    





    34
    
    
    
h3. Debian Stable (Squeeze)





    35
    
    
    





    36
    
    
    





    37
    
    
    
<pre>





    38
    
    
    
# AG Projects software





    39
    
    
    
deb	http://ag-projects.com/debian stable main





    40
    
    
    
deb-src http://ag-projects.com/debian stable main





    41
    
    
    
</pre>





    42
    
    
    





    43
    
    
    





    44
    
    
    
h3. Debian Unstable (Sid)





    45
    
    
    





    46
    
    
    





    47
    
    
    
<pre>





    48
    
    
    
# AG Projects software





    49
    
    
    
deb	http://ag-projects.com/debian unstable main





    50
    
    
    
deb-src http://ag-projects.com/debian unstable main





    51
    
    
    
</pre>





    52
    
    
    





    53
    
    
    





    54
    
    
    





    55
    
    
    
h3. Ubuntu Lucid (10.04)  





    56
    
    
    





    57
    
    
    





    58
    
    
    
<pre>





    59
    
    
    
# AG Projects software





    60
    
    
    
deb	http://ag-projects.com/ubuntu lucid main





    61
    
    
    
deb-src http://ag-projects.com/ubuntu lucid main





    62
    
    
    
</pre>





    63
    
    
    





    64
    
    
    





    65
    
    
    
h3. Ubuntu Maverick (10.10) 





    66
    
    
    





    67
    
    
    





    68
    
    
    
<pre>





    69
    
    
    
# AG Projects software





    70
    
    
    
deb	http://ag-projects.com/ubuntu maverick main





    71
    
    
    
deb-src http://ag-projects.com/ubuntu maverick main





    72
    
    
    
</pre>





    73
    
    
    





    74
    
    
    





    75
    
    
    
h3. Ubuntu Natty (11.04) 





    76
    
    
    





    77
    
    
    





    78
    
    
    
<pre>





    79
    
    
    
# AG Projects software





    80
    
    
    
deb	http://ag-projects.com/ubuntu natty main





    81
    
    
    
deb-src http://ag-projects.com/ubuntu natty main





    82
    
    
    
</pre>





    83
    
    
    





    84
    
    
    





    85
    
    
    
h3. Ubuntu Oneiric (11.10) 





    86
    
    
    





    87
    
    
    





    88
    
    
    
<pre>





    89
    
    
    
# AG Projects software





    90
    
    
    
deb	http://ag-projects.com/ubuntu oneiric main





    91
    
    
    
deb-src http://ag-projects.com/ubuntu oneiric main





    92
    
    
    
</pre>





    93
    
    
    





    94
    
    
    
Install the software:





    95
    
    
    





    96
    
    
    
<pre>





    97
    
    
    
sudo apt-get update





    98
    
    
    
sudo apt-get install python-msrplib





    99
    
    
    
</pre>





    100
    1
    Tijmen de Mes
    





    101
    5
    Adrian Georgescu
    





    102
    6
    Adrian Georgescu
    
h2. Source Code





    103
    5
    Adrian Georgescu
    





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





    105
    
    
    





    106
    
    
    
<pre>





    107
    1
    Tijmen de Mes
    
darcs get http://devel.ag-projects.com/repositories/python-msrplib





    108
    
    
    
</pre>





    109
    6
    Adrian Georgescu
    





    110
    
    
    
To manually install the software 





    111
    
    
    
<pre>





    112
    
    
    
sudo python setup.py install





    113
    
    
    
</pre>





    114