Section 3.31.21. SessionDatabase

3.31.21. SessionDatabase

This optional parameter specifies a particular Session Database to use for the enclosing Realm or Handler. The value of the parameter must be the Identifier of a SessionDatabase clause. The default behaviour is to use the last global SessionDatabase specified in the configuration file. If no SessionDatabases are specified in the configuration file, then the default INTERNAL session database will be used.

SessionDatabaseOptions is available for changing how a Handler uses its session database. For more information, see Section 3.31.22. SessionDatabaseOptions.

Tip

The user name used to access the session database depends on the setting of SessionDatabaseUseRewrittenName and SessionDatabaseOptions.

Tip

This is an advanced use parameter. Only very unusual configurations need this parameter to be set. The default behaviour suits for most situations.

<Handler xxxxxx>
      # If this was not here, we would default to
      # myspecialsessiondb2 (the last one in the config file)
      SessionDatabase myspecialsessiondb1
      .....
</Handler>
<SessionDatabase SQL>
      Identifier myspecialsessiondb1
      ....
</SessionDatabase>
<SessionDatabase SQL>
      Identifier myspecialsessiondb2
      .... 
</SessionDatabase>