SipInstallation

Version 161 (Adrian Georgescu, 05/01/2012 12:34 pm)

1 157 Adrian Georgescu
h1. Installation
2 1 Adrian Georgescu
3 1 Adrian Georgescu
4 157 Adrian Georgescu
5 157 Adrian Georgescu
6 157 Adrian Georgescu
7 157 Adrian Georgescu
h2. Prerequisites
8 157 Adrian Georgescu
9 157 Adrian Georgescu
10 1 Adrian Georgescu
The following platforms have been tested and are fully supported:
11 1 Adrian Georgescu
12 157 Adrian Georgescu
* Linux Debian and Ubuntu (i386 and amd64 architectures)
13 157 Adrian Georgescu
* MacOSX 10.6 and 10.7 (Intel 32 bit architecture)
14 157 Adrian Georgescu
* Microsoft Windows (XP, Vista and 7)
15 117 Adrian Georgescu
16 1 Adrian Georgescu
17 157 Adrian Georgescu
h2. Current Version
18 157 Adrian Georgescu
19 157 Adrian Georgescu
20 148 Adrian Georgescu
Released on December 20th, 2011
21 156 Adrian Georgescu
22 157 Adrian Georgescu
| *Package Name* | *Version*|*Description*|
23 157 Adrian Georgescu
| python-sipsimple |0.20.0| SIP SIMPLE client SDK|
24 157 Adrian Georgescu
| python-msrplib |0.14.2| MSRP client library|
25 157 Adrian Georgescu
| python-xcaplib |1.0.16| XCAP client library|
26 157 Adrian Georgescu
| sipclients| 0.20.0 | Command Line Tools|
27 1 Adrian Georgescu
28 97 Adrian Georgescu
29 157 Adrian Georgescu
h2. Tar Archives
30 157 Adrian Georgescu
31 157 Adrian Georgescu
32 1 Adrian Georgescu
The software is available as a tar archive at:
33 1 Adrian Georgescu
34 1 Adrian Georgescu
http://download.ag-projects.com/SipClient/
35 1 Adrian Georgescu
36 97 Adrian Georgescu
37 157 Adrian Georgescu
h2. Debian Packages
38 157 Adrian Georgescu
39 157 Adrian Georgescu
40 1 Adrian Georgescu
Install the AG Projects debian software signing key:
41 1 Adrian Georgescu
42 157 Adrian Georgescu
<pre>
43 1 Adrian Georgescu
wget http://download.ag-projects.com/agp-debian-gpg.key
44 97 Adrian Georgescu
sudo apt-key add agp-debian-gpg.key
45 157 Adrian Georgescu
</pre>
46 70 Adrian Georgescu
47 1 Adrian Georgescu
Add these lines to /etc/apt/sources.list:
48 1 Adrian Georgescu
49 1 Adrian Georgescu
50 157 Adrian Georgescu
h3. Debian Stable (Squeeze)
51 157 Adrian Georgescu
52 157 Adrian Georgescu
53 157 Adrian Georgescu
<pre>
54 1 Adrian Georgescu
# AG Projects software
55 1 Adrian Georgescu
deb	http://ag-projects.com/debian stable main
56 1 Adrian Georgescu
deb-src http://ag-projects.com/debian stable main
57 157 Adrian Georgescu
</pre>
58 100 Adrian Georgescu
59 100 Adrian Georgescu
60 157 Adrian Georgescu
h3. Debian Unstable (Sid)
61 157 Adrian Georgescu
62 157 Adrian Georgescu
63 157 Adrian Georgescu
<pre>
64 1 Adrian Georgescu
# AG Projects software
65 1 Adrian Georgescu
deb	http://ag-projects.com/debian unstable main
66 1 Adrian Georgescu
deb-src http://ag-projects.com/debian unstable main
67 157 Adrian Georgescu
</pre>
68 1 Adrian Georgescu
69 1 Adrian Georgescu
70 1 Adrian Georgescu
71 157 Adrian Georgescu
h3. Ubuntu Lucid (10.04)  
72 157 Adrian Georgescu
73 157 Adrian Georgescu
74 157 Adrian Georgescu
<pre>
75 147 Adrian Georgescu
# AG Projects software
76 147 Adrian Georgescu
deb	http://ag-projects.com/ubuntu lucid main
77 1 Adrian Georgescu
deb-src http://ag-projects.com/ubuntu lucid main
78 157 Adrian Georgescu
</pre>
79 147 Adrian Georgescu
80 1 Adrian Georgescu
81 157 Adrian Georgescu
h3. Ubuntu Maverick (10.10) 
82 157 Adrian Georgescu
83 157 Adrian Georgescu
84 157 Adrian Georgescu
<pre>
85 1 Adrian Georgescu
# AG Projects software
86 1 Adrian Georgescu
deb	http://ag-projects.com/ubuntu maverick main
87 84 Adrian Georgescu
deb-src http://ag-projects.com/ubuntu maverick main
88 157 Adrian Georgescu
</pre>
89 1 Adrian Georgescu
90 1 Adrian Georgescu
91 157 Adrian Georgescu
h3. Ubuntu Natty (11.04) 
92 157 Adrian Georgescu
93 157 Adrian Georgescu
94 157 Adrian Georgescu
<pre>
95 1 Adrian Georgescu
# AG Projects software
96 1 Adrian Georgescu
deb	http://ag-projects.com/ubuntu natty main
97 1 Adrian Georgescu
deb-src http://ag-projects.com/ubuntu natty main
98 157 Adrian Georgescu
</pre>
99 1 Adrian Georgescu
100 1 Adrian Georgescu
101 157 Adrian Georgescu
h3. Ubuntu Oneiric (11.10) 
102 157 Adrian Georgescu
103 157 Adrian Georgescu
104 157 Adrian Georgescu
<pre>
105 1 Adrian Georgescu
# AG Projects software
106 1 Adrian Georgescu
deb	http://ag-projects.com/ubuntu oneiric main
107 1 Adrian Georgescu
deb-src http://ag-projects.com/ubuntu oneiric main
108 157 Adrian Georgescu
</pre>
109 1 Adrian Georgescu
110 1 Adrian Georgescu
Update the list of available packages:
111 1 Adrian Georgescu
112 157 Adrian Georgescu
<pre>
113 1 Adrian Georgescu
sudo apt-get update
114 157 Adrian Georgescu
</pre>
115 1 Adrian Georgescu
116 1 Adrian Georgescu
Install SIP SIMPLE client SDK:
117 1 Adrian Georgescu
118 157 Adrian Georgescu
<pre>
119 137 Adrian Georgescu
sudo apt-get install python-sipsimple
120 157 Adrian Georgescu
</pre>
121 1 Adrian Georgescu
122 1 Adrian Georgescu
Install Command Line Tools:
123 1 Adrian Georgescu
124 157 Adrian Georgescu
<pre>
125 1 Adrian Georgescu
sudo apt-get install sipclients 
126 157 Adrian Georgescu
</pre>
127 1 Adrian Georgescu
128 1 Adrian Georgescu
129 98 Adrian Georgescu
130 157 Adrian Georgescu
h2. Version Control Repository
131 78 Adrian Georgescu
132 78 Adrian Georgescu
133 157 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.com/report.
134 70 Adrian Georgescu
135 157 Adrian Georgescu
The source code is managed using "darcs":http://darcs.net version control tool. The darcs repository can be fetched with:
136 157 Adrian Georgescu
137 1 Adrian Georgescu
138 158 Adrian Georgescu
h3. SIP SIMPLE Client SDK
139 1 Adrian Georgescu
140 1 Adrian Georgescu
<pre>
141 1 Adrian Georgescu
darcs get http://devel.ag-projects.com/repositories/python-sipsimple
142 158 Adrian Georgescu
</pre>
143 158 Adrian Georgescu
144 159 Adrian Georgescu
h4. Dependencies
145 159 Adrian Georgescu
146 159 Adrian Georgescu
Several dependencies provided by AG Projects can be accessed in the same way:
147 159 Adrian Georgescu
148 158 Adrian Georgescu
<pre>
149 160 Adrian Georgescu
* darcs get http://devel.ag-projects.com/repositories/python-xcaplib
150 160 Adrian Georgescu
* darcs get http://devel.ag-projects.com/repositories/python-msrplib
151 160 Adrian Georgescu
* darcs get http://devel.ag-projects.com/repositories/python-application
152 160 Adrian Georgescu
* darcs get http://devel.ag-projects.com/repositories/python-backports
153 160 Adrian Georgescu
* darcs get http://devel.ag-projects.com/repositories/python-gnutls
154 160 Adrian Georgescu
* darcs get http://devel.ag-projects.com/repositories/python-cjson
155 160 Adrian Georgescu
* darcs get http://devel.ag-projects.com/repositories/python-greenlet
156 160 Adrian Georgescu
* darcs get http://devel.ag-projects.com/repositories/python-eventlet
157 1 Adrian Georgescu
</pre>
158 67 Adrian Georgescu
159 1 Adrian Georgescu
160 157 Adrian Georgescu
h3. Command Line Tools
161 157 Adrian Georgescu
162 157 Adrian Georgescu
163 157 Adrian Georgescu
<pre>
164 155 Adrian Georgescu
darcs get http://devel.ag-projects.com/repositories/sipclients
165 157 Adrian Georgescu
</pre>
166 155 Adrian Georgescu
167 155 Adrian Georgescu
To obtain the incremental changes after the initial get, go to the python-sipsimple and sipclients directory and run:
168 1 Adrian Georgescu
169 157 Adrian Georgescu
<pre>
170 155 Adrian Georgescu
darcs pull -a
171 157 Adrian Georgescu
</pre>
172 155 Adrian Georgescu
173 156 Adrian Georgescu
174 157 Adrian Georgescu
h2. Dependencies
175 155 Adrian Georgescu
176 155 Adrian Georgescu
177 157 Adrian Georgescu
* python                   http://python.org                                2.6, 2.7
178 157 Adrian Georgescu
* python-application       http://pypi.python.org/simple/python-application  >=1.2.8
179 157 Adrian Georgescu
* python-backports         http://download.ag-projects.com/SipClient         >=1.0.0
180 157 Adrian Georgescu
* python-cjson             http://pypi.python.org/pypi/python-cjson/         >=1.0.5
181 157 Adrian Georgescu
* python-dateutil          http://niemeyer.net/python-dateutil                 >=1.4
182 157 Adrian Georgescu
* python-eventlet          http://download.ag-projects.com/SipClient         =0.8.11
183 157 Adrian Georgescu
* python-greenlet          http://download.ag-projects.com/SipClient          =0.4.0
184 157 Adrian Georgescu
* python-gnutls            http://pypi.python.org/simple/python-gnutls       >=1.1.9
185 157 Adrian Georgescu
* python-lxml              http://codespeak.net/lxml                         >=2.1.2
186 157 Adrian Georgescu
* python-msrplib           http://download.ag-projects.com/MSRP             >=0.14.2
187 157 Adrian Georgescu
* python-xcaplib           http://download.ag-projects.com/XCAP             >=1.0.15
188 157 Adrian Georgescu
* cython                   http://www.cython.org                    >=0.13.0 & <0.15
189 157 Adrian Georgescu
* dnspython                http://www.dnspython.org                          >=1.6.0
190 157 Adrian Georgescu
* twisted                  http://twistedmatrix.com/trac                     >=8.1.0
191 157 Adrian Georgescu
* zope-interface           http://www.zope.org                               >=3.3.1
192 157 Adrian Georgescu
* Python Imaging Library   http://pypi.python.org/pypi/PIL/                  >=1.1.6
193 157 Adrian Georgescu
194 157 Adrian Georgescu
195 157 Adrian Georgescu
h2. Building Instructions
196 157 Adrian Georgescu
197 157 Adrian Georgescu
198 124 Adrian Georgescu
Complete building and installation instructions for the corresponding platforms are available in the doc folder that comes with the source code:
199 106 Adrian Georgescu
200 157 Adrian Georgescu
| Install.linux |  Generic Linux | 
201 157 Adrian Georgescu
| Install.debian |  Debian Linux |  
202 157 Adrian Georgescu
| Install.ubuntu |  Ubuntu Linux |  
203 157 Adrian Georgescu
| Install.windows  | Microsoft Windows | 
204 157 Adrian Georgescu
| Install.osx-10.6  | MacOSX 10.6 Snow Leopard | 
205 161 Adrian Georgescu
| Install.osx-10.7  | MacOSX 10.7 Lion and Mountain Lion| 
206 1 Adrian Georgescu
207 1 Adrian Georgescu
208 157 Adrian Georgescu
h2. Audio Device Sharing
209 1 Adrian Georgescu
210 1 Adrian Georgescu
211 157 Adrian Georgescu
For audio device sharing on Linux see [[SipAudioDeviceSharingLinux|Audio Device Sharing]]
212 157 Adrian Georgescu
213 157 Adrian Georgescu
214 157 Adrian Georgescu
h2. Testing
215 157 Adrian Georgescu
216 157 Adrian Georgescu
217 1 Adrian Georgescu
To test SIP SIMPLE client SDK, you can use the Command Line Tools provided by the sipclients package. The Command Line Tools are compatible with MacOSX and Linux only.
218 1 Adrian Georgescu
219 157 Adrian Georgescu
See [[SipTesting|Testing]] page for how to test the SDK.