SipInstallation

Version 196 (Adrian Georgescu, 04/11/2014 01:32 pm)

1 180 Adrian Georgescu
h1. Installation Instructions
2 1 Adrian Georgescu
3 1 Adrian Georgescu
4 157 Adrian Georgescu
h2. Prerequisites
5 157 Adrian Georgescu
6 157 Adrian Georgescu
7 1 Adrian Georgescu
The following platforms have been tested and are fully supported:
8 1 Adrian Georgescu
9 157 Adrian Georgescu
* Linux Debian and Ubuntu (i386 and amd64 architectures)
10 193 Adrian Georgescu
* MacOSX 10.6, 10.7, 10.8, 10.9 (Intel 32 bit architecture)
11 157 Adrian Georgescu
* Microsoft Windows (XP, Vista and 7)
12 117 Adrian Georgescu
13 157 Adrian Georgescu
h2. Current Version
14 157 Adrian Georgescu
15 196 Adrian Georgescu
Released on April 11th, 2014
16 1 Adrian Georgescu
17 157 Adrian Georgescu
| *Package Name* | *Version*|*Description*|
18 196 Adrian Georgescu
| python-sipsimple |1.3.0| SIP SIMPLE Client SDK|
19 189 Adrian Georgescu
| python-msrplib |0.15.0| MSRP client library|
20 163 Adrian Georgescu
| python-xcaplib |1.0.17| XCAP client library|
21 196 Adrian Georgescu
| sipclients| 1.3.0 | Command Line Tools|
22 193 Adrian Georgescu
23 97 Adrian Georgescu
24 157 Adrian Georgescu
h2. Tar Archives
25 157 Adrian Georgescu
26 157 Adrian Georgescu
27 1 Adrian Georgescu
The software is available as a tar archive at:
28 1 Adrian Georgescu
29 1 Adrian Georgescu
http://download.ag-projects.com/SipClient/
30 1 Adrian Georgescu
31 97 Adrian Georgescu
32 157 Adrian Georgescu
h2. Debian Packages
33 157 Adrian Georgescu
34 172 Adrian Georgescu
The location of repositories are "here":http://projects.ag-projects.com/projects/documentation/wiki/Repositories
35 1 Adrian Georgescu
36 1 Adrian Georgescu
Update the list of available packages:
37 1 Adrian Georgescu
38 157 Adrian Georgescu
<pre>
39 1 Adrian Georgescu
sudo apt-get update
40 157 Adrian Georgescu
</pre>
41 1 Adrian Georgescu
42 180 Adrian Georgescu
Install SIP SIMPLE Client SDK:
43 1 Adrian Georgescu
44 157 Adrian Georgescu
<pre>
45 137 Adrian Georgescu
sudo apt-get install python-sipsimple
46 157 Adrian Georgescu
</pre>
47 1 Adrian Georgescu
48 1 Adrian Georgescu
Install Command Line Tools:
49 1 Adrian Georgescu
50 157 Adrian Georgescu
<pre>
51 1 Adrian Georgescu
sudo apt-get install sipclients 
52 157 Adrian Georgescu
</pre>
53 1 Adrian Georgescu
54 191 Adrian Georgescu
h3. Ubuntu Precise
55 1 Adrian Georgescu
56 191 Adrian Georgescu
Ubuntu Precise 12.04 has changed libgcrypt11 package in a way that breaks python-simple. To overcome this problem, install this package:
57 98 Adrian Georgescu
58 191 Adrian Georgescu
<pre>
59 191 Adrian Georgescu
sudo apt-get install libgcrypt11=1.5.0-3ububtu0.1+agp
60 192 Adrian Georgescu
</pre>
61 191 Adrian Georgescu
62 191 Adrian Georgescu
63 191 Adrian Georgescu
64 157 Adrian Georgescu
h2. Version Control Repository
65 78 Adrian Georgescu
66 78 Adrian Georgescu
67 177 Adrian Georgescu
The trunk is stable and recommended for anyone that wishes to use the library. The project policy is to add only tested code to the main repository. Known issues are listed in the "tickets interface":http://sipsimpleclient.org/report.
68 70 Adrian Georgescu
69 157 Adrian Georgescu
The source code is managed using "darcs":http://darcs.net version control tool. The darcs repository can be fetched with:
70 157 Adrian Georgescu
71 1 Adrian Georgescu
72 158 Adrian Georgescu
h3. SIP SIMPLE Client SDK
73 1 Adrian Georgescu
74 1 Adrian Georgescu
<pre>
75 1 Adrian Georgescu
darcs get http://devel.ag-projects.com/repositories/python-sipsimple
76 158 Adrian Georgescu
</pre>
77 158 Adrian Georgescu
78 159 Adrian Georgescu
h4. Dependencies
79 159 Adrian Georgescu
80 159 Adrian Georgescu
Several dependencies provided by AG Projects can be accessed in the same way:
81 159 Adrian Georgescu
82 158 Adrian Georgescu
<pre>
83 179 Adrian Georgescu
darcs get http://devel.ag-projects.com/repositories/python-xcaplib
84 179 Adrian Georgescu
darcs get http://devel.ag-projects.com/repositories/python-msrplib
85 179 Adrian Georgescu
darcs get http://devel.ag-projects.com/repositories/python-application
86 179 Adrian Georgescu
darcs get http://devel.ag-projects.com/repositories/python-backports
87 179 Adrian Georgescu
darcs get http://devel.ag-projects.com/repositories/python-gnutls
88 179 Adrian Georgescu
darcs get http://devel.ag-projects.com/repositories/python-cjson
89 179 Adrian Georgescu
darcs get http://devel.ag-projects.com/repositories/python-greenlet
90 179 Adrian Georgescu
darcs get http://devel.ag-projects.com/repositories/python-eventlib
91 67 Adrian Georgescu
</pre>
92 1 Adrian Georgescu
93 157 Adrian Georgescu
h3. Command Line Tools
94 157 Adrian Georgescu
95 157 Adrian Georgescu
96 157 Adrian Georgescu
<pre>
97 155 Adrian Georgescu
darcs get http://devel.ag-projects.com/repositories/sipclients
98 157 Adrian Georgescu
</pre>
99 155 Adrian Georgescu
100 155 Adrian Georgescu
To obtain the incremental changes after the initial get, go to the python-sipsimple and sipclients directory and run:
101 1 Adrian Georgescu
102 1 Adrian Georgescu
<pre>
103 1 Adrian Georgescu
darcs pull -a
104 1 Adrian Georgescu
</pre>
105 1 Adrian Georgescu
106 1 Adrian Georgescu
h2. Dependencies
107 1 Adrian Georgescu
108 190 Adrian Georgescu
 * python                   http://python.org                                2.7
109 163 Adrian Georgescu
 * python-application       http://pypi.python.org/simple/python-application  >=1.4.0
110 163 Adrian Georgescu
 * python-backports         http://download.ag-projects.com/SipClient         >=1.0.0
111 163 Adrian Georgescu
 * python-cjson             http://pypi.python.org/pypi/python-cjson/         >=1.0.5
112 163 Adrian Georgescu
 * python-dateutil          http://niemeyer.net/python-dateutil                 >=1.4
113 181 Adrian Georgescu
 * python-eventlib          http://download.ag-projects.com/SipClient         >=0.1.1
114 163 Adrian Georgescu
 * python-greenlet          http://download.ag-projects.com/SipClient          =0.4.0
115 163 Adrian Georgescu
 * python-gnutls            http://pypi.python.org/simple/python-gnutls       >=1.1.9
116 163 Adrian Georgescu
 * python-lxml              http://codespeak.net/lxml                         >=2.1.2
117 163 Adrian Georgescu
 * python-msrplib           http://download.ag-projects.com/MSRP             >=0.15.0
118 163 Adrian Georgescu
 * python-xcaplib           http://download.ag-projects.com/XCAP             >=1.0.17
119 163 Adrian Georgescu
 * cython                   http://www.cython.org                            >=0.13.0
120 163 Adrian Georgescu
 * dnspython                http://www.dnspython.org                          >=1.6.0
121 163 Adrian Georgescu
 * twisted                  http://twistedmatrix.com/trac                     >=8.1.0
122 1 Adrian Georgescu
 * zope-interface           http://www.zope.org                               >=3.3.1
123 175 Adrian Georgescu
124 176 Adrian Georgescu
For how to build the dependencies see the documentation that comes with each package. Do no ask us how to build the required dependencies because it is as difficult as having people landed on the Moon, which is not even certain it actually happened.
125 157 Adrian Georgescu
126 157 Adrian Georgescu
h2. Building Instructions
127 157 Adrian Georgescu
128 124 Adrian Georgescu
129 106 Adrian Georgescu
Complete building and installation instructions for the corresponding platforms are available in the doc folder that comes with the source code:
130 157 Adrian Georgescu
131 157 Adrian Georgescu
| Install.linux |  Generic Linux | 
132 157 Adrian Georgescu
| Install.debian |  Debian Linux |  
133 157 Adrian Georgescu
| Install.ubuntu |  Ubuntu Linux |  
134 157 Adrian Georgescu
| Install.windows  | Microsoft Windows | 
135 161 Adrian Georgescu
| Install.osx-10.6  | MacOSX 10.6 Snow Leopard | 
136 163 Adrian Georgescu
| Install.osx-10.7  | MacOSX 10.7 Lion| 
137 186 Adrian Georgescu
| Install.osx-10.8  | MacOSX 10.8 Mountain Lion| 
138 190 Adrian Georgescu
139 190 Adrian Georgescu
140 190 Adrian Georgescu
h2. Testing
141 190 Adrian Georgescu
142 190 Adrian Georgescu
143 190 Adrian Georgescu
To test SIP SIMPLE Client SDK, you can use the Command Line Tools provided by the sipclients package. Command Line Tools are compatible with MacOSX and Linux only.
144 190 Adrian Georgescu
145 190 Adrian Georgescu
See [[SipTesting|Testing]] page for how to test the SDK.