Project

General

Profile

Edit History

Wiki » History » Version 9

Tijmen de Mes, 05/08/2012 06:09 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
    9
    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
    
    
    





    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