X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=htdocs%2Fdocs%2Fconfig.html;h=49be7200b60b9d20a85f949334688f353b157bff;hb=4d23190fe52f0c3c5071c806187a524ecfa52cdd;hp=216668591f74d30a5fad28e3ee2ae173dc040c10;hpb=c6f8c3da686ce048b987df1b9853ab217dcfb51b;p=freeside.git diff --git a/htdocs/docs/config.html b/htdocs/docs/config.html index 216668591..49be7200b 100644 --- a/htdocs/docs/config.html +++ b/htdocs/docs/config.html @@ -3,23 +3,33 @@

Configuration files

-Configuration file layout has changed in 1.2.x.

First, the file `/usr/local/etc/freeside/mapsecrets' is read. Each line -in this file contains a username and filename, separated by whitespace. Note -that these are not local usernames - they are passed from Apache (you _did_ -setup -user authetication, correct?). Filenames are located in -`/usr/local/etc/freeside/'. The specified filename is parsed exactly -the same as the pre-1.2.x `secrets' file: -
Three lines: Database engine datasource (for example, - `DBI:mysql:freeside' or `DBI:Pg:dbname=freeside'), username, and password. - This file should not be world readable. See the DBI manpage and the manpage - for your DBD for the exact syntax. +
Create the /usr/local/etc/freeside directory to hold your configuration. +
Setting up Apache user authetication is mandatory. +
Create the /usr/local/etc/freeside/mapsecrets file, which maps Apache users to a secrets file which contains a DBI data source, username and password. Every +line in /usr/local/etc/freeside/mapsecrets should contain a username and +filename, separated by whitespace. Note that these are not local usernames - +they are passed from Apache. +Apache user authetication is mandatory. For example, if you had the Apache users admin, +john, and sam, +you mapsecrets file might look like: +
```
+admin secretfile
+john secretfile
+sam secretfile
+
```
+
Next, the filename(s) referenced in /usr/local/etc/freeside/mapsecrets file should be created in the /usr/local/etc/freeside/ directory. Each file contains three lines: DBI data source (for example, + DBI:mysql:freeside or DBI:Pg:host=localhost;dbname=freeside), database username, and database password. + These files should not be world readable. See the DBI manpage and the manpage for your DBD for the exact syntax of a DBI data source. In a normal installation such as the example above, a single file /usr/local/etc/freeside/secretfile would be created - for example: +
```
+DBI:Pg:host=localhost;dbname=freeside
+dbusername
+dbpassword
+
```

All further configuration files and directories are located in -`/usr/local/etc/freeside/conf.datasource', for example, -`/usr/local/etc/freeside/conf.DBI:Pg:dbname=freeside' +/usr/local/etc/freeside/conf.datasource, for example, +/usr/local/etc/freeside/conf.DBI:Pg:host=localhost;dbname=freeside (remember to backslash-escape the ; character when creating directories in the shell: mkdir /usr/local/etc/freeside/conf.DBI:Pg:host=localhost\;dbname=freeside).

address - This configuration file is no longer used. See invoice_template instead.
apacheroot - The directory containing Apache virtual hosts @@ -89,6 +99,8 @@ All further configuration files and directories are located in
textradiusprepend - The contents of this file will be prepended to the first line of a user's RADIUS entry in text exports. If necessary, usually `Auth-Type = Local, '.
usernamemin - Minimum username length (default 2);
usernamemax - Maximum username length (default is the size of the SQL column, probably specified when fs-setup was run) +
username-letter - The existance of this file will turn on the requirement that usernames contain at least one letter. +
username-letterfirst - The existance of this file will turn on the requirement that usernames start with a letter.