$Id: scass.conf.txt,v 1.1 2002/08/12 01:40:16 als Exp $

Documentation for the scass-(fes|bes).conf configuration files
--------------------------------------------------------------

SCASS uses two configuration files:
  - scass-fes.conf for the frontend SCASS.fes and
  - scass-bes.conf for the backend SCASS.bes

Those files are expected in /etc - if you place them elsewhere, you have
to edit the appropriate modules of SCASS. Since SCASS already requires a
database, there is no sense in storing configuration data in files - the 
database can do that as well. We still need those configuration files
because we must somehow be able to access that database. Therefore, the
configuration files contain only the data needed to access the database.

structure of the configuration files:
scass-fes.conf:

---- cut here ----
# example configuration file for SCASS.fes
DBHost = databaseserver.company.domain
DBPort = 5432
DBName = scass
PublicDBUser = FESUser
PublicDBPassword = FESUserPassword
---- cut here ----

scass-bes.conf:

---- cut here ----
# example configuration file for SCASS.bes
DBHost = databaseserver.company.domain
DBPort = 5432
DBName = scass
DBUser = BESUser
DBPassword = BESUserPassword
---- cut here ----

Explanation of the entries:
 - DBHost: the hostname of your database server, you obviously need to 
   change this to match your setup,
 - DBPort: the port PostgreSQL listens for incoming connects, this is 
   the default port and should not need changing,
 - DBName: the name of the database, changing this is strongly discouraged,
   since it requires you to change some other parts of SCASS as well,
 - DBUser: the username for the backend system as created and listed in the
   BES class during the install of the database part of SCASS,
 - DBPassword: the password of this user,
 - PublicDBUser: the username for the frontend system als created and listed
   in the FES  class during the install of the database part of SCASS,
 - PublicDBPassword the password for this user,


Since both configuration file contain password information, it is strongly
suggested to protect them with appropriate permissions from user who don't
need to know this information. In the case of scass-fes.conf this might be
almost impossible (depending on your setup), but if you followed the setup
instructions closely, this user (PublicDBUser) will only have SELECT 
privileges and no other privileges on the SCASS database, so this password 
is not that important. But the DBUser has - according to the setup 
instructions - UPDATE privileges to a part of the SCASS database, so you 
should protect his password, which should be easier to do.



