Browse code

TOC added, "getting help" updated

Jiri Kuthan authored on 07/12/2002 11:53:10
Showing 1 changed files
... ...
@@ -2,6 +2,23 @@ $Id$
2 2
 
3 3
 
4 4
 Installation Notes
5
+===================
6
+
7
+TOC
8
+
9
+1. Supported Architectures and Requirements
10
+2. Howto Build ser From Source Distribution
11
+3. Quick-Start Installation Guide
12
+   A) Getting Help
13
+   B) Disclaimers
14
+   C) Quick Start
15
+   D) ser with Persistent Data Storage
16
+   E) Troubleshooting
17
+
18
+
19
+
20
+1. Supported Architectures and Requirements
21
+-------------------------------------------
5 22
 
6 23
 Supported arhitectures: Linux/i386, Linux/armv4l, FreeBSD/i386, OpenBSD/i386
7 24
 Solaris/sparc64 
... ...
@@ -36,9 +53,9 @@ OS Notes:
36 36
   install a newer regex library version (>=0.12). 
37 37
     
38 38
 
39
+2. Howto Build ser From Source Distribution
40
+-------------------------------------------
39 41
 
40
-
41
-Howto:
42 42
 (NOTE: if make doesn't work try gmake  instead)
43 43
 
44 44
 - compile with default options:
... ...
@@ -130,36 +147,40 @@ make prefix=/usr/local  install
130 130
 
131 131
 
132 132
 
133
-Quick-Start Installation Guide
133
+3. Quick-Start Installation Guide
134 134
 ----------------------------------------------
135 135
 
136
-This guide give you instructions on how to
137
-set up the SIP Express Router (ser) on your
138
-box quickly. In case the default configuration
136
+A) Getting Help
137
+
138
+This guide gives you instructions on how to set up the SIP Express 
139
+Router (ser) on your box quickly. In case the default configuration
139 140
 does not fly, check documentation at ser site
140
-  http://www.iptel.org/ser
141
-If the documentation does not resolve your 
142
-problem you may try contacting us by E-mail at
143
-  serhelp@iptel.org
141
+  http://www.iptel.org/ser/
142
+
143
+If the documentation does not resolve your problem you may try contacting 
144
+us by E-mail at serusers@iptel.org -- that is the mailing list of ser
145
+community from which you can get most rapid help. To participate in the
146
+mailing list, subscribe at the following web address:
147
+  http://mail.iptel.org/mailman/listinfo/serusers
148
+
149
+If you are concerned about your privacy, you may post your questions to 
150
+iptel.org's helpline at serhelp@iptel.org.
151
+
152
+B) Disclaimers
144 153
  
145
-Note well the default configuration is very simple
146
-in order to be easily installable and provides
147
-minimum features. Particularly, authentication
148
-is disabled, which means anyone can register using
149
-any name with the server. (This is on purpose to
150
-avoid installation dependencies on MySQL which is
151
-needed for storing user credentials.)
154
+Note well the default "quick-start" configuration is very simple in order 
155
+to be easily installable. It provides minimum features. Particularly, 
156
+authentication is by default disabled, which means anyone can register using
157
+any name with the server. (This is on purpose to avoid installation 
158
+dependencies on MySQL which is needed for storing user credentials.)
152 159
 
153 160
 
154
-A) Quick Start
161
+C) Quick Start
155 162
 
156
-The following step-by step guide gives you
157
-instructions how to install the sql-free
158
-distribution of ser. If you need persistancy
159
-and authentication, then you have to install
160
-additional MySql support -- proceed to section B)
161
-after you are finished with A).
163
+The following step-by step guide gives you instructions how to install the 
164
+sql-free distribution of ser. If you need persistancy and authentication, 
165
+then you have to install additional MySql support -- proceed to section D)
166
+after you are finished with C).
162 167
 
163 168
 1) Download an RPM or debian package from our site
164 169
     http://www.iptel.org/ser
... ...
@@ -197,7 +218,7 @@ Solaris:
197 197
    serctl utility
198 198
     - to do so, first set the environment variable SIP_DOMAIN to your domain 
