Browse code

doc:update build instruction to new debian pkg dir

Stefan Sayer authored on 08/04/2014 12:11:11
Showing 1 changed files
... ...
@@ -230,7 +230,7 @@ Creating packages on debian (ubuntu, ...), here for wheezy:
230 230
    or, for git master:
231 231
    $ git clone git://git.sip-router.org/sems
232 232
 
233
-   $ cd sems-x.y.z ; ln -s pkg/debian .
233
+   $ cd sems-x.y.z ; ln -s pkg/deb/debian .
234 234
 
235 235
    set version in changelog if not correct
236 236
    $ dch -v x.y.z "SEMS x.y.z release"
Browse code

doc: updated debian package creation

Stefan Sayer authored on 01/04/2014 10:01:02
Showing 1 changed files
... ...
@@ -215,22 +215,27 @@ How to get started with SEMS:
215 215
   applications, see the explanation of 'application' parameter in 
216 216
   sems.conf.
217 217
 
218
-Creating packages on debian (ubuntu, ...):
218
+Creating packages on debian (ubuntu, ...), here for wheezy:
219 219
 
220 220
    install debian package build tools:
221 221
    $ sudo apt-get install debhelper devscripts
222 222
 
223 223
    install dependencies:
224 224
    $  sudo apt-get install g++ make libspandsp-dev flite-dev libspeex-dev \
225
-         libssl-dev python-dev python-sip4-dev openssl sip4 libev-dev \
226
-         libmysql++-dev
225
+         libssl-dev python-dev python-sip-dev openssl libev-dev \
226
+         libmysql++-dev libevent-dev libxml2-dev libcurl4-openssl-dev
227 227
    
228 228
    get the source: 
229 229
    $ wget ftp.iptel.org/pub/sems/sems-x.y.z.tar.gz ; tar xzvf sems-x.y.z.tar.gz
230
+   or, for git master:
231
+   $ git clone git://git.sip-router.org/sems
232
+
230 233
    $ cd sems-x.y.z ; ln -s pkg/debian .
231 234
 
232 235
    set version in changelog if not correct
233 236
    $ dch -v x.y.z "SEMS x.y.z release"
237
+   or:
238
+   $ dch -b -v `git describe --always` "sems git master"
234 239
    
235 240
    build package:
236 241
    $ dpkg-buildpackage -rfakeroot -us -uc
Browse code

added missing deps for deb packaging to doc

Stefan Sayer authored on 23/05/2011 22:47:51
Showing 1 changed files
... ...
@@ -218,11 +218,12 @@ How to get started with SEMS:
218 218
 Creating packages on debian (ubuntu, ...):
219 219
 
220 220
    install debian package build tools:
221
-   $ apt-get install debhelper devscripts
221
+   $ sudo apt-get install debhelper devscripts
222 222
 
223 223
    install dependencies:
224
-   $  apt-get install g++ make libspandsp-dev flite-dev libspeex-dev \
225
-         libssl-dev python-dev python-sip4-dev openssl
224
+   $  sudo apt-get install g++ make libspandsp-dev flite-dev libspeex-dev \
225
+         libssl-dev python-dev python-sip4-dev openssl sip4 libev-dev \
226
+         libmysql++-dev
226 227
    
227 228
    get the source: 
228 229
    $ wget ftp.iptel.org/pub/sems/sems-x.y.z.tar.gz ; tar xzvf sems-x.y.z.tar.gz
... ...
@@ -234,7 +235,7 @@ Creating packages on debian (ubuntu, ...):
234 235
    build package:
235 236
    $ dpkg-buildpackage -rfakeroot -us -uc
236 237
 
237
-   install package in .. using dpkg.
238
+   install sems and sems-python-modules packages in .. using dpkg.
238 239
 
239 240
 Installed files using 'make install':
240 241
 
Browse code

updated some documentation

Stefan Sayer authored on 28/02/2011 11:06:41
Showing 1 changed files
... ...
@@ -13,7 +13,9 @@ Introduction:
13 13
  in VoIP networks for all applications where server-
14 14
  side processing of audio is required, for example away 
15 15
  or pre-call announcements, voicemail, or network side 
16
- conferencing. 
16
+ conferencing. Another use case is for interconnecting
17
+ SIP networks, where a back-to-back user agent (B2BUA)
18
+ is required.
17 19
 
18 20
  SEMS can be used to implement simple high performance 
19 21
  components like announcement servers as building 
... ...
@@ -22,27 +24,29 @@ Introduction:
22 24
  user agent (B2BUA) and state machine scripting functionality, 
23 25
  complex VoIP services can be realized completely in SEMS. 
24 26
  
25
- SEMS only supports patent free codecs. That means that codecs
26
- like g729 won't be supported. On the other hand, SEMS supports 
27
- all important patent free codecs out of the box (g711u, g711a, 
28
- GSM06.10, speex, G726, L16 and iLBC). Integrating other codecs 
29
- in SEMS is very simple (patented or not).
27
+ SEMS supports all important patent free codecs out of the
28
+ box (g711u, g711a, GSM06.10, speex, G.726, L16 and iLBC).
29
+ There is a wrapper for the IPP G.729 codec implementation
30
+ available. Integrating other codecs in SEMS is very simple
31
+ (patented or not).
30 32
 
31 33
  SEMS shows very good performance on current standard
32 34
  PC architecture based server systems. It has sucessfully
33 35
  been run with 1200 G.711 conference channels on a quad-core
34 36
  Intel(R) Xeon at 2GHz (700 GSM, 280 iLBC channels), and up to 
