From d8bb43c4735c6faab56eba98459d8732eb45fa68 Mon Sep 17 00:00:00 2001 From: ivan Date: Fri, 13 Nov 1998 02:43:32 +0000 Subject: [PATCH] update documentation for new config file format --- htdocs/docs/config.html | 16 ++++++++++++++-- htdocs/docs/upgrade3.html | 3 ++- 2 files changed, 16 insertions(+), 3 deletions(-) diff --git a/htdocs/docs/config.html b/htdocs/docs/config.html index 9b8002601..9bd924f8f 100644 --- a/htdocs/docs/config.html +++ b/htdocs/docs/config.html @@ -3,7 +3,20 @@

Configuration files

-Configuration files and directories are located in `/var/spool/freeside/conf'. +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?). The default path for the filename is +`/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. +

+All further configuration files and directories are located in +`/usr/local/freeside/conf.datasource', for example, +`/usr/local/freeside/conf.DBI:Pg:dbname=freeside'

address - Your company name and address, four lines.
bsdshellmachines - Your BSD flavored shell (and mail) machines, one per line. This enables export of `/etc/passwd' and `/etc/master.passwd'. @@ -27,7 +40,6 @@ Configuration files and directories are located in `/var/spool/freeside/conf'.
registries/internic/to - Email address to which InterNIC domain registrations are sent.

secrets - 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.

sendmailmachines - Your sendmail machines, one per line. This enables export of `/etc/virtusertable' and `/etc/sendmail.cw'.

shellmachine - A single machine with user home directories mounted. This enables home directory creation, renaming and archiving/deletion. In conjunction with `qmailmachines', it also enables `.qmail-extension' file maintenance.

shellmachines - Your Linux and System V flavored shell (and mail) machines, one per line. This enables export of `/etc/passwd' and `/etc/shadow' files. diff --git a/htdocs/docs/upgrade3.html b/htdocs/docs/upgrade3.html index 37eead3ef..181cf2a42 100644 --- a/htdocs/docs/upgrade3.html +++ b/htdocs/docs/upgrade3.html @@ -7,6 +7,7 @@

If migrating from 1.0.0, see these instructions first.

If migrating from less than 1.1.4, see these instructions first.

Back up your data and current Freeside installation. -

Install the Perl module

String-Approx +

Install the Perl module String-Approx +

Configuration file location has changed!

Copy or symlink htdocs and site_perl to the new copies. -- 2.11.0