199 199
       name, e.g., in Bourne shell, call
200
-        export SIP_DOMAIN="foo.bar"
200
+        export SIP_DOMAIN="myserver.foobar.com"
201 201
 	- if you are using other than 'localhost' mysql server for maintaining
202 202
 	  subscriber database, change the variable 'SQL_HOST' to the proper
203 203
 	  host name in the serctl script
... ...
@@ -219,20 +240,16 @@ Solaris:
219 219
 
220 220
 
221 221
 
222
-B) ser with Persistent Data Storage
222
+D) ser with Persistent Data Storage
223 223
 ----------------------------------------------
224
-The default configuration is very simple and
225
-features many simplifications. In particular,
226
-it does not authenticate users and loses 
227
-User Location database on reboot. To provide
228
-persistency, keep user credentials and remember
229
-users' locations across reboots, ser can be
230
-configured to use MySQL. Before you proceed,
231
-you need to make sure MySQL is installed on
232
-your box.
233
-
234
-
235
-1) Download the package containing the ser mysql module from: 
224
+The default configuration is very simple and features many simplifications. 
225
+In particular, it does not authenticate users and loses User Location 
226
+database on reboot. To provide persistency, keep user credentials and remember 
227
+users' locations across reboots, ser can be configured to use MySQL. Before you 
228
+proceed, you need to make sure MySQL is installed on your box.
229
+
230
+
231
+1) Download the package containing mysql support for ser from: 
236 232
     http://www.iptel.org/ser/
237 233
     (rpm and deb provided, most of the binary tar.gz distributions and the 
238 234
      solaris package include it; if it is not present you'll have to rebuild
... ...
@@ -244,7 +261,7 @@ your box.
244 244
 3) create MySQL tables
245 245
     /usr/sbin/ser_mysql.sh create
246 246
 4) configure ser to use SQL
247
-    uncomment all lines which are related to 
247
+    uncomment all lines in configuration file ser.cfg which are related to 
248 248
     authentication:
249 249
     - loadmodule "/usr/lib/ser/modules/mysql.so"
250 250
     - loadmodule "/usr/lib/ser/modules/auth.so"
... ...
@@ -253,33 +270,23 @@ your box.
253 253
     - if (!www_authorize("iptel.org", "subscriber")) {
254 254
         www_challenge("iptel.org", "0"); 
255 255
         break;
256
-      }; /* be sure to replace realm, the first parameter
257
-            in www_* actions, with name of your server;
258
-            some broken UAC implementations don't authenticate
259
-            otherwise
260
-          */
261
-5) restart the server
256
+      }; 
257
+5) be sure to replace realm, the first parameter in www_* actions, 
258
+   with name of your server; some broken UAC implementations don't 
259
+   authenticate otherwise; the authentication command in your
260
+   configuration script should look then like this:
261
+      if (!www_authorize("myserver.foobar.com", "subscriber")) {
262
+        www_challenge("myserver.foobar.com", "0"); 
263
+        break;
264
+      }
265
+6) restart the server
262 266
     /etc/init.d/ser restart
263
-6) you can now start  managing the server using
264
-   the serctl utility; you need to first set the
265
-   environment variable SIP_DOMAIN to your local
266
-   SIP realm, e.g.,
267
-       export SIP_DOMAIN="foo.bar"
268
-   The realm name should be the value you set in
269
-   step #4.
267
+7) you can now start  managing the server using the serctl utility; 
268
+   you need to first set the environment variable SIP_DOMAIN to your 
269
+   local SIP realm, e.g.,
270
+       export SIP_DOMAIN="myserver.foobar.com"
270 271
 
271 272
    a) watch the server status using 'serctl moni'
272
-   b) try to login as user 'admin' with password 'heslo'
273
+   b) try to login with your SIP client as user 'admin' with password 'heslo'
273 274
    c) try adding new users using 
274 275
        'serctl add <name> <password> <email>'
275
-
276
-
277
-
278
-C) Troubleshooting
279
-
280
-/etc/ser/ser.cfg
281
-/etc/init.d/ser restart
282
-listen
283
-aliases
284
-