label_alt_logo
2016-12-01

KeyHelp® 14.7.2 – Traffic Statistics

by Alexander Mahr

The latest version of KeyHelp® 14.7.2 is now available for installation on your server.

New Features in Version 14.7.2

  • Traffic statistics
  • Email client auto-configuration
  • Activate / deactivate support access

In addition to important error corrections and improvements, the main feature of the version 14.7.2 are the traffic statistics. They allow you to get an overview of the current traffic consumption of the KeyHelp® users created on the server, broken down by HTTP, FTP, IMAP / POP3, SMTP.

Furthermore, KeyHelp now provides an interface for the automatic configuration of email clients. Thus the creation of email accounts in your client (for example, Thunderbird, etc.) is simplified significantly.

In addition, if you need help from the KeyHelp support, you can optionally enable support access. Thereby you allow access to your server for support.

An overview of all innovations, improvements and error corrections can be found in our changelog:

https://changelog.keyhelp.de


Changes in configuration files

The following instructions are only relevant if you have protected your configuration files with “chattr +i”. Otherwise, the changes are automatically performed by the KeyHelp update routine.

[ /etc/apache/keyhelp/keyhelp.conf ]

Open the file „/etc/apache/keyhelp/keyhelp.conf“ and add the following lines to the beginning of the file:

<IfModule mod_logio.c>
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O" keyhelp_log
</IfModule>
<IfModule !mod_logio.c>
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" 0 0" keyhelp_log
</IfModule>

Then find the line:

Include keyhelp/webmail.conf

Insert the following line directly below:

# autoconfig subdomain

 

Include keyhelp/autoconfig.conf

Save the file and reload the Apache configuration with:

service apache2 reload


[ /etc/logrotate.d/keyhelp-apache ]

Open the file „/etc/logrotate.d/keyhelp-apache“ and find the line:

/usr/share/doc/awstats/examples/awstats_updateall.pl now -awstatsprog=/usr/lib/cgi-bin/awstats.pl > /dev/null

Replace the found line with this line:

/usr/bin/php /home/keyhelp/www/keyhelp/incl/cronjob/mastercronjob.php --force-statistic > /dev/null

[ /etc/dovecot/dovecot.conf ]

Find these lines:

protocol imap { mail_plugins = $mail_plugins imap_quota }

Add the following within the brackets:

# IMAP logout format string:
# %i - total number of bytes read from client
# %o - total number of bytes sent to client
imap_logout_format = in=%i out=%o

Find these lines:

protocol pop3 { pop3_uidl_format = UID%u-%v }

Add the following within the brackets:

# POP3 logout format string:
# %i - total number of bytes read from client
# %o - total number of bytes sent to client
# %t - number of TOP commands
# %p - number of bytes sent to client as a result of TOP command
# %r - number of RETR commands
# %b - number of bytes sent to client as a result of RETR command
# %d - number of deleted messages
# %m - number of messages (before deletion)
# %s - mailbox size in bytes (before deletion)
# %u - old/new UIDL hash. may help finding out if UIDLs changed unexpectedly
pop3_logout_format = in=%i out=%o top=%t/%p retr=%r/%b del=%d/%m size=%s

Save the file and reload the Dovecot configuration with:

service dovecot reload