35
- 5000 channels on a dual quad Xeon at 2.9GHz. On the 
36
- other hand it also runs on very small devices - for example 
37
- small embedded systems like routers running OpenWRT, for which 
38
- of course the achievable channel count is not that high.
37
+ 5000 channels on a dual quad Xeon at 2.9GHz. Its back-to-back
38
+ user agent has been run with up to 19000 TPS on the latter
39
+ machine. On the other hand it also runs on very small devices -
40
+ for example small embedded systems like routers running OpenWRT,
41
+ for which of course the achievable channel count is not that
42
+ high.
39 43
 
40 44
 License:
41 45
 
42 46
  SEMS is free (speech+beer) software. It is licensed under dual 
43
- license terms, the GPL (v2+) and proprietary license. This program
44
- is released under the GPL with the additional exemption that
45
- compiling, linking, and/or using OpenSSL is allowed.
47
+ license terms, the GPL (v2+) and proprietary license. This
48
+ program is released under the GPL with the additional exemption
49
+ that compiling, linking, and/or using OpenSSL is allowed.
46 50
 
47 51
  See doc/COPYING for details.
48 52
 
... ...
@@ -50,21 +54,24 @@ Applications:
50 54
 
51 55
  The following applications are shipped with SEMS :
52 56
 
57
+ Announcements (Prompts, Ringbacktones, Pre-call-prompts):
53 58
   * announcement   plays an announcement
54 59
 
55
-  * voicemail      records voice messages and sends them 
56
-                   as email, saves them to a voicebox, or
57
-                   both
58 60
 
59
-  * conference     enables many people to talk together 
60
-                   at the same time
61
+  * ann_b2b        pre-call-announcement, plays announcement 
62
+                   before connecting the callee in B2BUA mode
63
+ 
64
+  * announce_transfer  pre-call-announcement, plays announcement 
65
+                   and then transfers the caller to the callee 
66
+                   using REFER
61 67
 
62
-  * webconference  conference application that can be 
63
-                   controlled from an external program, 
64
-                   e.g. a website 
68
+  * early_announce (pre-call) announcement using early media (183),
69
+                   optionally continues the call in B2BUA mode
65 70
 
66
-  * echo           test module to echo the caller's voice
67
- 
71
+  * precoded_announce plays preencoded announcements
72
+
73
+
74
+ Voicemail/Mailbox
68 75
   * voicebox       users can dial in to the voicebox to check
69 76
                    their messages
70 77
 
... ...
@@ -75,18 +82,19 @@ Applications:
75 82
                    an IMAP server. Users can dial in to check
76 83
                    their messages (simpler version)
77 84
 
78
-  * ann_b2b        pre-call-announcement, plays announcement 
79
-                   before connecting the callee in B2BUA mode
80
- 
81
-  * announce_transfer  pre-call-announcement, plays announcement 
82
-                   and then transfers the caller to the callee 
83
-                   using REFER
85
+  * voicemail      records voice messages and sends them 
86
+                   as email, saves them to a voicebox, or
87
+                   both
84 88
 
85
-  * early_announce (pre-call) announcement using early media (183),
86
-                   optionally continues the call in B2BUA mode
87 89
 
88
-  * auth_b2b       B2BUA app that changes identity and authenticates
89
-                   second call leg
90
+ Conferencing
91
+
92
+  * conference     enables many people to talk together 
93
+                   at the same time
94
+
95
+  * webconference  conference application that can be 
96
+                   controlled from an external program, 
97
+                   e.g. a website 
90 98
 
91 99
   * conf_auth      collect a PIN number, verify it against an 
92 100
                    XMLRPC authentication server and connects in 
... ...
@@ -95,18 +103,33 @@ Applications:
95 103
   * pin_collect    collect a PIN, optionally verify it, and transfer
96 104
                    the call into a conference
97 105
 
106
+ Back-to-back User Agent
107
+  
108
+  * sbc            flexible SBC application, supports
109
+                    - identity change
110
+                    - header manipulation (filter etc)
111
+                    - (multihomed) RTP relay
112
+                    - SIP authentication 
113
+                    - Session timer, call timer, prepaid
114
+                    etc
115
+ App development
116
+
117
+  * dsm            DSM state machine scripting (use this)
118
+
119
+  * ivr            embedded Python interpreter for simple apps
120
+  
121
+  * py_sems        another embedded Python interpreter
122
+
123
+ Misc
124
+  * echo           test module to echo the caller's voice
125
+ 
126
+
98 127
   * callback       reject the call, call back caller later and have 
99 128
                    her enter a number to call in b2bua with media relay
100 129
                    mode
101 130
 
102 131
   * reg_agent     SIP REGISTER to register SEMS' contact to an aor
103 132
 
104
-  * sw_prepaid_sip prepaid application
105
-  
106
-  * call_timer     B2BUA, ends the call after a certain time
107
-
108
-  * precoded_announce plays preencoded announcements
109
-
110 133
 
111 134
 Developing and customizing Applications and services:
112 135
 
... ...
@@ -141,22 +164,14 @@ Requirements:
141 164
 
142 165
  All requirements are optional.
143 166
 
144
- 1. Python version >= 2.3 for the ivr (embedded python interpreter)
145
-    and py_sems, optional
146
-
147
- 2. flite speech synthesizer for TTS in the ivr, optional
148
-
149
- 3. lame >= 3.95 for mp3 file output, optional. mpg123 for mp3 playback,
150
-    optional
151
-
152
- 4. xmlrpcpp for XMLRPC control, optional
153
-
154
- 5. spandsp library for DTMF detection and PLC, optional
167
+ o Python version >= 2.3 for the ivr (embedded python interpreter)
168
+    and py_sems
169
+ o flite speech synthesizer for TTS in the ivr
170
+ o lame >= 3.95 for mp3 file output, mpg123 for mp3 playback
171
+ o spandsp library for DTMF detection and PLC
155 172
     (SEMS has its own implementations for both)
156
-
157
- 6. libZRTP SDK (http://zfoneproject.com) for ZRTP, optional
158
-
159
- 7. libev for jsonrpc, optional
173
+ o libZRTP SDK (http://zfoneproject.com) for ZRTP
174
+ o libev for jsonrpc
160 175
 
161 176
 How to get started with SEMS:
162 177
 
... ...
@@ -164,85 +179,41 @@ How to get started with SEMS:
164 179
   http://ftp.iptel.org/pub/sems/, unpack and install it 
165 180
   using the usual make && make install. After installation, the 
166 181
   configuration file /usr/local/etc/sems/sems.conf needs to be 
167
-  adapted.
182
+  adapted, especially the parameters "sip_ip", "media_ip",
183
+  "load_plugins", "application".
168 184
 
169
-  On debian, you can add the iptel.org SEMS repository to 
185
+  On Debian and Ubuntu, add the SEMS repository from OBS to 
170 186
   /etc/apt/sources.list:
171
-   deb http://ftp.iptel.org/pub/sems/debian lenny free
172
-   deb-src http://ftp.iptel.org/pub/sems/debian lenny free
173
-  and install SEMS from binary packages with: 
174
-  $ apt-get install sems sems-python-modules
175
-  If you want to build SEMS from source on debian, see below.
176
-
177
-  On Fedora, simply do 
187
+     deb http://download.opensuse.org/repositories/home:/team-sems/Debian_5.0 ./
188
+  and install SEMS packages with: 
189
+   wget http://download.opensuse.org/repositories/home:/team-sems/Debian_5.0/Release.key \
190
+        -O - |apt-key add -   
191
+   apt-get update && apt-get install sems
192
+  If you want to build SEMS from source on debian/derivatives, see below.
193
+
194
+  On Fedora/CentOS, simply do 
178 195
    $ sudo yum install sems
179 196
   and sems package will be installed.
180 197
  
181
-  You can also follow one of the tutorials
182
-  linked from the SEMS homepage
183
-  (e.g. http://www.iptel.org/howto_sems_voicemail).The Application
184
-  Modules Documentation page then gives an overview of the application
185
-  modules that come with SEMS 
198
+  You can also follow one of the tutorials linked from the SEMS homepage
199
+  (e.g. http://ftp.iptel.org/pub/sems/doc/current/howtostart_noproxy.html).
200
+  The Application Modules Documentation page then gives an 
201
+  overview of the application modules that come with SEMS 
186 202
   (http://ftp.iptel.org/pub/sems/doc/current/AppDoc.html).
187 203
   
188 204
   If you are interested in writing your own applications, the 
189 205
   application development tutorial is a good start 
190 206
   (http://www.iptel.org/sems/sems_application_development_tutorial),
191
-  together  with the design overview 
207
+  together with the design overview 
192 208
   (http://www.iptel.org/files/semsng-designoverview.pdf) and the example
193 209
   applications (apps/examples/).
194
-  
195
-Installation:
196
-
197
- 1. Download SEMS 
198
-     Download the source tarball from ftp://ftp.iptel.org/pub/sems/,
199
-     or get the newest version through svn:
200
-      $ svn checkout svn://svn.berlios.de/sems/trunk
201
-       -or-
202
-      $ svn checkout http://svn.berlios.de/svnroot/repos/sems/trunk 
203
-
204
- 2. Compile SEMS
205
-
206
-      $ make all
207
-      $ make install
208
-
209
-    Notice: you don't need to execute 'make install' if you want to 
210
-            run SEMS from the source tree, but in this case some paths 
211
-            in the config files will need to be adapted.
212
-            If you want to install to a different prefix than /usr/local,
213
-            use PREFIX=/some/other/prefix 
214
-     
215
-    For detailed instructions for some modules, have a look at
216
-    doc/COMPILING as well.
217
-
218
- 3. Look at the default configuration file whether it fits your need:
219
-
220
-    If you installed SEMS with 'make install', the configuration
221
-    is at '/usr/local/etc/sems/sems.conf'. 
222
-    Else make your own using sems.conf.sample.
223
-
224
- 4. Start SEMS:
225
-
226
-    If you installed SEMS with 'make install', sems can be
227
-    found at '/usr/local/sbin/sems'.
228
-    If you need help starting 'sems', try 'sems -h'.
229
-
230
- 5. Using SEMS
231
-    
232
-    SEMS needs to be told from the many possible applications that are
233
-    loaded which one to run. You can simply set the application 
234
-    in sems.conf, e.g. application=conference. You can also define an
235
-    application mapping, i.e. numbers (R-URIs) that will be mapped to
236
-    applications, see the explanation of 'application' parameter in 
237
-    sems.conf.
238 210
    
239
-    Alternatively, the SIP-stack-SER can be configured in ser-sems.cfg
240
-    to send all calls directly to one application, in that case the line
241
-     if(!t_write_unix("/tmp/sems_sock","sems/app_headers"))
242
-    in ser-sems.cfg could be changed to e.g.
243
-     if(!t_write_unix("/tmp/sems_sock","conference"))
244
-    A sample ser.cfg file in this style can be found at 
245
-    http://ftp.iptel.org/pub/sems/ser.cfg
211
+  SEMS needs to be told from the many possible applications that are
212
+  loaded which one to run. You can simply set the application 
213
+  in sems.conf, e.g. application=conference. You can also define an
214
+  application mapping, i.e. numbers (R-URIs) that will be mapped to
215
+  applications, see the explanation of 'application' parameter in 
216
+  sems.conf.
246 217
 
247 218
 Creating packages on debian (ubuntu, ...):
248 219
 
... ...
@@ -316,6 +287,7 @@ Authors:
316 287
     Andreas Granig
317 288
     Andrey Samusenko
318 289
     Andriy I Pylypenko
290
+    Anton Zagorskiy
319 291
     B. Oldenburg
320 292
     Balint Kovacs
321 293
     Bogdan Pintea
... ...
@@ -325,6 +297,7 @@ Authors:
325 297
     Jeremy A
326 298
     Jiri Kuthan
327 299
     Juha Heinanen
300
+    Matthew Williams
328 301
     Ovidiu Sas
329 302
     Peter Lemenkov
330 303
     Peter Loeppky
... ...
@@ -333,9 +306,10 @@ Authors:
333 306
     Rui Jin Zheng
334 307
     Tom van der Geer
335 308
     Ulrich Abend
336
-   (if you want to be added or removed from this list, please mail to stefan.sayer@gmail.com)
309
+   (if you feel you should be on this list, please mail to stefan.sayer@gmail.com)
337 310
  
338
-  Special thanks to IPTEGO GmbH and iptelorg GmbH for sponsoring development of SEMS.
311
+  Special thanks to IPTEGO GmbH, iptelorg GmbH and TelTech Systems Inc. for 
312
+  sponsoring development of SEMS.
339 313
 
340 314
 Contributions:
341 315
 
Browse code

added OpenSSL linking exception to license

Stefan Sayer authored on 23/09/2010 14:41:49
Showing 1 changed files
... ...
@@ -40,7 +40,9 @@ Introduction:
40 40
 License:
41 41
 
42 42
  SEMS is free (speech+beer) software. It is licensed under dual 
43
- license terms, the GPL (v2+) and proprietary license.
43
+ license terms, the GPL (v2+) and proprietary license. This program
44
+ is released under the GPL with the additional exemption that
45
+ compiling, linking, and/or using OpenSSL is allowed.
44 46
 
45 47
  See doc/COPYING for details.
46 48
 
Browse code

removed some more obsolete ser-sems stuff

git-svn-id: http://svn.berlios.de/svnroot/repos/sems/trunk@1844 8eb893ce-cfd4-0310-b710-fb5ebe64c474

Stefan Sayer authored on 27/04/2010 11:39:49
Showing 1 changed files
... ...
@@ -139,27 +139,22 @@ Requirements:
139 139
 
140 140
  All requirements are optional.
141 141
 
142
- 1. optional: SER version 0.9.6-sems, or SER 2.0 with SASI:
143
-    SIP Epress Router (www.iptel.org/ser)
144
-
145
-    SEMS has its own SIP stack. SEMS can also use SER as its 
146
-    SIP stack. SEMS & SER communicate through unix socket (0.9.6),
147
-    or binrpc protocol (2.0 SASI).
148
-
149
- 2. Python version >= 2.3 for the ivr (embedded python interpreter)
142
+ 1. Python version >= 2.3 for the ivr (embedded python interpreter)
150 143
     and py_sems, optional
151 144
 
152
- 3. flite speech synthesizer for TTS in the ivr, optional
145
+ 2. flite speech synthesizer for TTS in the ivr, optional
153 146
 
154
- 4. lame >= 3.95 for mp3 file output, optional. mpg123 for mp3 playback,
147
+ 3. lame >= 3.95 for mp3 file output, optional. mpg123 for mp3 playback,
155 148
     optional
156 149
 
157
- 5. xmlrpcpp for XMLRPC control, optional
150
+ 4. xmlrpcpp for XMLRPC control, optional
158 151
 
159
- 6. spandsp library for DTMF detection and PLC, optional
152
+ 5. spandsp library for DTMF detection and PLC, optional
160 153
     (SEMS has its own implementations for both)
161 154
 
162
- 7. libZRTP SDK (http://zfoneproject.com) for ZRTP, optional
155
+ 6. libZRTP SDK (http://zfoneproject.com) for ZRTP, optional
156
+
157
+ 7. libev for jsonrpc, optional
163 158
 
164 159
 How to get started with SEMS:
165 160
 
... ...
@@ -224,25 +219,13 @@ Installation:
224 219
     is at '/usr/local/etc/sems/sems.conf'. 
225 220
     Else make your own using sems.conf.sample.
226 221
 
227
- 4. Optional, needed if you want to use SER as SEMS frontend (SIP stack):
228
-    Get and start SER as SIP stack for SEMS: 
229
-    
230
-    By default, sipctrl plugin is loaded, which is the integrated SIP 
231
-    stack for SEMS. If SER should be used, the following procedure is
232
-    necessary for ser  as SIP stack: 
233
-    o For ser 2.0/sasi use this patched ser2.0 version:
234
-      http://ftp.iptel.org/pub/sems/ser2-sasi-080108.tar.bz2 
235
-      (or ser head possibly with patches from the bug tracker at 
236
-       http://tracker.iptel.org/browse/SER-346 )    
237
-      and core/etc/ser-sems.sasi.cfg. Then load the binrpcctrl module.
238
-
239
- 5. Start SEMS:
222
+ 4. Start SEMS:
240 223
 
241 224
     If you installed SEMS with 'make install', sems can be
242 225
     found at '/usr/local/sbin/sems'.
243 226
     If you need help starting 'sems', try 'sems -h'.
244 227
 
245
- 6. Using SEMS
228
+ 5. Using SEMS
246 229
     
247 230
     SEMS needs to be told from the many possible applications that are
248 231
     loaded which one to run. You can simply set the application 
Browse code

updated README.

git-svn-id: http://svn.berlios.de/svnroot/repos/sems/trunk@1663 8eb893ce-cfd4-0310-b710-fb5ebe64c474

Stefan Sayer authored on 17/03/2010 13:52:18
Showing 1 changed files
... ...
@@ -1,6 +1,6 @@
1 1
 
2 2
           +------------------------------------+
3
-          | SIP express media server  - README |
3
+          | SIP Express Media Server  - README |
4 4
           +------------------------------------+
5 5
 
6 6
 
... ...
@@ -19,10 +19,32 @@ Introduction:
19 19
  components like announcement servers as building 
20 20
  blocks of more complex applications, or, using its powerful 
21 21
  framework for application development including back-to-back 
22
- user agent (B2BUA) functionality, complex VoIP services
23
- can be realized completely in SEMS. 
22
+ user agent (B2BUA) and state machine scripting functionality, 
23
+ complex VoIP services can be realized completely in SEMS. 
24 24
  
25
- SEMS is GPL (v2+) software. See doc/COPYING for details.
25
+ SEMS only supports patent free codecs. That means that codecs
26
+ like g729 won't be supported. On the other hand, SEMS supports 
27
+ all important patent free codecs out of the box (g711u, g711a, 
28
+ GSM06.10, speex, G726, L16 and iLBC). Integrating other codecs 
29
+ in SEMS is very simple (patented or not).
30
+
31
+ SEMS shows very good performance on current standard
32
+ PC architecture based server systems. It has sucessfully
33
+ been run with 1200 G.711 conference channels on a quad-core
34
+ Intel(R) Xeon at 2GHz (700 GSM, 280 iLBC channels), and up to 
35
+ 5000 channels on a dual quad Xeon at 2.9GHz. On the 
36
+ other hand it also runs on very small devices - for example 
37
+ small embedded systems like routers running OpenWRT, for which 
38
+ of course the achievable channel count is not that high.
39
+
40
+License:
41
+
42
+ SEMS is free (speech+beer) software. It is licensed under dual 
43
+ license terms, the GPL (v2+) and proprietary license.
44
+
45
+ See doc/COPYING for details.
46
+
47
+Applications:
26 48
 
27 49
  The following applications are shipped with SEMS :
28 50
 
... ...
@@ -84,10 +106,22 @@ Introduction:
84 106
   * precoded_announce plays preencoded announcements
85 107
 
86 108
 
87
- alongside a set of example applications intended to help 
109
+Developing and customizing Applications and services:
110
+
111
+ SEMS comes with a set of example applications intended to help 
88 112
  development of custom services, including a calling card 
89 113
  application, a traffic generator, a component to control the 
90
- media server via XMLRPC, and announcements played from DB. 
114
+ media server via XMLRPC, and announcements played from DB.
115
+
116
+ DSM state machine scripting is a powerful yet simple method
117
+ to rapidly implement custom applications. With this method,
118
+ the service logic is written as an easy to understand 
119
+ textual definition of a state machine, which is interpreted
120
+ and executed for every call. The (domain specific) language 
121
+ for defining state machines can be extended by implementing
122
+ modules. A set of useful modules are shipped with SEMS, 
123
+ including MySQL database access module, Python module, 
124
+ conference support, Amazon AWS and more. 
91 125
 
92 126
  SEMS' core implements basic call and audio processing, 
93 127
  and loads plug-ins which extend the system. Audio
... ...
@@ -99,24 +133,12 @@ Introduction:
99 133
  You can easily extend SEMS by creating your own plug-ins.
100 134
  Applications can be written using the SEMS framework API 
101 135
  in C++, or in Python using an embedded python interpreter 
102
- of the ivr or py_sems modules.
103
-
104
- SEMS only supports patent free codecs. That means that codecs
105
- like g729 won't be supported. On the other hand, SEMS supports 
106
- all important patent free codecs out of the box (g711u, g711a, 
107
- GSM06.10, speex, G726, L16 and iLBC). Integrating other codecs 
108
- in SEMS is very simple.
109
-
110
- SEMS shows very good performance on current standard
111
- PC architecture based server systems. It has sucessfully
112
- been run with 1200 G.711 conference channels on a quad-core
113
- Intel(R) Xeon at 2GHz (700 GSM, 280 iLBC channels). On the 
114
- other hand it also runs on very small devices - for example 
115
- small embedded systems like routers running OpenWRT, for which 
116
- of course the achievable channel count is not that high.
136
+ of the ivr or py_sems modules, or the DSM.
117 137
 
118 138
 Requirements:
119 139
 
140
+ All requirements are optional.
141
+
120 142
  1. optional: SER version 0.9.6-sems, or SER 2.0 with SASI:
121 143
     SIP Epress Router (www.iptel.org/ser)
122 144
 
... ...
@@ -237,9 +259,6 @@ Installation:
237 259
     A sample ser.cfg file in this style can be found at 
238 260
     http://ftp.iptel.org/pub/sems/ser.cfg
239 261
 
240
-    For more information please refer to doc/Configure-SEMS-Ser-HOWTO and
241
-    the SER User's guide. 
242
-
243 262
 Creating packages on debian (ubuntu, ...):
244 263
 
245 264
    install debian package build tools:
... ...
@@ -305,8 +324,33 @@ Support, mailing lists, bugs and contact:
305 324
 Authors:
306 325
 
307 326
   Raphael Coeffic (rco@iptel.org), the father of SEMS, 
308
-  Stefan Sayer (stefan.sayer@iptego.de), current lead developer,
309
-  and all contributors.
327
+  Stefan Sayer (stefan.sayer@gmail.com), current lead developer,
328
+  and all contributors:
329
+    Alex Gradinar
330
+    Alfred E Heggestad
331
+    Andreas Granig
332
+    Andrey Samusenko
333
+    Andriy I Pylypenko
334
+    B. Oldenburg
335
+    Balint Kovacs
336
+    Bogdan Pintea
337
+    Greger Viken Teigre
338
+    Grzegorz Stanislawski
339
+    Helmut Kuper
340
+    Jeremy A
341
+    Jiri Kuthan
342
+    Juha Heinanen
343
+    Ovidiu Sas
344
+    Peter Lemenkov
345
+    Peter Loeppky
346
+    Richard Newman
347
+    Robert Szokovacs
348
+    Rui Jin Zheng
349
+    Tom van der Geer
350
+    Ulrich Abend
351
+   (if you want to be added or removed from this list, please mail to stefan.sayer@gmail.com)
352
+ 
353
+  Special thanks to IPTEGO GmbH and iptelorg GmbH for sponsoring development of SEMS.
310 354
 
311 355
 Contributions:
312 356
 
... ...
@@ -314,22 +358,7 @@ Contributions:
314 358
   example new application or codec modules, documentation pages, howtos
315 359
   etc. Please email one of the lists or the authors.
316 360
 
317
-Special thanks goes to:
318
-
319
-  * Juha Heinanen 
320
-     for numerous bug reports, improvements and contributions
321
-
322
-  * Ulrich Abend (ullstar@iptel.org)
323
-      for his great debuging work and ISDN gateway which 
324
-      unfortunately did not make it into this version yet.
325
-
326
-  * Jiri Kuthan (jiri@iptel.org)
327
-      for the debuging work and help to implement
328
-      the first communicating part between Ser & SEMS ('vm' module).
329
-
330
-  * iptego GmbH and iptelorg for sponsoring development and improvement
331
-    of SEMS.
332
- 
333
-  * All the others who helped during test session and reported bugs :-)
334
-
335
-SEMS - the media-S in the SLAMP.
336 361
\ No newline at end of file
362
+  Please also have a look at the contributions license policy 
363
+  (see doc/COPYING).
364
+  
365
+SEMS - the media-S in the SLAMP.
Browse code

updated installation info

git-svn-id: http://svn.berlios.de/svnroot/repos/sems/trunk@1455 8eb893ce-cfd4-0310-b710-fb5ebe64c474

Stefan Sayer authored on 07/07/2009 14:00:36
Showing 1 changed files
... ...
@@ -141,11 +141,23 @@ Requirements:
141 141
 
142 142
 How to get started with SEMS:
143 143
 
144
-  To try out SEMS, the easiest is to get a release candidate from 
145
-  http://ftp.iptel.org/pub/sems/testing/ , unpack and install it 
144
+  To try out SEMS, the easiest is to get a release from 
145
+  http://ftp.iptel.org/pub/sems/, unpack and install it 
146 146
   using the usual make && make install. After installation, the 
147 147
   configuration file /usr/local/etc/sems/sems.conf needs to be 
148 148
   adapted.
149
+
150
+  On debian, you can add the iptel.org SEMS repository to 
151
+  /etc/apt/sources.list:
152
+   deb http://ftp.iptel.org/pub/sems/debian lenny free
153
+   deb-src http://ftp.iptel.org/pub/sems/debian lenny free
154
+  and install SEMS from binary packages with: 
155
+  $ apt-get install sems sems-python-modules
156
+  If you want to build SEMS from source on debian, see below.
157
+
158
+  On Fedora, simply do 
159
+   $ sudo yum install sems
160
+  and sems package will be installed.
149 161
  
150 162
   You can also follow one of the tutorials
151 163
   linked from the SEMS homepage
... ...
@@ -195,30 +207,12 @@ Installation:
195 207
     
196 208
     By default, sipctrl plugin is loaded, which is the integrated SIP 
197 209
     stack for SEMS. If SER should be used, the following procedure is
198
-    necessary for ser 0.9.6-sems as SIP stack: 
199
-    o To install the ser-0.9.6-sems into the directory /some/dir the 
200
-      following commands can used:
201
-
202
-      $ wget http://ftp.iptel.org/pub/sems/ser-0.9.6-sems_src.tar.gz
203
-      $ tar xzvf ser-0.9.6-sems_src.tar.gz
204
-      $ cd ser-0.9.6-sems
205
-      $ make install PREFIX=/some/dir
206
-
207
-      With the install target install-ser-cfg, e.g. using 
208
-       $ make install-ser-cfg SERPREFIX=/some/dir 
209
-      you can install a general ser-sems.cfg which will work with 
210
-      ser-0.9.6-sems and make SER to act only as SIP stack for SEMS, i.e. 
211
-      direct every request to SEMS. Then 
212
-       $ /some/dir/sbin/ser -f /some/dir/etc/ser/ser-sems.cfg
213
-      runs SER on port 5070. This way, several versions of SER can be 
214
-      used on the same server, e.g. a different version of SER as Registrar
215
-      server.
216
-
210
+    necessary for ser  as SIP stack: 
217 211
     o For ser 2.0/sasi use this patched ser2.0 version:
218 212
       http://ftp.iptel.org/pub/sems/ser2-sasi-080108.tar.bz2 
219
-      (or ser head with patches from the bug tracker at 
213
+      (or ser head possibly with patches from the bug tracker at 
220 214
        http://tracker.iptel.org/browse/SER-346 )    
221
-      and core/etc/ser-sems.sasi.cfg.
215
+      and core/etc/ser-sems.sasi.cfg. Then load the binrpcctrl module.
222 216
 
223 217
  5. Start SEMS:
224 218
 
... ...
@@ -246,6 +240,27 @@ Installation:
246 240
     For more information please refer to doc/Configure-SEMS-Ser-HOWTO and
247 241
     the SER User's guide. 
248 242
 
243
+Creating packages on debian (ubuntu, ...):
244
+
245
+   install debian package build tools:
246
+   $ apt-get install debhelper devscripts
247
+
248
+   install dependencies:
249
+   $  apt-get install g++ make libspandsp-dev flite-dev libspeex-dev \
250
+         libssl-dev python-dev python-sip4-dev openssl
251
+   
252
+   get the source: 
253
+   $ wget ftp.iptel.org/pub/sems/sems-x.y.z.tar.gz ; tar xzvf sems-x.y.z.tar.gz
254
+   $ cd sems-x.y.z ; ln -s pkg/debian .
255
+
256
+   set version in changelog if not correct
257
+   $ dch -v x.y.z "SEMS x.y.z release"
258
+   
259
+   build package:
260
+   $ dpkg-buildpackage -rfakeroot -us -uc
261
+
262
+   install package in .. using dpkg.
263
+
249 264
 Installed files using 'make install':
250 265
 
251 266
     /usr/local/sbin/sems                 : SEMS executable
Browse code

added GPL notice in README (look, Olle, its not THAT difficult to find any more)

git-svn-id: http://svn.berlios.de/svnroot/repos/sems/trunk@1261 8eb893ce-cfd4-0310-b710-fb5ebe64c474

Stefan Sayer authored on 10/02/2009 12:48:03
Showing 1 changed files
... ...
@@ -22,6 +22,8 @@ Introduction:
22 22
  user agent (B2BUA) functionality, complex VoIP services
23 23
  can be realized completely in SEMS. 
24 24
  
25
+ SEMS is GPL (v2+) software. See doc/COPYING for details.
26
+
25 27
  The following applications are shipped with SEMS :
26 28
 
27 29
   * announcement   plays an announcement
Browse code

a bit more verbouse description of ser as SIP stack optionality

git-svn-id: http://svn.berlios.de/svnroot/repos/sems/trunk@979 8eb893ce-cfd4-0310-b710-fb5ebe64c474

Stefan Sayer authored on 22/05/2008 12:29:18
Showing 1 changed files
... ...
@@ -188,28 +188,35 @@ Installation:
188 188
     is at '/usr/local/etc/sems/sems.conf'. 
189 189
     Else make your own using sems.conf.sample.
190 190
 
191
- 4. Optional: Get and start SER as SIP stack for SEMS: 
191
+ 4. Optional, needed if you want to use SER as SEMS frontend (SIP stack):
192
+    Get and start SER as SIP stack for SEMS: 
192 193
     
193 194
     By default, sipctrl plugin is loaded, which is the integrated SIP 
194 195
     stack for SEMS. If SER should be used, the following procedure is
195
-    necessary: 
196
-    To install the ser-0.9.6-sems into the directory /some/dir the 
197
-    following commands can used:
198
-
199
-     $ wget http://ftp.iptel.org/pub/sems/ser-0.9.6-sems_src.tar.gz
200
-     $ tar xzvf ser-0.9.6-sems_src.tar.gz
201
-     $ cd ser-0.9.6-sems
202
-     $ make install PREFIX=/some/dir
203
-
204
-    With the install target install-ser-cfg, e.g. using 
205
-     $ make install-ser-cfg SERPREFIX=/some/dir 
206
-    you can install a general ser-sems.cfg which will work with 
207
-    ser-0.9.6-sems and make SER to act only as SIP stack for SEMS, i.e. 
208
-    direct every request to SEMS. Then 
209
-     $ /some/dir/sbin/ser -f /some/dir/etc/ser/ser-sems.cfg
210
-    runs SER on port 5070. This way, several versions of SER can be 
211
-    used on the same server, e.g. a different version of SER as Registrar
212
-    server.
196
+    necessary for ser 0.9.6-sems as SIP stack: 
197
+    o To install the ser-0.9.6-sems into the directory /some/dir the 
198
+      following commands can used:
199
+
200
+      $ wget http://ftp.iptel.org/pub/sems/ser-0.9.6-sems_src.tar.gz
201
+      $ tar xzvf ser-0.9.6-sems_src.tar.gz
202
+      $ cd ser-0.9.6-sems
203
+      $ make install PREFIX=/some/dir
204
+
205
+      With the install target install-ser-cfg, e.g. using 
206
+       $ make install-ser-cfg SERPREFIX=/some/dir 
207
+      you can install a general ser-sems.cfg which will work with 
208
+      ser-0.9.6-sems and make SER to act only as SIP stack for SEMS, i.e. 
209
+      direct every request to SEMS. Then 
210
+       $ /some/dir/sbin/ser -f /some/dir/etc/ser/ser-sems.cfg
211
+      runs SER on port 5070. This way, several versions of SER can be 
212
+      used on the same server, e.g. a different version of SER as Registrar
213
+      server.
214
+
215
+    o For ser 2.0/sasi use this patched ser2.0 version:
216
+      http://ftp.iptel.org/pub/sems/ser2-sasi-080108.tar.bz2 
217
+      (or ser head with patches from the bug tracker at 
218
+       http://tracker.iptel.org/browse/SER-346 )    
219
+      and core/etc/ser-sems.sasi.cfg.
213 220
 
214 221
  5. Start SEMS:
215 222
 
Browse code

added documentation for annrecorder app

git-svn-id: http://svn.berlios.de/svnroot/repos/sems/trunk@963 8eb893ce-cfd4-0310-b710-fb5ebe64c474

Stefan Sayer authored on 15/05/2008 14:50:26
Showing 1 changed files
... ...
@@ -42,6 +42,9 @@ Introduction:
42 42
   * voicebox       users can dial in to the voicebox to check
43 43
                    their messages
44 44
 
45
+  * annrecorder    users can record their personal greeting 
46
+                   message
47
+
45 48
   * mailbox        auto-attendant that saves voicemails into
46 49
                    an IMAP server. Users can dial in to check
47 50
                    their messages (simpler version)
Browse code

zrtp disabled by default

git-svn-id: http://svn.berlios.de/svnroot/repos/sems/trunk@955 8eb893ce-cfd4-0310-b710-fb5ebe64c474

Stefan Sayer authored on 14/05/2008 20:26:39
Showing 1 changed files
... ...
@@ -132,6 +132,8 @@ Requirements:
132 132
  6. spandsp library for DTMF detection and PLC, optional
133 133
     (SEMS has its own implementations for both)
134 134
 
135
+ 7. libZRTP SDK (http://zfoneproject.com) for ZRTP, optional
136
+
135 137
 How to get started with SEMS:
136 138
 
137 139
   To try out SEMS, the easiest is to get a release candidate from 
Browse code

added& updated readme

git-svn-id: http://svn.berlios.de/svnroot/repos/sems/trunk@913 8eb893ce-cfd4-0310-b710-fb5ebe64c474

Stefan Sayer authored on 23/04/2008 19:03:34
Showing 1 changed files
... ...
@@ -24,44 +24,61 @@ Introduction:
24 24
  
25 25
  The following applications are shipped with SEMS :
26 26
 
27
-  * announcement:  plays an announcement
27
+  * announcement   plays an announcement
28 28
 
29
-  * voicemail:     records voice messages and sends them 
30
-                   as email
29
+  * voicemail      records voice messages and sends them 
30
+                   as email, saves them to a voicebox, or
31
+                   both
31 32
 
32
-  * conference:    enables many people to talk together 
33
+  * conference     enables many people to talk together 
33 34
                    at the same time
34 35
 
35
-  * webconference: conference application that can be 
36
+  * webconference  conference application that can be 
36 37
                    controlled from an external program, 
37 38
                    e.g. a website 
38 39
 
39
-  * echo:          test module to echo the caller's voice
40
+  * echo           test module to echo the caller's voice
40 41
  
41
-  * mailbox:       auto-attendant that saves voicemails into
42
-                   an IMAP server. Users can dial in to check
42
+  * voicebox       users can dial in to the voicebox to check
43 43
                    their messages
44 44
 
45
-  * ann_b2b:       pre-call-announcement, plays announcement 
45
+  * mailbox        auto-attendant that saves voicemails into
46
+                   an IMAP server. Users can dial in to check
47
+                   their messages (simpler version)
48
+
49
+  * ann_b2b        pre-call-announcement, plays announcement 
46 50
                    before connecting the callee in B2BUA mode
47 51
  
48
-  * announce_transfer: pre-call-announcement, plays announcement 
52
+  * announce_transfer  pre-call-announcement, plays announcement 
49 53
                    and then transfers the caller to the callee 
50 54
                    using REFER
51 55
 
52
-  * early_announce: (pre-call) announcement using early media (183)
56
+  * early_announce (pre-call) announcement using early media (183),
57
+                   optionally continues the call in B2BUA mode
53 58
 
54
-  * conf_auth:     collect a PIN number, verify it against an 
59
+  * auth_b2b       B2BUA app that changes identity and authenticates
60
+                   second call leg
61
+
62
+  * conf_auth      collect a PIN number, verify it against an 
55 63
                    XMLRPC authentication server and connects in 
56 64
                    B2BUA mode
57 65
 
58
-  * pin_collect:   collect a PIN, optionally verify it, and transfer
66
+  * pin_collect    collect a PIN, optionally verify it, and transfer
59 67
                    the call into a conference
60 68
 
61
-  * callback:      reject the call, call back caller later and have 
69
+  * callback       reject the call, call back caller later and have 
62 70
                    her enter a number to call in b2bua with media relay
63 71
                    mode
64 72
 
73
+  * reg_agent     SIP REGISTER to register SEMS' contact to an aor
74
+
75
+  * sw_prepaid_sip prepaid application
76
+  
77
+  * call_timer     B2BUA, ends the call after a certain time
78
+
79
+  * precoded_announce plays preencoded announcements
80
+
81
+
65 82
  alongside a set of example applications intended to help 
66 83
  development of custom services, including a calling card 
67 84
  application, a traffic generator, a component to control the 
... ...
@@ -82,8 +99,8 @@ Introduction:
82 99
  SEMS only supports patent free codecs. That means that codecs
83 100
  like g729 won't be supported. On the other hand, SEMS supports 
84 101
  all important patent free codecs out of the box (g711u, g711a, 
85
- GSM06.10, speex, G726 and iLBC). Integrating other codecs in SEMS
86
- is very simple.
102
+ GSM06.10, speex, G726, L16 and iLBC). Integrating other codecs 
103
+ in SEMS is very simple.
87 104
 
88 105
  SEMS shows very good performance on current standard
89 106
  PC architecture based server systems. It has sucessfully
... ...
@@ -95,11 +112,12 @@ Introduction:
95 112
 
96 113
 Requirements:
97