SessionDatabase

Specify the location of the file-based sessions directory or DBM file.

Synopsis

The parameter is expected to be either a directory name, or the name of a DBM file.  The default is "session".

The path must be relative to the website's home directory, as specified with the Catalog global configuration directive.

Scope

This directive is only available for use in the local (catalog.cfg) configuration file.  It will not affect any other website in any way.  This directive will not work in the global (interchange.cfg) configuration file. 

Description

This directive specifies the name of the directory, or DBM file, to use for the storage of user session information.

Warning Do not confuse this configuration directive with the similarly-named SessionDB directive.

If the default file-based sessions are in use, then the name of the directory should be specified.  For instance:

This also applies for NFS sessions, of course.

If the DB_File or GDBM SessionType is selected then the name will be expected to be the path to the DB/GDBM file, and a ".db" or ".gdbm" suffix will be appended to the filename, as appropriate.

It is possible for multiple websites to share the same session directory or DB_File/GDBM file, as well as for multiple Interchange servers to serve the same websites.  If serving an extremely busy website, multiple parallel Interchange servers can share the same NFS-based file system and serve users using the session files.  On huge systems, the level of directory hashing may be changed.  By default, only 48 * 48 hashing is done.  The hashing mechanism is coded into the Vend::SessionFile module and can only be modified by editing the Interchange core source code.