[freeside] proposed change for /docs/config.html

[ivan]

This was never submitted as a proper patch against
htdocs/docs/config.html, and seems to be pretty much obsoleted by the
(much better) 1.3.0 documentation, so I'm removing it from my queue of
things to look at.

If there are documentation updates from the message below or in general,
please send them as unified context diffs against the current
documentation and I'll be happy to apply them.

Take care.

On Fri, Mar 09, 2001 at 08:31:43AM -0500, Curtis Maurand wrote:
> Hi,
>  
> Proposed change to the documentation for clarity.
> 
> for config.html
> 
> 
> To setup the configuration files for Freeside 1.2.x you must create the directories /usr/local/etc/freeside and either of the following depending which database you are running.
> 
>          DBA                directory name
> ---------------------------------------------------------------------------------------------- 
>     mysql            /usr/local/etc/freeside/conf.DBI:mysql:freeside
>     PostgreSQL       /usr/local/etc/freeside/conf.DBI:Pg:dbname=freeside
> 
> These directories should not be world readable.
> You must have a file called "mapsecrets" in the mapsecrets file, you need the username and the name of  a file to contain user information for each user that will authorized to use freeside.  Authentication is handled by Apache.  If you've configured Ap
ache for user authentication properly, Apache will pass the username to freeside which uses the info contained in each user information file for connectivity to the freeside datbase.   The format of the map secrets file is:
> 
> username                    <name of userinformation file>
> 
> for example:
> 
> username        username.txt
> 
> more elaborately, you could create a users directory and put your user information files in there:
> 
> username        users/username.txt
> 
> Each user information file has three lines and format is:
> 
> DBI:mysql:freeside (or DBI:Pg:dbname=freeside if you're using PostgreSQL)
> DB_username
> DB_password
> 
> example:
> 
> DBI:mysql:freeside
> freesideuser
> password
> 
> 
> 
> Where the first line is the databese connectivity definition. The second line is the username of the user that is connecting to the database.  The third line is that user's database password.
> 
>  

-- 
meow
_ivan