.TH "eurephiadm" "7" "July 2010" "David Sommerseth" ""
.SH "NAME"
eurephiadm \- eurephia administration utility
.SH "SYNOPSIS"
.B eurephiadm\fR
.RI "<command>"
.RI "[\\-h|\\-\\-help] [\\-V|\\-\\-version] [<global options>]"
.RI "[\\-l|\\-\\-log <filename>] [\\-L|\\-\\-log\\-level <log level>]"
.RI "[<command arguments>]"
.SH "DESCRIPTION"
.B eurephiadm
is a generic command line tool for administering and
configuring the eurephia plug\-in for OpenVPN.
.SH "COMMANDS"
Available commands in
.B eurephiadm
.TP
\fBhelp\fR [<command>]
This help screen if no arguments are given.  If a command is given, the help screen for that command is provided.
.TP
\fBlogout\fR
Logout from an active eurephiadm session.  Most of the operations in eurephiadm requires the user to authenticate him/herself.  The session will then be active for a predefined amount of time, not requiring new authentications.  The user will have to authenticate him/herself again if the session timesout or the \fBlogout\fR command is used.
.TP
\fBusers\fR [<arguments>]
User management module.  Lists, adds, removes, activates, deactivates and shows user account information for each eurephia user.
.TP
\fBlastlog\fR
Query the eurephia lastlog.  This log contains information about OpenVPN session authenticated via eurephia.
.TP
\fBattempts\fR [<arguments>]
Show or reset registered failed login attempts registrations.
.TP
\fBblacklist\fR [<arguments>]
Show, add or delete blacklisted user accounts, certificates or IP addresses.
.TP
\fBcerts\fR [<arguments>]
SSL Certificate management for eurephia authentication.
.TP
\fBusercerts\fR [<arguments>]
Manages the relations between eurephia user accounts and certificates.  This combination is called a user access, and defines which access level the authenticated eurephia user will have to the network.
.TP
\fBfwprofiles\fR [<arguments>]
Firewall profile management.  Add, list or delete (iptables) profiles available for eurephia in the operating system.  This feature is only available if eurephiadm was compiled with firewall support.
.TP
\fBadminaccess\fR [<arguments>]
Manages eurephia user accesses to administration utilities like \fBeurephiadm\fR.
.TP
\fBshow\-config\fR
List all config settings set in the database and in the \fB~/.eurephia/eurephiadm.cfg\fR file.
.TP
\fBshow\-configfile\fR
Similar to the \fBshow\-config\fR command, but lists only the parsed settings in the \fB~/.eurephia/eurephiadm.cfg\fR file.
.TP
\fBconfig\fR [<arguments>]
Add, delete or show eurephia configuration settings stored in the database.
.SH "FILES"
.TP
.B ~/.eurephia/eurephiadm.cfg
Default configuration file which defines the database driver and the needed database parameters.
.SH "CONFIGURATION FILE"
The configuration file is a simple key\-value based text file, where keys and values are separated by an equal sign ("=").  All text coming after a hash ("#") will be ignored and considered as comments.  The variables eurephiadm uses are:
.TP
.B database_driver
Contains a full path to the database driver eurephiadm need to use.
.TP
.B database_params
All database arguments the database driver requires must be set here.  See the man page for the corresponding database driver for more information about valid options.
.TP
.B log
Defines how to log.  If a file name is given, logging will be sent to this log file.  Other valid values are:
.IP
\fBstderr:\fR or \fBstdout:\fR
.br
Logging will go directly to stderr or stdout
.IP
\fBsyslog:[local0..local7 | daemon | authpriv]\fR
.br
Logging will be sent to syslog.  The default syslog destination is \fRdaemon\fB.
.TP
.B log_level
Sets the log verbosity.  Normally the values will be from 0 to 10, where 0 is as little logging as possible and 10 is very verbose.  If eurephiadm or the database driver is compiled with debug logging, values up to 50 will be valid.
.TP
.B username
\fBeurephiadm\fR will always be asking for a user name when logging into the administration application.  By setting this variable, you will set a default user name eurephiadm will use when logging in and it will only ask for a password directly.
.SH "ENVIRONMENT"
.TP
.B EUREPHIA_DIR
The \fBeurephiadm\fR utility looks for a configuration file by default in \fB~/.eurephia/eurephiadm.cfg\fR.  This directory can be overridden by setting the \fBEUREPHIA_DIR\fR environment variable, and eurephiadm will use the \fBeurephiadm.cfg\fR file in this directory instead.
.SH "SEE ALSO"
\fBeurephiadm\-users\fR(7),
\fBeurephiadm\-lastlog\fR(7),
\fBeurephiadm\-attempts\fR(7),
\fBeurephiadm\-blacklist\fR(7),
\fBeurephiadm\-certs\fR(7),
\fBeurephiadm\-usercerts\fR(7),
\fBeurephiadm\-fwprofiles\fR(7),
\fBeurephiadm\-adminaccess\fR(7),
\fBeurephiadm\-config\fR(7),
\fBedb\-sqlite\fR(7)
.SH "AUTHOR"
Copyright (C) 2008\-2012  David Sommerseth <dazo@users.sourceforge.net>