2.6 Upgrade and Uninstallation
Prev | Chapter 2 Installation | Next

## 2.6 Upgrade and Uninstallation

### Windows Operating Systems

To upgrade this product (i.e. to install a newer version of the product) the Kerio Administration Console must first be closed. The other components (Kerio MailServer Engine and Kerio MailServer Monitor) will be automatically closed by Kerio MailServer installation program. The installation program will detect the directory where the older version is installed and replace appropriate files with new ones automatically. All settings and all stored messages will be available in the new version. We recommend not changing the installation directory!

When upgrading Kerio MailServer, follow the same scheme as for the first installation of Kerio MailServer (see chapter 2.4 Installation).

Once the product is upgraded successfully, a backup of the configuration files of the previous Kerio MailServer version is saved in the directory where Kerio MailServer is installed (`C:\Program Files\Kerio` by default), under the `UpgradeBackups` directory.

Kerio MailServer can be uninstalled by using Uninstall from the Start menu using the Add/Remove Programs in the Control Panels:

1. Under Add or remove programs, select Kerio MailServer and click on Remove.

2. This runs the Microsoft Installer installation wizard.

3. In the first dialog, it is possible to choose whether Kerio MailServer will be removed completely, including the data store and configuration files (see figure 2.5 Removal of the data store and configuration files):

   Figure 2.5. Removal of the data store and configuration files

   - Remove message store — check this option to remove Kerio MailServer's data store including the archiving and the backup store.

   - Remove configuration files — if this option is enabled, configuration files (`mailserver.cfg` and `users.cfg`) as well as the license file, SSL certificates, statistics and logs will be removed.

   When sure that the settings are finished, continue by clicking on the Next button.

4. Progress of the uninstallation process is showed on the status bar. Please be patient, the process may take several minutes.

### Linux Operating System — RPM

Upgrade

  To upgrade, use the following command:

  `# rpm -U <installation_file_name>`

  Example:

  `# rpm -U kerio-kms-6.7.0-1070.linux.i386.rpm`

Fix installation of the current version

  To fix the current installation, use the following command:

  `# rpm -U --force <installation_file_name>`

  Example:

  `# rpm -U --force kerio-kms-6.7.0-1070.linux.i386.rpm`

Uninstallation

  To uninstall Kerio MailServer, use the following commands:

  `# rpm -e <package_name>`

  This means:

  `# rpm -e kerio-mailserver` (for the standard version of Kerio MailServer)

  `# rpm -e kerio-mailserver-admin` (for Kerio Administration Console)

  During the uninstallation process, only the files that have been included in the former installation package and that have not been edited will be removed. Configuration, messages in the mailboxes, etc. will be retained. Such files may be deleted manually or kept for further installations.

### Note

RPM allows using additional, advanced parameters. For description of these parameters, see the RPM guidance page. To open this page, use the following command:

`man rpm`

### Linux Operating System — DEB

Upgrade

  To upgrade Kerio MailServer, follow the same steps as for a new installation (see 2.4 Installation).

Uninstallation

  To uninstall Kerio MailServer, use the following command:

  `# apt-get remove <installation_package_name>`

  This means:

  `# apt-get remove kerio-kms` (for standard Kerio MailServer)

  `# apt-get remove kerio-kms-admin` (for the Kerio Administration Console)

  or for full removal of Kerio MailServer along with all configuration files:

  `# apt-get remove --purge kerio-kms` (for standard Kerio MailServer)

  `# apt-get remove --purge kerio-kms-admin` (for the Kerio Administration Console)

### Mac OS X

Upgrade

  To upgrade this product, the Kerio Administration Console must first be closed. The other components (Kerio MailServer Engine and Kerio MailServer Monitor) will be automatically closed by Kerio MailServer installation program. The installation program will detect the directory where the older version is installed and replace appropriate files with new ones automatically. All settings and all stored messages will be available in the new version. We recommend not changing the installation directory!

Uninstallation

  Stop the Kerio Administration Console before you start an uninstallation. You can also use the Kerio MailServer's installation program to uninstall this product. Simply click on the icon of the currently installed Kerio MailServer's installation package to run the installation and select Uninstall as the installation type.

Prev | Up | Next
2.5 Configuration Wizard | Contents | Chapter 3 Product Registration and Licensing