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 223
 C) Quick Start
224 224
 
225 225
 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, 
226
+sql-free distribution of ser. If you need persistence and authentication, 
227 227
 then you have to install additional MySql support -- proceed to section D)
228 228
 after you are finished with C).
229 229
 
230 230
 1) Download an RPM or debian package from our site
231 231
     http://www.iptel.org/ser
232
-If you don't use an rpm or debian based distro, try our tar.gz'ed binaries
232
+If you don't use an rpm or debian based distribution, try our tar.gz'ed binaries
233 233
  (ser-$(version)_$(os)_$(arch).tar.gz, e.g: ser-0.8.8_linux_i386.tar.gz).
234 234
 If you use Solaris 8 you can try our solaris package.
235 235
 If you use Gentoo Linux you do not have to download a package.
... ...
@@ -257,7 +282,7 @@ RPM + gentoo:
257 257
     /etc/init.d/ser start
258 258
 debian:
259 259
     ser is started automatically after the install
260
-    (in case something fails you can start it wiht /etc/init.d/ser start)
260
+    (in case something fails you can start it with /etc/init.d/ser start)
261 261
 tar.gz:
262 262
     the tar.gz does not include an init.d script, you'll have to create one of
263 263
     your own or adapt one from the source distribution (debian/init.d,
... ...
@@ -285,7 +310,7 @@ Solaris:
285 285
    hints for use of iptel.org site at
286 286
      http://www.iptel.org/phpBB/viewforum.php?forum=1&8
287 287
    For example, users of Windows Messenger need to set
288
-   in Tools->Options->Accounts the foolowing values:
288
+   in Tools->Options->Accounts the following values:
289 289
      Sign-in Name: <username>@<your_server_address>
290 290
      Advanced->Configure Settings (on)
291 291
      Advanced->Server: <your_server_address>
... ...
@@ -297,7 +322,7 @@ D) ser with Persistent Data Storage
297 297
 
298 298
 The default configuration is very simple and features many simplifications. 
299 299
 In particular, it does not authenticate users and loses User Location database 
300
-on reboot. To provide persistency, keep user credentials and remember users' 
300
+on reboot. To provide persistence, keep user credentials and remember users' 
301 301
 locations across reboots, ser can be configured to use MySQL. Before you proceed, 
302 302
 you need to make sure MySQL is installed on your box. Your MySQL server must be 
303 303
 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 327
 	- otherwise, if this is your very first installation, use
328 328
     	/usr/sbin/ser_mysql.sh create
329 329
 	  to create SER database structures
330
-   (you will be promted for password of MySql "root" user)
330
+   (you will be prompted for password of MySql "root" user)
331 331
 4) configure ser to use SQL
332 332
     uncomment all lines in configuration file ser.cfg which are related to 
333 333
     authentication: