Browse code

Updating INSTALL - mostly formatting

oej authored on 09/10/2009 09:23:20
Showing 1 changed files
... ...
@@ -9,19 +9,26 @@ $Id$
9 9
 
10 10
      ===========================================
11 11
 
12
+  Welcome to the SIP router! This is an amazingly flexible, robust
13
+  and secure SIP server built on years of experience in several Open 
14
+  Source projects. It's a merge of the SIP Express Router and the
15
+  OpenSER/Kamailio products produced by a joint development team.
16
+
12 17
   This memo gives you hints how to set up SIP Router quickly. To 
13 18
   understand how SIP Router works and how to configure it properly,
14
-  read admin's guide available from SIP Router website. We also
15
-  urge you to read latest ISSUES (available from SIP Router website 
19
+  please read the admin's guide available from the SIP Router website. 
20
+
21
+  We also urge you to read latest ISSUES (available from SIP Router website 
16 22
   too) and check for potential problems in this release.
17
-  Users of previous releases are encouraged to read NEWS to
18
-  learn how to move to this new SIP Router version.
23
+  Users of previous releases are encouraged to read NEWS to learn how to move to 
24
+  this new SIP Router version.
19 25
   
20 26
 
21
-TOC
27
+Table of Contents
28
+=================
22 29
 
23 30
 1. Supported Architectures and Requirements
24
-2. Howto Build sip-router From Source Distribution
31
+2. Howto Build sip-router From the Source Distribution
25 32
 3. Quick-Start Installation Guide
26 33
    A) Getting Help
27 34
    B) Disclaimers
... ...
@@ -34,11 +41,11 @@ TOC
34 41
 1. Supported Architectures and Requirements
35 42
 -------------------------------------------
36 43
 
37
-Supported operating systems: Linux, FreeBSD, NetBSD, OpenBSD, Solaris, Darwin
38
-Partially supported: Windows+Cygwin (core + static modules only, no
39
-  IPv6, no TCP, no dynamic modules)
40
-Supported architectures: i386, x86_64 (amd64), armv4l, sparc64, powerpc,
41
-  powerpc64
44
+Supported operating systems: Linux, FreeBSD, NetBSD, OpenBSD, Solaris, OS/X Darwin
45
+Partially supported: Windows+Cygwin (core + static modules only, no IPv6, no TCP, 
46
+no dynamic modules)
47
+
48
+Supported architectures: i386, x86_64 (amd64), armv4l, sparc64, powerpc, powerpc64
42 49
 Experimental architectures: mips1, mips2, sparc32, alpha
43 50
 
44 51
 (for other architectures the Makefiles might need to be edited)
... ...
@@ -52,19 +59,19 @@ Requirements:
52 59
   but it might require some options tweaking for best performance)
53 60
 - bison or yacc (Berkley yacc)
54 61
 - flex
55
-- GNU make (on Linux this is the standard "make", on *BSD and Solaris is
62
+- GNU make (on Linux this is the standard "make", on *BSD and Solaris it is
56 63
   called "gmake") version >= 3.80 (recommended 3.81).
57 64
 - sed and tr (used in the makefiles)
58 65
 - GNU tar ("gtar" on Solaris) and gzip if you want "make tar" to work
59 66
 - GNU install, BSD install or Solaris install if you want "make
60 67
   install", "make bin", "make sunpkg" to work
61
-- libmysqlclient & libz (zlib) if you want mysql support (the mysql module)
62
-- libexpat if you want the jabber gateway support (the jabber module)
68
+- libmysqlclient & libz (zlib) if you want Mysql support (the db_mysql module)
69
+- libexpat if you want the XMPP/Jabber gateway support (the jabber module)
63 70
 - libxml2 if you want to compile the cpl-c (CPL support) or pa (presence) 
64 71
    modules
65 72
 - libradiusclient-ng (> 5.0) if you need radius support (the auth_radius,
66 73
   group_radius, uri_radius and avp_radius modules)
67
-- libpq if you need postgres support (the postgres module)
74
+- libpq if you need PostgreSQL support (the db_postgres module)
68 75
 
69 76
 
70 77
 OS Notes:
... ...
@@ -72,12 +79,12 @@ OS Notes:
72 79
  FreeBSD/OpenBSD/NetBSD: make sure gmake, bison or yacc & flex are installed.
73 80
   
74 81
   FreeBSD 5.4:
75
-  
82
+  ------------
76 83
   If you want to compile all the modules, you will need the following packages:
77 84
   - mysql-client-* (any version, install one of the mysql*-client ports) for
78
-  libmysqlclient
85
+    libmysqlclient
79 86
   - postgresql-libpqxx-2.4.2_1 (/usr/ports/databases/postgresql-libpqxx) for
80
-  libpq
87
+    libpq
81 88
   - expat-1.95.8 (/usr/ports/textproc/expat2) for libexpat
82 89
   - libxml2-2.6.18 (/usr/ports/textproc/libxml2) for libxml2
83 90
   - radiusclient-0.4.7 (/usr/ports/net/radiusclient) for libradiusclient-ng 
... ...
@@ -88,6 +95,7 @@ OS Notes:
88 95
      gmake bin radiusclient_ng=4 include_modules="mysql jabber cpl-c auth_radius group_radius uri_radius postgres pa"
89 96
 
90 97
   OpenBSD 3.7
98
+  -----------
91 99
   - mysql-client-4.0.23 (/usr/ports/databases/mysql) for libmysqlclient
92 100
   - expat-1.95.6 (/usr/ports/textproc/expat) for libexpat
93 101
   - libxml-2.6.16p0 (/usr/ports/textproc/libxml) for libxml2
... ...
@@ -95,10 +103,12 @@ OS Notes:
95 103
    http://download.berlios.de/radiusclient-ng/radiusclient-ng-0.5.1.tar.gz
96 104
    (you need to download and install it, since there is no "official" 
97 105
    openbsd port for it) for libradiusclient-ng 
106
+
98 107
   Compile example (all the modules and sip-router in a tar.gz):
99 108
      gmake bin include_modules="mysql jabber cpl-c auth_radius group_radius uri_radius pa"
100 109
 
101 110
   NetBSD 2.0
111
+  ----------
102 112
   - mysql-client-4.1.12 (/usr/pkgsrc/databases/mysql4-client) for libmysqlclient
103 113
   - expat-1.95.8nb2 (/usr/pkgsrc/textproc/expat) for libexpat
104 114
   - libxml2-2.6.19 (/usr/pkgsrc/textproc/libxml2) for libxml2
... ...
@@ -107,10 +117,10 @@ OS Notes:
107 117
   Compile example (all the modules and sip-router in a tar.gz):
108 118
      gmake bin include_modules="mysql jabber cpl-c auth_radius group_radius uri_radius pa"
109 119
 
110
- Solaris 10
111
- 
112
-  As above; you can use Solaris's yacc instead of bison. You might
113
-  need also gtar and ginstall. If you don't have ginstall you can use Solaris
120
+  Solaris 10
121
+  ----------
122
+  As above; you can use Solaris's yacc instead of bison. You might also
123
+  need gtar and ginstall. If you don't have ginstall you can use Solaris
114 124
   install, just make sure it's in the PATH (it's usually in /usr/sbin) and
115 125
   add INSTALL=install either to the environment or to the make command line
116 126
   (e.g.: gmake INSTALL=install all).
... ...
@@ -121,10 +131,10 @@ OS Notes:
121 131
   Compile example (all the modules and sip-router in a tar.gz):
122 132
      gmake bin INSTALL=install include_modules="mysql jabber cpl-c auth_radius group_radius uri_radius postgres pa"
123 133
 
124
- Linux
125
-
126
- Needed packages for compiling all the modules:
127
-  Debian:
134
+  Linux
135
+  -----
136
+  Needed packages for compiling all the modules:
137
+  * Debian:
128 138
       - libmysqlclient-dev for libmysqlclient
129 139
       - libpq-dev for libpq
130 140
       - libexpat1-dev for libexpat
... ...
@@ -141,7 +151,7 @@ OS Notes:
141 151
        apt-get install sip-router sip-router-cpl-module sip-router-jabber-module sip-router-mysq-module sip-router-pa-module sip-router-postgres-module sip-router-radius-modules )
142 152
 
143 153
  Cygwin  (alpha state, partial support)
144
-
154
+ --------------------------------------
145 155
  make sure make, bison, flex, minires and minires-devel (needed for the
146 156
  resolver functions) are installed.
147 157
  
... ...
@@ -163,306 +173,267 @@ OS Notes:
163 173
 
