25.2  Configuration files

This chapter provides clear descriptions of WinRoute configuration and status files. This information can be helpful for example when troubleshooting specific issues in cooperation with the Kerio Technologies technical support department.

For backup and recovery of your firewall configuration, it is recommended to use configuration export and import tools addressed in chapter 25.1  Configuration Backup and Transfer!

Configuration files

All WinRoute configuration data is stored in the following files under the same directory where WinRoute is installed

(the typical path is C:\Program Files\Kerio\WinRoute Firewall).

The following files are included:

winroute.cfg

Chief configuration file

UserDB.cfg

Information about groups and user accounts.

host.cfg

Preferences for backs-up of configuration, user accounts data, DHCP server database, etc.

logs.cfg

Log configurations

Note: The data in these files are saved in XML format so that it can be easily modified by an advanced user or generated automatically using another application.

Files in the following directories are also considered as configuration data:

dbSSL

An automatically generated SSL certificate generated for traffic between the WinRoute Firewall Engine and the Administration Console.

For details on traffic between the WinRoute Firewall Engine and the Administration Console, refer to Kerio Administration Console — Help (http://www.kerio.com/firewall/manual).

sslcert

SSL certificates for all components using SSL for traffic encryption (i.e. the web interface, VPN server and the Clientless SSL-VPN interface).

license

If WinRoute has already been registered, the license folder includes a license key file (including registered trial versions). If WinRoute has not been registered yet, the license folder is empty.

Status files

In addition, WinRoute generates other files and directories where certain status information is saved:

Files:

dnscache.cfg

DNS files stored in the DNS module's cache (see chapter 8.1  DNS module).

leases.cfg

IP addresses assigned by the DHCP server.

This file keeps all information available on the Leases tab of the Configuration → DHCP server section (refer to chapter 8.2  DHCP server).

stats.cfg

Interface statistics (see chapter 20.2  Interface statistics) and user statistics (see chapter 20.1  Volume of transferred data and quota usage) data.

vpnleases.cfg

IP addresses assigned to VPN clients (see chapter 23.2  Configuration of VPN clients).

Directories:

logs

The logs directory stores all WinRoute logs (see chapter 22  Logs).

star

The star directory includes a complete database for statistics of the WinRoute web interface.

Handling configuration files

We recommend that WinRoute Firewall Engine be stopped prior to any manipulation with the configuration files (backups, recoveries, etc.)! Information contained within these files is loaded and saved only upon starting or stopping the MailServer. All changes to the configuration performed while the Engine is running are only stored in memory. All modifications done during Engine performance will be overwritten by the configuration in the system memory when the Engine is stopped.