Section 3.20. <SessionDatabase DBM>

3.20. <SessionDatabase DBM>

This optional clause specifies an external DBM file Session Database for radiusd. The Session Database is used to hold information about current sessions as part of Simultaneous-Use limit checking. It can also be used by external utilities for querying the online user population If you do not specify a SessionDatabase clause, the database will be kept internal to radiusd, which is faster, but does not make the data available to other processes.

CAUTION

Because Radiator does not lock the DBM file, a single SessionDatabase DBM file should never be used by more than one instance of Radiator. When attempting to enforce Simultaneous-Use limits across multiple Radiator servers, always use Session-Database SQL.

Radiator will choose the best format of DBM file available to you, depending on which DBM modules are installed on your machine. (Hint: You can force it to choose a particular format by using the DBType parameter)

<SessionDatabase DBM> understands also the same parameters as <SessionDatabase xxxxxx>. For more information, see Section 3.17. <SessionDatabase xxxxxx>.

3.20.1. Filename

Specifies the filename that holds the Session Database. Defaults to %D/online, The actual file names will depend on which DBM format Perl selects for you, but will usually be something like online.dir and online.pag in DbDir. The file name can include special formatting characters. For more information, see Section 3.3. Special formatters.

# Session database in called online2.* in DbDir
Filename %D/online

3.20.2. DBType

By default, Radiator and Perl will choose the ‘best’ format of DBM file available to you, depending on which DBM modules are installed on your machine. You can override this choice by specifying DBType as the name of one of the DBM formats supported on your platform. The typical choices are:

AnyDBM_File
NDBM_File
DB_File
GDBM_File
SDBM_File
ODBM_File

But not may be available on your platform. The default is AnyDBM_File, which chooses the best available implementation.

# Force it to use DB_File
DBType DB_File

3.20.3. SessionIdentifier

This optional parameter sets the name of a Radius attribute which is used to identify a session. It is useful, for example, when the authentication request contains the session identifier attribute for the subsequent accounting session. The default value is Acct-Session-Id.

# This vendor sends id of subsequent accounting session during authentication
SessionIdentifier Vendor-Session-Id