Browse code

Added a note on make parameters Spellchecked

Jan Janak authored on 25/04/2004 19:46:31
Showing 1 changed files
... ...
@@ -12,7 +12,7 @@ $Id$
12 12
   This memo gives you hints how to set up SER quickly. To 
13 13
   understand how SER works and how to configure it properly,
14 14
   read admin's guide available from SER website. We also
15
-  urgue you to read latest ISSUES (available from SER website 
15
+  urge you to read latest ISSUES (available from SER website 
16 16
   too) and check for potential problems in this release.
17 17
   Users of previous releases are encouraged to read NEWS to
18 18
   learn how to move to this new SER version.
... ...
@@ -43,9 +43,9 @@ TOC
43 43
 1. Supported Architectures and Requirements
44 44
 -------------------------------------------
45 45
 
46
-Supported arhitectures: Linux/i386, Linux/armv4l, FreeBSD/i386, OpenBSD/i386
46
+Supported architectures: Linux/i386, Linux/armv4l, FreeBSD/i386, OpenBSD/i386
47 47
 Solaris/sparc64, NetBSD/sparc64
48
-(for other arhitectures the Makefiles might need to be edited)
48
+(for other architectures the Makefiles might need to be edited)
49 49
 
50 50
 There are various configuration options defined in the Makefile.
51 51
 
... ...
@@ -186,6 +186,31 @@ Install:
186 186
 
187 187
 make prefix=/usr/local  install
188 188
 
189
+Note: If you use prefix parameter in make install then you also need
190
+to use this parameter in previous make commands, i.e. make, make modules,
191
+or make all. If you fail to do this then SER will look for the default
192
+configuration file in a wrong directory, because the directory of the
193
+default configuration file is hard coded into ser during compile time. 
194
+When you use a different prefix parameter when installing then the 
195
+directory hard coded in ser and the directory in which the file will be 
196
+installed by make install will not match. (You can specify exact location
197
+of the configuration file using -f parameter of ser).
198
+
199
+For example, if you do the following:
200
+make all
201
+make prefix=/ install
202
+
203
+Then the installation will put the default configuration file into
204
+/etc/ser/ser.cfg (because prefix is /), but ser will look for the file
205
+in /usr/local/etc/ser/ser.cfg (because there was no prefix parameter
206
+in make all and /usr/local is the default value of prefix).
207
+
208
+Workaround is trivial, use the same parameters in all make commands:
209
+make prefix=/ all
210
+make prefix=/ install
211
+
212
+That applies to other make parameters as well (for example parameters
213
+"modules" or "excluded_modules").
189 214
 
190 215
 
191 216
 3. Quick-Start Installation Guide
... ...
@@ -223,13 +248,13 @@ dependencies on MySQL which is needed for storing user credentials.)
223 248
 C) Quick Start
224 249
 
225 250
 The following step-by step guide gives you instructions how to install the 
226
-sql-free distribution of ser. If you need persistancy and authentication, 
251
+sql-free distribution of ser. If you need persistence and authentication, 
227 252
 then you have to install additional MySql support -- proceed to section D)
228 253
 after you are finished with C).
229 254
 
230 255
 1) Download an RPM or debian package from our site
231 256
     http://www.iptel.org/ser
232
-If you don't use an rpm or debian based distro, try our tar.gz'ed binaries
257
+If you don't use an rpm or debian based distribution, try our tar.gz'ed binaries
233 258
  (ser-$(version)_$(os)_$(arch).tar.gz, e.g: ser-0.8.8_linux_i386.tar.gz).
234 259
 If you use Solaris 8 you can try our solaris package.
235 260
 If you use Gentoo Linux you do not have to download a package.
... ...
@@ -257,7 +282,7 @@ RPM + gentoo:
257 282
     /etc/init.d/ser start
258 283
 debian:
259 284
     ser is started automatically after the install
260
-    (in case something fails you can start it wiht /etc/init.d/ser start)
285
+    (in case something fails you can start it with /etc/init.d/ser start)
261 286
 tar.gz:
262 287
     the tar.gz does not include an init.d script, you'll have to create one of
263 288
     your own or adapt one from the source distribution (debian/init.d,
... ...
@@ -285,7 +310,7 @@ Solaris:
285 310
    hints for use of iptel.org site at
286 311
      http://www.iptel.org/phpBB/viewforum.php?forum=1&8
287 312
    For example, users of Windows Messenger need to set
288
-   in Tools->Options->Accounts the foolowing values:
313
+   in Tools->Options->Accounts the following values:
289 314
      Sign-in Name: <username>@<your_server_address>
290 315
      Advanced->Configure Settings (on)
291 316
      Advanced->Server: <your_server_address>
... ...
@@ -297,7 +322,7 @@ D) ser with Persistent Data Storage
297 322
 
298 323
 The default configuration is very simple and features many simplifications. 
299 324
 In particular, it does not authenticate users and loses User Location database 
300
-on reboot. To provide persistency, keep user credentials and remember users' 
325
+on reboot. To provide persistence, keep user credentials and remember users' 
301 326
 locations across reboots, ser can be configured to use MySQL. Before you proceed, 
302 327
 you need to make sure MySQL is installed on your box. Your MySQL server must be 
303 328
 configured to deal with a large number of connection. To increase it, set the 
... ...
@@ -327,7 +352,7 @@ following line in [mysqld] section of your configuration file:
327 352
 	- otherwise, if this is your very first installation, use
328 353
     	/usr/sbin/ser_mysql.sh create
329 354
 	  to create SER database structures
330
-   (you will be promted for password of MySql "root" user)
355
+   (you will be prompted for password of MySql "root" user)
331 356
 4) configure ser to use SQL
332 357
     uncomment all lines in configuration file ser.cfg which are related to 
333 358
     authentication: