Configuration

The following options are valid in the configuration file. For other configuration options in other sections refer to the various feature modules.

Server

user

User to run this daemon as.

pid_file<

Filename to store pid of parent process.

Logging:

log_level

Specify which log messages to show. Defaults is 2.

0 - Errors only
1 - Warnings and errors
2 - Notices, warnings, errors
3 - Info, notices, warnings, errors
4 - Debugging

log_file

File to log to instead of stdout.

log_detail

Things to log in extreme detail. There is no default for this option. Options can be separated by commas.

Network:

host

IP to listen on, * for all.

timeout

Timeout in communication with clients.

Database

SMRadius is based on the Perl DBI layer and currently has support for MySQL, Postgres and SQLite 3. The database schema files are located in database/ along with a script used to convert to the various formats. The following configuration options are valid in the database section of the config file.

bypass_mode

What do we do when we have a database connection problem tempfail - Return temporary failure pass - Return success

bypass_timeout

How many seconds before we retry a DB connection

dsn

DSN of the database you'd like to use. Here are a few examples...

MySQL:

DSN=DBI:mysql:database=smradius;host=localhost

Username=your_username

Password=your_password

PostgreSQL:

DSN=DBI:Pg:database=smradius;host=localhost

Username=your_username

Password=your_password

SQLite:

DSN=DBI:SQLite:dbname=smradius.sqlite

 

username

Some databases require a username to be specified, you can specify it using this option.

password

Some databases require a password to be specified, you can specify it using this option.

Dictionary

Dictionary configuration.

load

Dictionaries to load for the radius attributes, one per line.

Authentication

mechanisms

Authentication mechanisms one per line.

users

UserDB modules one per line.

System

plugins

One per line. System plugins to load, the most common plugin to use here is those for configuration.

Features

Feature plugins implement various functionality in SMRadius, examples are capping and notifications.

plugins

Feature plugins to load, one per line.

Accounting

Accounting plugins are responsible for logging and updating accounting requests.

plugins

Accounting plugins to load, one per line.

Index