2.5  Configuration Wizard

The installation program for  Windows and MacOS X operating systems automatically runs a wizard that helps to set the basic parameters for Kerio MailServer. This wizard can be invoked anytime later by running cfgWizard.exe (prior to running the wizard, the Kerio MailServer service must be stopped). After running the wizard, existing configuration files will be deleted.

The wizard can be also run on Linux. When a corresponding RPM package is installed, user will be informed that the wizard is available. This information is also provided by the daemon if it detects that the wizard has not been used yet. To run the wizard use the following command:

/opt/kerio/mailserver
./cfgwizard

Warning: Kerio MailServer must be stopped while settings are changed in the configuration wizard.

Note: The configuration wizard for all operating systems is available in English version only.

Primary domain and internet name of the server

To create user accounts (or groups) in Kerio MailServer, at least one local domain must be created. The first local domain created is the primary domain. Unlike in the other local domains, users can login by their usernames (In the other domains, it is necessary to use the full email address. For detailed information on domains, see chapter 7  Domains).

Configuration Wizard — creation of the primary domain

Figure 2.14. Configuration Wizard — creation of the primary domain


It is also necessary to insert the name of the server where Kerio MailServer is installed. In the Hostname field, enter the Internet DNS name of the computer where Kerio MailServer is installed (typically, this would be the name of the computer with the appended primary domain name — this way the server name is automatically suggested by the configuration wizard). Server names are used for server identification while establishing SMTP traffic.

Note: If Kerio MailServer is running behind NAT, enter the Internet hostname that can be converted to the IP address of the sending server, i.e. the internet hostname of the firewall.

Administrator Password Settings

Administrator password is a very important aspect of your server security. Blank password is not accepted. For security reasons passwords should consist at least of six characters.

Configuration Wizard — user account creation

Figure 2.15. Configuration Wizard — user account creation


Password and its confirmation must be entered in the dialog for account settings. The name 'administrator' can be changed in the Username edit box.

Store Directory Selection

Kerio MailServer stores a relatively large amount of data (email messages, information about user folders, records, etc.). The administrator can select a different location to store data (e.g. another disk partition, RAID etc.). The store directory can be changed anytime later through the Kerio Administration Console (see chapter 15.6  Advanced Options). If the location is changed then it is necessary to move the files located in this directory to the new location. Prior to this potentially very time-consuming operation, the Kerio MailServer Engine must be stopped. Therefore it is recommended that you select a location with sufficient space for growth during the installation — using the configuration wizard.

Configuration Wizard — folder selection

Figure 2.16. Configuration Wizard — folder selection


The Change button opens the standard system dialog for folder selection.

The last step of the initial configuration

The last dialog provides information about writing of the settings in the configuration files (on Windows only):

Information about successful completion of the primary domain configuration

Figure 2.17. Information about successful completion of the primary domain configuration


users.cfg

The users.cfg file is an XML file that includes information about user account, groups and aliases.

Administration name and password was written in this file by the configuration wizard.

mailserver.cfg

mailserver.cfg is an XML file containing any other parameters of Kerio MailServer, such as configuration parameters of domains, back-ups, antispam filter, antivirus, etc.

In this file, the local primary domain just created, Internet name of the server as well as the location of the message store was written.