4.2. Initialising the database
The eurephia_init program will be used to initialise the database with your runtime configuration. Depending on your distribution this program will either be a part of the default eurephia package or being a separate initialisation package. This program can safely be removed when eurephia is configured.
If you installed eurephia from source tree, you will find this program under eurephia-1.0.1/utils/eurephia_init. This program is not being installed to the filesystem when using the source tree.
user@host:~ $ eurephia_init --help
eurephia_init (v1.0.1) - eurephia initialisation utility
Copyright (C) 2009-2010 David Sommerseth <dazo@users.sourceforge.net>
This utility is only supposed to be used when installing eurephia. The
purpose is to initialise the database eurephia will use, by setting up
some standard configuration values and create an administrator account
Valid arguments:
-V | --version : Show version information
-h | --help : This help screen
-l | --log <filename> : Log file for debugging
-L | --log-level <log level> : Sets the log level
-N | --hash-threshold-min <ms> : Benchmarking parameter, see below. Default 95ms
-M | --hash-threshold-max <ms> : Benchmarking parameter, see below. Default 200ms
-D | --database-driver <path> : Full path to the database driver
-d | --database-args <args> : Required database arguments for the driver
* Benchmarking
During the initialisation this utility will benchmark the CPU power by doing
multiple SHA512 hash calculations. This is to determinate the optimal rounds
the password hashes should use on the current computer. To make it more difficult
to brute force passwords, eurephia implements dynamic password hash rounds, based
on a random number within in a given range. This benchmark will suggest an optimal
range. To do this, two limits are defined, the shortest time and the longest time
to be used for calculating a hash. The default values are 95ms and 200ms.
If you want to modify those thresholds, you can do so with the --hash-threshold-min
and --hash-threshold-max options. By increasing these numbers, you will allow the
number of rounds to be increased.
user@host:~ $
There are two required options which needs to be given, --database-driver and --database-args. The database driver arguments must be a full path to the database driver you will be using. And the database arguments is defined by the given database driver.
The SQLite3 database driver takes only one argument. This argument must be a full path to the database file.
user@host: eurephia $ utils/eurephia_init --database-driver /usr/lib/eurephia/edb-sqlite.so \
--database-args /etc/openvpn/eurephiadb
