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 upgrade to Kerio MailServer 6.7.0 from Kerio MailServer 6.6.2.

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

- Windows 2000 (SP4)

- Windows XP (SP2 or SP1)

- Windows Server (SP2 or SP1)

- Windows Server 2008

- 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 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. These settings applies to installation only. Language version of the interface used for administration of Kerio MailServer can be selected after the installation.

3. When the installation process is started, a welcome page is displayed. 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. 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. When you finish reading the news, continue by clicking on the Next button.

5. In the next page, confirm license agreement, otherwise the product installation gets stuck at this stage. Once the terms are accepted, click Next.

6. The next dialog allows selection of an installation type, as follows:

   - 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. 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.

   Figure 2.1. 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:

     - Engine Monitor — to get more information about this component, see chapter 4.1 Kerio MailServer Monitor.

     - Performance Monitor Support — to get more information about this component, see chapter 25.10 Performance Monitor (under Windows).

   - 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.

8. In the next step, select a directory where Kerio MailServer will be installed. By default, it is installed in:

   `C:\Program Files\Kerio\`

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

9. 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.

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

11. Once the settings in the configuration wizard are done, the final dialog of the installation wizard is opened. Save the installation settings by the Finish button.

    Kerio MailServer Engine, which is the mail server's core, running as a service, will be started immediately after the installation is complete.

    Figure 2.2. 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 — RPM

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

- Red Hat 9.0

- Red Hat Enterprise Linux 4 / 5

- Fedora Core 7 / 8

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

  package)

- SUSE Linux 10.0, 10.1, 10.2, 10.3 and 11.0 (only 32-bit systems)

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

- CentOS Linux 5.2 and 5.3

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

### Warning

For installations, Kerio MailServer uses the RPM application. All functions are available except the option of changing the Kerio MailServer location.

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.7.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`

  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.

### Linux — DEB

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

- Debian 5.0 (only 32-bit systems)

- Ubuntu 8.04 LTS (only 32-bit systems)

Requires: libstdc++5

Kerio MailServer is distributed in two DEB packages — one for the server and the other for the administration console.

### Warning

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

  To install either of the installation packages, double-click on its icon or use for example the following command in the terminal:

  `# dpkg -i <installation_file_name.deb>`

  Example:

  `# dpkg -i kerio-kms-6.7.0-1070.linux.i386.deb`

  It is recommended to read carefully the DEBIAN-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

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`

  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

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.4 Tiger on at least G4 or G5, 512 MB RAM; Mac Intel Solo or Duo, 512 MB RAM

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

Recommended: G5, 2GB RAM; Mac Intel Solo or Duo, 2GB RAM

`kerio-kms-6.7.0-1069.mac.dmg`

1. Double-click on the package icon to open the `kerio-kms-6.7.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.3 Kerio MailServer Installer).

   Figure 2.3. 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. 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.

   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.

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.

   Figure 2.4. 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 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