164 174
 (NOTE: if make doesn't work try gmake  instead)
165 175
 
166
-SIP Router is split in four main parts: The core, the modules, the
167
-utilties, and scripts/examples.  When you build, you can decide to build
168
-only the core, the modules, both, or all.
176
+  SIP Router is split in four main parts: The core, the modules, the
177
+  utilties, and scripts/examples.  When you build, you can decide to build
178
+  only the core, the modules, both, or all.
169 179
 
170
-Compile SIP Router core only:
171
-make   #builds only sip-router core, equivalent to make sip-router
180
+* Compile SIP Router core only:
181
+	make   #builds only sip-router core, equivalent to make sip-router
172 182
 
173 183
 Compile modules except some explicitly excepted (see below)
174
-make modules  - all modules in the modules/ directory (common modules)
175
-make modules_s - all modules in the modules_s/ directory (ser modules)
176
-make modules_k - all modules in the modules_k/ directory (kamailio modules)
177
-make modules-all or make every-module  - all the modules (modules, modules_s
184
+	make modules  - all modules in the modules/ directory (common modules)
185
+	make modules_s - all modules in the modules_s/ directory (ser modules)
186
+	make modules_k - all modules in the modules_k/ directory (kamailio modules)
187
+	make modules-all or make every-module  - all the modules (modules, modules_s
178 188
                                          and module_k)
179 189
 
180
-Compile all:
181
-make all
190
+* Compile all:
191
+	make all
182 192
 
183
-Explicitly excepted modules (default in <=0.9.x):
184
-By default make all will not build modules that require external libraries or
185
-that are considered to be "experimental". The modules that have external
186
-dependencies are: mysql, jabber, cpl-c, auth_radius, group_radius, uri_radius,
187
-avp_radius, postgres, pa.
193
+* Explicitly excepted modules:
194
+  By default make all will not build modules that require external libraries or
195
+  that are considered to be "experimental". The modules that have external
196
+  dependencies are: db_mysql, jabber, cpl-c, auth_radius, group_radius, uri_radius,
197
+  avp_radius, db_postgres, db_berkely, carrierroute, pa.
188 198
 
189
-Including groups of modules (available in >0.9.x):
190
-Instead of compiling the default modules only, you can specify groups of
191
-modules to include, according to their status:
192
-standard - Modules in this group are considered a standard part of SIP Router (due to widespread usage)
199
+Including groups of modules:
200
+  Instead of compiling the default modules only, you can specify groups of
201
+  modules to include, according to their status:
202
+  - standard - Modules in this group are considered a standard part of SIP Router (due to widespread usage)
193 203
     but they have no dependencies (note that some of these interplay with external systems.
194 204
     However, they don't have compile or link dependencies).
195 205
 
196
-db - Modules in this group use databases and need a database driver to run.
206
+  - db - Modules in this group use databases and need a database driver to run.
197 207
      Included are drivers for the text mode db (dbtext) and for dumping
198 208
      large ammount of data to files (db_flatstore). See also the mysql or
199 209
      postgres groups.
200 210
 
201
-standard_dep -  Modules in this group are considered a standard part of SIP Router (due to widespread usage)
211
+  - standard_dep -  Modules in this group are considered a standard part of SIP Router (due to widespread usage)
202 212
     but they have dependencies that most be satisfied for compilation.
203 213
     NOTE! All presence modules (dialog, pa, presence_b2b, rls, xcap) have been included in this
204 214
     group due to interdependencies
205 215
 
206
-stable - Modules in this group satisfy specific or niche applications, but are considered
216
+  - stable - Modules in this group satisfy specific or niche applications, but are considered
207 217
     stable for production use. They may or may not have dependencies
208 218
 
209
-experimental - Modules in this group are either not complete, untested, or without enough reports
219
+  - experimental - Modules in this group are either not complete, untested, or without enough reports
210 220
     of usage to allow the module into the stable group. They may or may not have dependencies.
211 221
 
212
-To compile core with standard modules:
213
-make group_include="standard" all
214
-
215
-To compile all modules (provided you have all the required libraries installed) use:
216
-make group_include="standard standard-dep stable experimental" all
217
-
218
-There are also in addition some "convenience" groups:
219
-
220
-mysql - Include all the db modules dependent and the mysql db driver
221
-
222
-postgres - Include all the db modules and the postgres db driver
223
-
224
-radius - Include all modules on radiusclient
225
-
226
-presence - Include all the presence modules
227
-
228
-Ex. to make a standard installation with mysql, use:
229
-make group_include="standard mysql" all
230
-
231
-In addition to group_include (or instead), you can use 
232
-include_modules="modA modB"
233
-to specify exactly the modules you want to include, ex.
234
-make include_modules="mymodule" modules
235
-
236
-You can also explicitly skip modules using skip_modules. Let's say you want all the standard
237
- and standard-dep modules except domain:
238
-make group_include="standard standard-dep" skip_modules="domain" all
239
-
240
-NOTE!!! As this mechanism is very powerful, you may be uncertain which
241
-modules wwill be included.
242
-Just replace all (or modules) with print-modules and you will see which
243
-modules will be included and excluded, ex:
244
-
245
-make print-modules
246
-
247
-will show which modules are excluded by default.
248
-
249
-If you want to install or to build a binary package (a tar.gz with
250
-sip-router and the modules), substitute "all" in the above command with
251
-"install" or "bin".
252
-
253
-
254
-More compile examples:
255
-
256
-- compile with profiling
257
-
258
-make PROFILE=-pg all
259
-
260
--compile debug mode version
261
-
262
-make mode=debug all
263
-
264
--compile debug version with profiling
265
-
266
-make mode=debug PROFILE=-pg all
267
-
268
--compile only the print module
269
-
270
-make modules=modules/print modules
271
-
272
-- compile by default only the print module, in debuging mode and with 
273
- profiling:
274
-
275
-make cfg modules=modules/print mode=debug PROFILE=-pg
276
-make all
277
-
278
-- change & save the  modules list without rebuilding the whole config
279
- (so that already compiled modules won't be re-compiled by 
280
-  make all/make modules):
281
-
282
-make modules-cfg include_modules="mysql postgress"
283
-
284
-- change only the compile/build options, without changing the modules list:
285
-
286
-make cfg-defs CPU=ultrasparc PROFILE=-pg
287
-
288
-- compile by default all the usual modules + mysql and postgres, optimized 
289
-for pentium-m and for space (saves both the build options and the module 
290
- list)
291
-
292
-make cfg include_modules="mysql postgres" CPU=pentium-m CC_EXTRA_OPTS=-Os
293
-make all
294
-
295
--compile all the "default" modules except textops and vm
296
-
297
-make skip_modules="textops vm" modules
298
-
299
-- save the above option in the make config, so that all make commands
300
-will use it by default:
301
-
302
-make cfg skip_modules="textops vm"
303
-
304
--compile all default modules and include uri_radius (not compiled by default):
305
-
306
-make include_modules="uri_radius" modules
307
-
308
--compile all the modules from the modules subdirectory (even the one excluded
309
-by default):
310
-
311
-make exclude_modules="" modules
312
-
313
--compile all the modules from the modules subdirectory excluding vm:
314
-
315
-make exclude_modules=vm modules
316
-
317
-or
318
-
319
-make exclude_modules="" skip_modules=vm modules
320
-
321
-
322
--compile with the "tm" module statically linked and with profiling
323
-
324
-make static_modules=tm PROFILE=-pg all
325
-
326
--compile with gcc-3.2 instead of gcc
327
-
328
-make CC=gcc-3.2 all
329
-
330
-or
331
-
332
-CC=gcc-3.2 make all
333
-
334
-
222
+* To compile core with standard modules:
223
+	make group_include="standard" all
224
+
225
+* To compile all modules (provided you have all the required libraries installed) use:
226
+	make group_include="standard standard-dep stable experimental" all
227
+
228
+  There are also in addition some "convenience" groups:
229
+
230
+	mysql 		- Include all the db modules dependent and the mysql db driver
231
+	postgres 	- Include all the db modules and the postgres db driver
232
+	radius 		- Include all modules on radiusclient
233
+	presence 	- Include all the presence modules
234
+
235
+  Ex. to make a standard installation with Mysql, use:
236
+	make group_include="standard mysql" all
237
+
238
+  In addition to group_include (or instead), you can use 
239
+	include_modules="modA modB"
240
+  to specify exactly the modules you want to include, ex.
241
+	make include_modules="mymodule" modules
242
+
243
+  You can also explicitly skip modules using skip_modules. Let's say you want all the standard
244
+  and standard-dep modules except domain:
245
+	make group_include="standard standard-dep" skip_modules="domain" all
246
+
247
+  NOTE!!! As this mechanism is very powerful, you may be uncertain which
248
+  modules that will be included. Just replace all (or modules) with print-modules and you will 
249
+  see which modules will be included and excluded, ex:
250
+	make print-modules
251
+  will show which modules are excluded by default.
252
+
253
+  If you want to install or to build a binary package (a tar.gz with
254
+  sip-router and the modules), substitute "all" in the above command with
255
+  "install" or "bin".
256
+
257
+
258
+* More compile examples:
259
+
260
+  - compile with profiling
261
+	make PROFILE=-pg all
262
+  - compile debug mode version
263
+	make mode=debug all
264
+  - compile debug version with profiling
265
+	make mode=debug PROFILE=-pg all
266
+  - compile only the print module
267
+	make modules=modules/print modules
268
+  - compile by default only the print module, in debuging mode and with 
269
+    profiling:
270
+	make cfg modules=modules/print mode=debug PROFILE=-pg
271
+	make all
272
+  - change & save the  modules list without rebuilding the whole config
273
+    (so that already compiled modules won't be re-compiled by 
274
+    make all/make modules):
275
+	make modules-cfg include_modules="mysql postgress"
276
+  - change only the compile/build options, without changing the modules list:
277
+	make cfg-defs CPU=ultrasparc PROFILE=-pg
278
+  - compile by default all the usual modules + mysql and postgres, optimized 
279
+     for pentium-m and for space (saves both the build options and the module 
280
+     list)
281
+	make cfg include_modules="mysql postgres" CPU=pentium-m CC_EXTRA_OPTS=-Os
282
+	make all
283
+   - compile all the "default" modules except textops and vm
284
+	make skip_modules="textops vm" modules
285
+   - save the above option in the make config, so that all make commands
286
+     will use it by default:
287
+	make cfg skip_modules="textops vm"
288
+   - compile all default modules and include uri_radius (not compiled by default):
289
+	make include_modules="uri_radius" modules
290
+   - compile all the modules from the modules subdirectory (even the one excluded
291
+     by default):
292
+	make exclude_modules="" modules
293
+   - compile all the modules from the modules subdirectory excluding vm:
294
+	make exclude_modules=vm modules
295
+     or
296
+	make exclude_modules="" skip_modules=vm modules
297
+   - compile with the "tm" module statically linked and with profiling
298
+	make static_modules=tm PROFILE=-pg all
299
+   - compile with gcc-3.2 instead of gcc
300
+	make CC=gcc-3.2 all
301
+     or
302
+	CC=gcc-3.2 make all
335 303
 
336 304
 Make targets:
305
+=============
337 306
 
338 307
 Configure:
308
+----------
339 309
 
340
-make cfg or make config (force config and module list regeneration)
310
+  * make cfg or make config - force config and module list regeneration
311
+  
341 312
 
342
-Example: make cfg include_modules=mysql mode=debug  (all future make 
343
-invocations will include the mysql module and will build in debug mode)
313
+  Example: 
314
+	make cfg include_modules=mysql mode=debug
315
+  All future make invocations will include the mysql module and will build in debug mode
344 316
 
345
-Note: if config.mak doesn't exist (e.g. initial checkout or after a make 
346
-proper) or if Makefile.defs was changed, the config will be re-generated
347
-automatically by the first make command. For example:
348
- make cfg  include_modules=mysql; make all is equivalent to 
349
- rm config.mak modules.lst; make include_modules=mysql.
317
+  Note: if config.mak doesn't exist (e.g. initial checkout or after a make 
318
+  proper) or if Makefile.defs was changed, the config will be re-generated
319
+  automatically by the first make command. For example:
320
+  	make cfg  include_modules=mysql; make all
321
+  is equivalent to 
322
+ 	rm config.mak modules.lst; make include_modules=mysql.
350 323
 
351
-make cfg-defs  (force config regeneration, but don't touch the module list)
324
+  * make cfg-defs  (force config regeneration, but don't touch the module list)
352 325
 
353
-Example: make cfg-defs CPU=ultrasparc CC_EXTRA_OPTS=-Os PROFILE=-pg
326
+  Example:
327
+	make cfg-defs CPU=ultrasparc CC_EXTRA_OPTS=-Os PROFILE=-pg
354 328
 
355
-make modules-cfg or
356
-make modules-list    (saves the module list, without regenerating the 
357
-                       build config)
358
-Example: make modules-list include_modules="tls" skip_modules="print"
329
+	make modules-cfg
330
+  or
331
+	make modules-list
332
+  saves the module list, without regenerating the build config
333
+  Example:
334
+	make modules-list include_modules="tls" skip_modules="print"
359 335
 
360 336
 Clean:
337
+------
361 338
 
362
-make clean   (clean the modules too)
363
-make proper  (clean also the dependencies and the config, but not the module
364
-  list)
365
-make distclean (the same as proper)
366
-make maintainer-clean (clean everything, including make's config, saved 
367
-  module list, auto generated files, tags, *.dbg a.s.o)
368
-make clean-all (clean all the modules in modules/*)
369
-make proper-all (like make proper but for all the  modules in modules/*)
339
+  * make clean   	- clean the base and modules too
340
+  * make proper  	- clean also the dependencies and the config, but not the module list
341
+  * make distclean 	- the same as proper
342
+  * make maintainer-clean - clean everything, including make's config, saved 
343
+  			  module list, auto generated files, tags, *.dbg a.s.o
344
+  * make clean-all	- clean all the modules in modules/*
345
+  * make proper-all 	- like make proper but for all the  modules in modules/*
370 346
 
371
-Config clean:
347
+  Config clean:
372 348
 
373
-make clean-cfg (cleans the compile config)
374
-make clean-modules-cfg (cleans the modules list)
349
+  * make clean-cfg (cleans the compile config)
350
+  * make clean-modules-cfg (cleans the modules list)
375 351
 
376
-"Reduced" clean:
352
+  Reduced" clean:
377 353
 
378
-make local-clean    (cleans only the core, no libs, utils or modules)
379
-make clean-modules  (like make clean, but cleans only the modules)
380
-make clean-libs     (like make clean, but cleans only the libs)
381
-make clean-utils    (like make clean, but cleans only the utils
382
-make proper-modules (like make proper, but only for modules)
383
-make proper-libs    (like make proper, but only for libs)
384
-make proper-utils   (like make proper, but only for utils)
354
+  * make local-clean  	- cleans only the core, no libs, utils or modules
355
+  * make clean-modules  - like make clean, but cleans only the modules
356
+  * make clean-libs     - like make clean, but cleans only the libs
357
+  * make clean-utils    - like make clean, but cleans only the utils
358
+  * make proper-modules - like make proper, but only for modules
359
+  * make proper-libs    - like make proper, but only for libs
360
+  * make proper-utils   - like make proper, but only for utils
385 361
 
386 362
 Compile:
363
+--------
364
+  * make proper
365
+  optional: make cfg  <various cfg. options that should be saved>
366
+  * make
367
+  or gmake on non-Linux systems
368
+  * make modules 
369
+  or make modules exclude_modules="CVS print" etc.
387 370
 
388
-make proper
389
-optional: make cfg  <various cfg. options that should be saved>
390
-make
391
-(or gmake on non-Linux systems)
392
-make modules 
393
-or make modules exclude_modules="CVS print" etc.
394
-
395
-Make tags:
371
+Other make targets:
372
+-------------------
373
+  Make tags:
374
+	make TAGS
396 375
 
397
-make TAGS
376
+  Create a tar.gz with the sources (in ../):
377
+	make tar
398 378
 
399
-Create a tar.gz with the sources (in ../):
379
+  Create a tar.gz with the binary distribution (in ../):
380
+	make bin
400 381
 
401
-make tar
382
+  Create a gzipped solaris package (in ../):
383
+	make sunpkg
402 384
 
403
-Create a tar.gz with the binary distribution (in ../):
385
+  Create debian packages (in ../):
386
+	make deb
404 387
 
405
-make bin
406
-
407
-Create a gzipped solaris package (in ../):
408
-
409
-make sunpkg
410
-
411
-Create debian packages (in ../):
412
-
413
-make deb
414
-
415
-or
416
-
417
-dpkg-buildpackage
388
+  or
389
+	dpkg-buildpackage
418 390
 
419 391
 Documentation:
392
+--------------
420 393
 
421
-make README
394
+  Regenerate the README for all the "default" modules (include_modules,
395
+  skip_modules a.s.o can be used to alter the module list).
396
+	make README
422 397
 
423
-Regenerates the README for all the "default" modules (include_modules,
424
- skip_modules a.s.o can be used to alter the module list).
398
+  Generates a manpage for all the modules that support it (.xml file in the
399
+  module directory).
400
+	make man
425 401
 
426
-make man
427
-
428
-Generates a manpage for all the modules that support it (.xml file in the
429
- module directory).
430
-
431
-make modules=modules_k/foo modules-readme
432
-
433
-Generates README file for modules_k/foo.
402
+  Generates README file for modules_k/foo.
403
+	make modules=modules_k/foo modules-readme
434 404
 
435 405
 Install:
406
+--------
436 407
 
437
-make prefix=/usr/local  install
408
+	make prefix=/usr/local  install
438 409
 
439
-Note: If you use prefix parameter in make install then you also need
440
-to use this parameter in previous make commands, i.e. make, make modules,
441
-or make all. If you fail to do this then SIP Router will look for the default
442
-configuration file in a wrong directory, because the directory of the
443
-default configuration file is hard coded into sip-router during compile time. 
444
-When you use a different prefix parameter when installing then the 
445
-directory hard coded in sip-router and the directory in which the file will be 
446
-installed by make install will not match. (You can specify exact location
447
-of the configuration file using -f parameter of sip-router).
410
+  Note: If you use prefix parameter in make install then you also need
411
+  to use this parameter in previous make commands, i.e. make, make modules,
412
+  or make all. If you fail to do this then SIP Router will look for the default
413
+  configuration file in a wrong directory, because the directory of the
414
+  default configuration file is hard coded into sip-router during compile time. 
415
+  When you use a different prefix parameter when installing then the 
416
+  directory hard coded in sip-router and the directory in which the file will be 
417
+  installed by make install will not match. (You can specify exact location
418
+  of the configuration file using -f parameter of sip-router).
448 419
 
449
-For example, if you do the following:
450
-make all
451
-make prefix=/ install
420
+  For example, if you do the following:
421
+	make all
422
+	make prefix=/ install
452 423
 
453
-Then the installation will put the default configuration file into
454
-/etc/sip-router/sip-router.cfg (because prefix is /), but sip-router
455
-will look for the file in /usr/local/etc/sip-router/sip-router.cfg
456
-(because there was no prefix parameter make all and /usr/local is the
457
-default value of prefix).
424
+  Then the installation will put the default configuration file into
425
+  /etc/sip-router/sip-router.cfg (because prefix is /), but sip-router
426
+  will look for the file in /usr/local/etc/sip-router/sip-router.cfg
427
+  (because there was no prefix parameter make all and /usr/local is the
428
+  default value of prefix).
458 429
 
459
-Workaround is trivial, use the same parameters in all make commands:
460
-make prefix=/ all
461
-make prefix=/ install
462
-or save the desired prefix in the make config (e.g.: make cfg prefix=/).
430
+  Workaround is trivial, use the same parameters in all make commands:
431
+	make prefix=/ all
432
+	make prefix=/ install
433
+  or save the desired prefix in the make config (e.g.: make cfg prefix=/).
463 434
 
464
-That applies to other make parameters as well (for example parameters
465
-"modules" or "excluded_modules").
435
+  That applies to other make parameters as well (for example parameters
436
+  "modules" or "excluded_modules").
466 437
 
467 438
 
468 439
 3. Quick-Start Installation Guide
... ...
@@ -470,87 +441,84 @@ That applies to other make parameters as well (for example parameters
470 441
 
471 442
 A) Getting Help
472 443
 
473
-This guide gives you instructions on how to set up the SIP Router
474
-(sip-router) on your box quickly. In case the default configuration
475
-does not fly, check documentation at sip-router site
476
-  http://sip-router.org
477
-to learn how to configure SIP Router for your site.
444
+  This guide gives you instructions on how to set up the SIP Router
445
+  (sip-router) on your box quickly. In case the default configuration
446
+  does not fly, please check the documentation at the sip-router web site
447
+  http://sip-router.org to learn how to configure SIP Router for your site.
478 448
 
479
-If the documentation does not resolve your problem you may try contacting 
480
-our user forum by E-mail at sr-users@lists.sip-router.org -- that is the
481
-mailing list of ser community. To participate in the mailing list,
482
-subscribe at the following web address:
449
+  If the documentation does not resolve your problem you may try contacting 
450
+  our user forum by E-mail at sr-users@lists.sip-router.org -- that is the
451
+  mailing list of the sip-router community. To participate in the mailing list,
452
+  please subscribe at the following web address:
483 453
 
484 454
   http://lists.sip-router.org/cgi-bin/mailman/listinfo
485 455
 
486
-To participate in our commercial support program, contact info@iptel.org.
487
-The support program will provide you with most timely and accurate help
488
-for configuration, integration, development and any other technical
489
-activity.
490
-
456
+  To participate in our commercial support program, contact info@iptel.org.
457
+  The support program will provide you with most timely and accurate help
458
+  for configuration, integration, development and any other technical
459
+  activity.
491 460
 
492 461
 B) Disclaimers
493 462
  
494
-Note well the default "quick-start" configuration is very simple in order 
495
-to be easily installable. It provides minimum features. Particularly, 
496
-authentication is by default disabled, which means anyone can register using
497
-any name with the server. (This is on purpose to avoid installation 
498
-dependencies on MySQL which is needed for storing user credentials.)
499
-
463
+  Note well the default "quick-start" configuration is very simple in order 
464
+  to be easily installable. It provides minimum features. Particularly, 
465
+  authentication is by default disabled, which means anyone can register using
466
+  any name with the server. (This is on purpose to avoid installation 
467
+  dependencies on a database, which is needed for storing user credentials.)
500 468
 
501 469
 C) Quick Start
502 470
 
503
-The following step-by step guide gives you instructions how to install the 
504
-sql-free distribution of sip-router. If you need persistence and
505
-authentication, then you have to install additional MySql support --
506
-proceed to section D) after you are finished with C).
471
+  The following step-by step guide gives you instructions how to install the 
472
+  SQL-free distribution of sip-router. If you need persistence and
473
+  authentication, then you have to install additional database support --
474
+  proceed to section D) after you are finished with C).
507 475
 
508
-1) Download an RPM or debian package from site
476
+  1) Download an RPM or debian package from site
509 477
 
510 478
     ****** site not available yet
511 479
 
512
-If you don't use an rpm or debian based distribution, try our tar.gz'ed
513
-binaries
480
+  If you don't use an rpm or debian based distribution, try our tar.gz'ed
481
+  binaries
514 482
 
515 483
   ******* not available yet
516 484
 
517
-If you use Solaris 8 you can try our solaris package.
518
-If you use Gentoo Linux you do not have to download a package.
519
-
520
-2) install the package
521
-RPM:
522
-    rpm -i <package_name>
523
-debian:
524
-    dpkg -i <package_name>
525
-gentoo:
526
-    emerge sip-router
527
-	(or if use only stable packets:
528
-	 ACCEPT_KEYWORDS="~x86" emerge sip-router)
529
-tar.gz:
530
-    cd /; tar zxvf <package_name>_os_arch.tar.gz
531
-    (it will install in /usr/local/, and the configuration file in
532
-     /usr/local/etc/sip-router/sip-router.cfg)
533
-Solaris:
534
-    gunzip <package_name>.gz ; pkgadd -d <package_name>
535
-*BSD:
536
-    pkg_add package_name
485
+  If you use Solaris 8 you can try our solaris package.
486
+  If you use Gentoo Linux you do not have to download a package.
487
+
488
+2) Install the package
489
+	RPM:
490
+    		rpm -i <package_name>
491
+	debian:
492
+    		dpkg -i <package_name>
493
+	gentoo:
494
+    		emerge sip-router
495
+		(or if use only stable packets: ACCEPT_KEYWORDS="~x86" emerge sip-router)
496
+	tar.gz:
497
+    		cd /; tar zxvf <package_name>_os_arch.tar.gz
498
+    		(it will install in /usr/local/, and the configuration file in
499
+     		/usr/local/etc/sip-router/sip-router.cfg)
500
+	Solaris:
501
+    		gunzip <package_name>.gz ; pkgadd -d <package_name>
502
+	*BSD:
503
+    		pkg_add package_name
537 504
     
538
-3) start the server
539
-RPM + gentoo:
540
-    /etc/init.d/sip-router start
541
-debian:
542
-    sip-router is started automatically after the install
543
-    (in case something fails you can start it with /etc/init.d/sip-router start)
544
-tar.gz:
545
-    the tar.gz does not include an init.d script, you'll have to create one of
546
-    your own or adapt one from the source distribution (debian/init.d,
547
-    rpm/sip-router.init.*, gentoo/sip-router.init)
548
-    You can start sip-router directly with /usr/local/sbin/sip-router.
549
-Solaris:
550
-    see tar.gz.
505
+3) Start the server
506
+
507
+	RPM + gentoo:
508
+    		/etc/init.d/sip-router start
509
+	debian:
510
+    		sip-router is started automatically after the install
511
+    		(in case something fails you can start it with /etc/init.d/sip-router start)
512
+	tar.gz:
513
+	Solaris:
514
+    		the tar.gz does not include an init.d script, you'll have to create one of
515
+    		your own or adapt one from the source distribution (debian/init.d,
516
+    		rpm/sip-router.init.*, gentoo/sip-router.init)
517
+    		You can start sip-router directly with /usr/local/sbin/sip-router.
551 518
     
552 519
 4) optionally, watch server's health using the
553
-   serctl utility
520
+   	serctl utility
521
+
554 522
     - to do so, first set the environment variable SIP_DOMAIN to your domain 
555 523
       name, e.g., in Bourne shell, call
556 524
         export SIP_DOMAIN="myserver.foobar.com"
... ...
@@ -563,29 +531,31 @@ Solaris:
563 531
         /usr/local/sbin/serctl moni (if you installed from a tar.gz or solaris
564 532
         package)
565 533
 
566
-5) Register with the server using your favorite
567
-   SIP User Agent. You may want to look at configuration
568
-   hints for use of iptel.org site at
534
+5) Connect SIP phones
535
+
536
+  Register with the server using your favorite SIP User Agent. You may want to look 
537
+  at configuration hints for use of various clients on iptel.org site at
569 538
      http://www.iptel.org/phpBB/viewforum.php?forum=1&8
570
-   For example, users of Windows Messenger need to set
571
-   in Tools->Options->Accounts the following values:
572
-     Sign-in Name: <username>@<your_server_address>
573
-     Advanced->Configure Settings (on)
574
-     Advanced->Server: <your_server_address>
575
-     Connect Using: UDP
576 539
 
540
+  In most cases, you need to set the following options:
577 541
 
542
+	Proxy server:	host name of your server
543
+	Domain:		the sip domain your server is configured to handle
544
+	User name:	the account name for your device
545
+	Auth user:	the ID used for authentication
546
+	Secret/Password:	The configured authentication password
578 547
 
579 548
 D) sip-router with Persistent Data Storage
549
+------------------------------------------
580 550
 
581
-The default configuration is very simple and features many simplifications. 
582
-In particular, it does not authenticate users and loses User Location database 
583
-on reboot. To provide persistence, keep user credentials and remember users' 
584
-locations across reboots, ser can be configured to use MySQL. Before you
585
-proceed, you need to make sure MySQL is installed on your box. Your
586
-MySQL server must be configured to deal with a large number of
587
-connection. To increase it, set the following line in [mysqld] section
588
-of your configuration file:
551
+  The default configuration is very simple and features many simplifications. 
552
+  In particular, it does not authenticate users and loses User Location database 
553
+  on reboot. To provide persistence, keep user credentials and remember users' 
554
+  locations across reboots, sip-router can be configured to use a database, like MySQL. 
555
+  Before you proceed, you need to make sure MySQL is installed on your box. Your
556
+  MySQL server must be configured to deal with a large number of
557
+  connection. To increase it, set the following line in [mysqld] section
558
+  of your my.ini configuration file:
589 559
 
590 560
    set-variable    = max_connections=500
591 561
 
... ...
@@ -598,6 +568,7 @@ of your configuration file:
598 568
      from the source).
599 569
 	For gentoo please include 'mysql' to your USE variable in /etc/make.conf
600 570
 	or give it as variable to the emerge command.
571
+
601 572
 2) install the package
602 573
     rpm -i <package_name>
603 574
     or
... ...
@@ -606,6 +577,7 @@ of your configuration file:
606 577
 	emerge sip-router
607 578
 	(if do not want to put 'mysql' into your USE variable you can type:
608 579
 	 USE="mysql" emerge sip-router)
580
+
609 581
 3) create MySQL tables
610 582
 	- if you have a previously installed SIP Router on your system, use
611 583
     	/usr/sbin/sip-router_mysql.sh reinstall 
... ...
@@ -614,6 +586,7 @@ of your configuration file:
614 586
     	/usr/sbin/sip-router_mysql.sh create
615 587
 	  to create SIP Router database structures
616 588
    (you will be prompted for password of MySql "root" user)
589
+
617 590
 4) configure sip-router to use SQL
618 591
     uncomment all lines in configuration file sip-router.cfg which are related to 
619 592
     authentication:
... ...
@@ -637,6 +610,7 @@ of your configuration file:
637 610
       }
638 611
 6) restart the server
639 612
     /etc/init.d/sip-router restart
613
+
640 614
 7) you can now start  managing the server using the serctl utility; 
641 615
    you need to first set the environment variable SIP_DOMAIN to your 
642 616
    local SIP realm, e.g.,