- 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
- Create the /usr/local/etc/freeside/conf.datasource directory, 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
- The rest of the configuration can be done with the web interface. Select Configuration from the main menu and update your configuration values.