2.4  Installation
Prev Chapter 2  Installation Next

2.4  Installation

Kerio MailServer can be installed on one of these operating systems:

Microsoft Windows

It is recommended to perform the upgrade to Kerio MailServer 6.5.0 from Kerio MailServer 6.3 or 6.4.

Kerio MailServer supports the following versions of Microsoft Windows operating systems:

  • Windows 2000 (SP4)

  • Windows XP (SP2 or SP1)

  • Windows 2003 (SP2 or SP1)

  • Windows Vista (Business, Enterprise or Ultimate edition)

It is necessary that Kerio MailServer is installed under a user with administration rights for the system.

Kerio MailServer is supported on 32-bit operating systems.

Kerio MailServer is installed by using the Windows Installer. Once the installation program is launched, a guide will take you through setting the basic server parameters. For details about this wizard, refer to chapter 2.5  Configuration Wizard.

By default, Kerio MailServer is installed to the following directory:

C:\Program Files\Kerio\MailServer

This setting can be changed during the installation process if necessary (see below).

For better reference when solving any problems, the Kerio MailServer installation process is logged in a special file (C:\WINDOWS\kms_setup.log).

To install Kerio MailServer, follow these instructions:

  1. Double-click on the Kerio MailServer's installation file run it. This file can be downloaded at the Kerio Technologies website at http://www.kerio.com/kmsdwn/.

  2. The installer asks user to select the installation language. In the menu, select a language (English, German, Italian, Russian and Czech localizations are available so far) and confirm settings by clicking on OK.

  3. When the installation process is started, a welcome page is displayed (see figure 2.1  Installation wizard's welcome page). When the welcome page is opened, the installer scans the disk automatically to find out whether there is enough space for the installation on the target drive.

    Installation wizard's welcome page

    Figure 2.1. Installation wizard's welcome page


    To install Kerio MailServer, click Next.

  4. In the following dialog, all important changes and news since the last version of Kerio MailServer are listed.

    Read the change log and click on Next.

  5. In this dialog, license terms for the product are displayed. To continue in the installation process, select the I accept the terms in the license agreement option (see figure 2.2  Licensing Policy).

    Licensing Policy

    Figure 2.2. Licensing Policy


    Once the terms are accepted, click Next.

  6. In this dialog, select an installation type ( see figure 2.3  Installation type selection):

    Installation type selection

    Figure 2.3. Installation type selection


    • Complete — all parts and modules of Kerio MailServer including the product guide in two language versions will be installed.

      This option is recommended especially to users who are installing Kerio MailServer for the first time.

    • Custom — selection of Kerio MailServer components which will be installed as well as of a language of the Kerio MailServer's help.

  7. In this dialog, select a directory where Kerio MailServer will be installed. As shown at figure 2.4  Kerio MailServer installation path selection, by default, the mailserver is installed in

    C:\Program Files\Kerio\

    Kerio MailServer installation path selection

    Figure 2.4. Kerio MailServer installation path selection


    Select a folder where the program will be installed and click on Next.

  8. The following dialog is opened only if the Custom installation was selected. If you selected the Complete option, skip reading this section.

    In the Custom installation, it is possible to choose which Kerio MailServer components will be installed. This installation type is usually helpful if you need to spare your disk space by leaving for example the help file out of the installation or if you need to install only the Kerio Administration Console on a host from which you will perform remote administration.

    Custom installation

    Figure 2.5. Custom installation


    Components to be installed:

    • MailServer — the executive core of the program (the Kerio MailServer Engine) which provides all services and functions. It runs as a background application (as a service on Windows 2000, Windows XP or Windows Vista, or as a daemon on Unix-based systems).

      Along with the Kerio MailServer Engine, it is recommended to install the following components:

    • Administration Console — the Kerio MailServer's administration interface. It can be also installed separately and used for remote administration (more information in chapter 5  Kerio MailServer Administration).

    • Help files — If you enable both English and Czech, the help will be displayed in the language version which is set in the Kerio Administration Console. If the language in the Kerio Administration Console is changed, the language in the help is switched automatically.

  9. In the next dialog, automatic startup of Kerio MailServer upon completion of the installation can be enabled (the Start the MailServer Engine service after the installation finishes option).

    Confirmation of the installation startup

    Figure 2.6. Confirmation of the installation startup


    Click on Install. After this step, the installation continues (i.e. files are copied to a hard drive and all necessary system settings are performed).

  10. Status of the installation process is showed during the installation. Please be patient, the installation may take several minutes.

    Once the installation is completed, click Next. At this moment, the wizard is started where basic server parameters can be set (see section 2.5  Configuration Wizard). Be really attentive while setting these parameters.

  11. Once the settings in the configuration wizard are done, the final dialog of the installation wizard is opened. Click on Finish to complete the installation (see figure 2.7  Installation on Windows: Final dialog of the wizard).

    Installation on Windows: Final dialog of the wizard

    Figure 2.7. Installation on Windows: Final dialog of the wizard


    Kerio MailServer Engine, which is the mail server's core, running as a service, will be started immediately after the installation is complete. This implies that a utility called Kerio MailServer Monitor will also be run, by which you can view the Engine status, stop or start the mail server and perform other tasks. Kerio MailServer Monitor is displayed as an icon in the SysTray (see figure 2.8  Kerio MailServer Monitor on Windows).

    Kerio MailServer Monitor on Windows

    Figure 2.8. Kerio MailServer Monitor on Windows


Protection of the installed product

In order to ensure the maximum security of the mailserver, it is necessary to disallow unauthorized access to the application files (in particular to the configuration files). If the NTFS file system is used, the system resets the access rights to the directory where Kerio MailServer is installed (including all subdirectories — even if the path has changed) upon the first startup after each upgrade or installation: the read and write access is allowed only for members of the Administrators group and the local system account (SYSTEM); no one else is allowed to access the system files.

Warning: If the FAT32 file system is used, it is not possible to protect Kerio MailServer in the above way. Thus, we strongly recommend to install Kerio MailServer only on NTFS disks.

Linux

Kerio MailServer supports the following distributions of the Linux operating system:

  • Red Hat 9.0

  • Red Hat Enterprise Linux 3 / 4 / 5

  • Fedora Core 4 / 5 / 6 / 7 / 8 (on 32-bit systems)

    Requires: libstdc++.so.5 (compat-libstdc++-33 RPM package)

    Fedora Core 5 requires: compat-gcc-32-3.2.3-56.fc5 and compat-libstdc++-33-3.2.3-56.fc5.

  • SuSE Linux 10.0, 10.1, 10.2 and 10.3 (32-bit)

    Requires: libstdc++.so.5 (compat-libstdc++-33 RPM package)

Kerio MailServer is distributed in two RedHat Package Manager packages — the server and the administration console.

Note: For installations, Kerio MailServer uses the RPM application. All parameters for RPM are supported by Kerio MailServer.

The installation must be performed by a user with root rights. Kerio MailServer Engine is installed to /opt/kerio/mailserver and the Kerio Administration Console to /opt/kerio/admin.

New installation

Start installation using this command:

# rpm -i <installation_file_name>

Example:

# rpm -i kerio-kms-6.5.0-1070.linux.i386.rpm

In case of the recent versions of the distributions, problems with package dependencies might occur. If you cannot install Kerio MailServer, download and install the compat-libstdc++ package.

It is recommended to read carefully the LINUX-README file immediately upon the installation. The file can be found in

/opt/kerio/mailserver/doc

When the installation is completed successfully, run the configuration wizard to set the domain and the administrator's account: 

/opt/kerio/mailserver
./cfgwizard

Warning: The Kerio MailServer Engine must be stopped while the configuration wizard is running.

Starting and stopping the server

Once all settings are finished successfully in the configuration wizard, Kerio MailServer is ready to be started.

Within the installation, the keriomailserver script is created in the /etc/init.d directory which provides automatic startup of the daemon (i.e. MailServer Engine) upon a reboot of the operating system. This script can also be used to start or stop the daemon manually, using the following commands:

/etc/init.d/keriomailserver start

/etc/init.d/keriomailserver stop

/etc/init.d/keriomailserver restart

Note: Kerio MailServer must be running on the root account.

Administration

To run Kerio Administration Console, use the kerioadmin command in the /usr/bin directory (the path is set by default). The X Window System graphical interface is required.

Mac OS X

Since version 6.2, Kerio MailServer supports Mac OS X systems on both PowerPC and Intel processors. The Kerio MailServer's installation package is a universal binary file which can be run on both platforms.

The product supports the following systems:

  • Mac OS X 10.3.9 Panther on G4 or G5, 512 MB RAM, Mac Intel Solo or Duo, 512 MB RAM

  • Mac OS X 10.4 Tiger on G4 or G5, 512 MB RAM; Mac Intel Solo or Duo, 512 MB RAM

  • Mac OS X 10.5 Leopard on G4 or G5, 512 MB RAM; Mac Intel Solo or Duo, 512 MB RAM

Recommended: G5, 1GB RAM Mac Intel Solo or Duo, 1GB RAM

kerio-kms-6.5.0-1069.mac.dmg

  1. Double-click on the package icon to open the kerio-kms-6.5.0-1069.mac.dmg installation package.

  2. This opens the Finder where the installation package is opened as a disk and where the Kerio MailServer Installer executable is available. Click on it to run the installer (see figure 2.9  Kerio MailServer Installer).

    Kerio MailServer Installer

    Figure 2.9. Kerio MailServer Installer


  3. Kerio MailServer can be installed only by a user with administration rights for the system. To start the installation, username and password is required in a special dialog (see figure 2.10  User authentication). Enter the username and password for a user who has administration rights for the system. Only users with appropriate rights (members of the Admins group) are allowed to install applications in the system.

    User authentication

    Figure 2.10. User authentication


    Administrators can allocate any users with these rights under System Preferences → Accounts.

  4. The installation wizard is opened upon a successful authentication.

  5. At the start, license terms are displayed. Click on Continue and confirm the terms by the Agree button.

    License terms

    Figure 2.11. License terms


  6. Once license terms are accepted, a dialog is opened where an installation type can be selected:

    • Easy Install — preset installation, all components will be installed automatically by the installer.

    • Custom Install — you can select individual components that you would like to install (Kerio Administration Console, Kerio MailServer Engine and Administrator's Guide are available).

    • Uninstall — this options uninstalls Kerio MailServer.

    Select an installation type (the Easy Install option will install all available components) and click on Install.

    Installation — custom install

    Figure 2.12. Installation — custom install


  7. Now, the wizard runs the installation.

    By default, Kerio MailServer is installed under /usr/local/kerio/mailserver.

    The complete version of Kerio MailServer will be installed (Kerio Administration Console, Kerio MailServer Engine and Administrator's Guide).

  8. Once the installation is completed, the configuration wizard is opened automatically. Set the primary domain name and the admin password which will be used for login to the Kerio MailServer's administration console (see chapter 2.5  Configuration Wizard).

  9. When the configuration wizard is finished, the final dialog of the installer is displayed. Finish the installation by the Quit button.

Click OK to open the Kerio MailServer folder which includes the Administration Console executable file, the administrator's guide (Administrator's Guide) in PDF and Configuration Wizard (refer to chapter 2.5  Configuration Wizard).

Kerio MailServer folder

Figure 2.13. Kerio MailServer folder


Kerio MailServer will be run automatically after the operating system is booted. However, users must run Kerio MailServer Monitor (System Preferences → Other → KMS Monitor). Username which must belong to the Admins group and password is required for stopping or running of the service. Once authenticated, clicking Stop Kerio MailServer or Start Kerio MailServer is sufficient.

You can also stop, start or restart the MailServer through Terminal or a SSH client with the following commands with root access:

Stopping the Kerio MailServer Engine

SystemStarter stop KerioMailServer

Starting the Kerio MailServer Engine

SystemStarter start KerioMailServer

Restarting the Kerio MailServer Engine

SystemStarter restart KerioMailServer

Prev Up Next
2.3  Firewall configuration Contents 2.5  Configuration Wizard