From 0bdd3c05c6a3664d7ed9a191ef8ae4ade2162109 Mon Sep 17 00:00:00 2001 From: ivan Date: Sun, 15 Apr 2001 10:33:40 +0000 Subject: better docs for the worst bit, finally --- htdocs/docs/config.html | 38 ++++++++++++++++++++++++-------------- 1 file changed, 24 insertions(+), 14 deletions(-) (limited to 'htdocs/docs/config.html') diff --git a/htdocs/docs/config.html b/htdocs/docs/config.html index 216668591..db4b95427 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. This file contains three lines: DBI data source (for example, + DBI:mysql:freeside or DBI:Pg:dbname=freeside), database username, and database password. + This file should not be world readable. See the DBI manpage and the manpage for your DBD for the exact syntax of a DBI data source. For example: +
```
+DBI:Pg: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:dbname=freeside

address - This configuration file is no longer used. See invoice_template instead.
apacheroot - The directory containing Apache virtual hosts -- cgit v1.2.1