SipInstallation

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