Difference between revisions of "Archiving Emails from Kerio Connect"

[unchecked revision][checked revision]
 
(55 intermediate revisions by 5 users not shown)
Line 1: Line 1:
'''Please note:''' This tutorial only covers the specifics of archiving a Kerio Connect server (former Kerio MailServer). It is assumed that you already have a MailStore Server installation or [http://www.mailstore.com/en/lp/sendlicense.aspx test installation] and are familiar with the fundamentals of MailStore Server. Please refer to the [[Manual]] or [http://www.mailstore.com/en/doc/server4-quickstart-en.pdf Quick-Start-Guide].
+
{{Implementation_Guide_Preamble|Kerio Connect Server}}
  
MailStore Server offers several ways to archive emails from a Kerio Connect server, which are described below. If you are not sure which archiving method best suits your company, please refer to chapter [[Choosing the right archiving strategy]].
+
== Synchronizing Users ==
 +
MailStore Server offers special support for synchronizing users with an Kerio Connect server. Information about setup is available in chapter [[Kerio Connect Integration]] of the manual.
  
 
== Archiving Individual Mailboxes ==
 
== Archiving Individual Mailboxes ==
 +
{{Archiving Single Mailbox Preamble|Kerio Connect Server}}
 +
{{Archiving Single Mailbox|Kerio Connect|Kerio_mailbox_00.png|Kerio_mailbox_01.png|Kerio_mailbox_02.png|Kerio_mailbox_03.png}}
  
When archiving individual mailboxes, Kerio Connect functions the same as any other email server. Please refer to the corresponding chapter ''Archiving Server Mailboxes'' in the MailStore Server manual.
+
'''Hint:''' If MailStore Server is configured to automatically delete successfully archived emails from the mailboxes and you do not want these emails moved to the "Deleted Items" folder by Kerio Connect, follow the instructions under [[Archiving_Emails_from_Kerio_Connect#Step_2:_Permanently_Deleting_Successfully_Archived_Emails|Permanently Deleting Successfully Archived Emails]] in the [[Archiving_Emails_from_Kerio_Connect#Archiving_Incoming_and_Outgoing_Emails_Directly|Archiving Incoming and Outgoing Emails Directly]] section of this document.
  
 
== Archiving Multiple Mailboxes in One Step ==
 
== Archiving Multiple Mailboxes in One Step ==
 +
Kerio Connect allows to access the mailboxes of other users via IMAP by using a master password.
  
When archiving multiple mailboxes, Kerio Connect functions the same as any other email server. Please refer to the corresponding chapter [http://www.mailstore.com/en/e-mail-archiving/batch-archiving-imap-mailboxes-from-csv-file.aspx Batch Archiving of IMAP Mailboxes] in the MailStore manual.
+
=== Step 1: Defining a Master Password ===
 +
* Log on to Kerio Connect Administration with an administrative user.
 +
* Click on ''Configuration'' > ''Advanced Options'' and open the ''Master Authentication'' tab.
 +
*:[[File:Kerio_masterauth_00.png|center|550px]]
 +
* Set the ''Enable master authentication on this server'' option.
 +
* Adjust the ''Allow master authentication only from IP address group'' to your needs.
 +
* Enter a complex password in the field ''Master password'' and confirm the password by entering it again in the ''Confirm password'' field.
 +
* Click on ''Apply'' to save changes.
  
 +
=== Step 2: Configuration of MailStore Server ===
 +
* Log on to MailStore Client as MailStore administrator.
 +
* Click on ''Archive Email''.
 +
* From the list ''E-Mail-Server'' under ''Create Profile'' select ''Kerio Connect'' to create a new archiving profile.
 +
* A wizard opens to help specify the archiving settings.
 +
*:[[File:Keio_mailboxes_00.png|center|350px]]
 +
* Select ''Multiple Mailboxes''.
 +
*: {{Archiving_Multiple_or_Multidrop_Note|multiple mailboxes|[[#Synchronizing_Users|directory synchronization]]}}
 +
*:[[File:Kerio_mailboxes_01.png|center|350px]]
 +
* Under ''Server Name'' enter the name of your Kerio Connect server.
 +
* Under ''Access via'' select the protocol to be used to access the Kerio Connect server. Wherever possible, you should always choose ''IMAP-TLS'' or ''IMAP-SSL''.
 +
*: '''Please note:''' {{Option_Accept_all_certificates}}
 +
* Under ''Password'' enter the master password defined in step one.
 +
* Click on ''Next'' to continue.
 +
*:[[File:Kerio_mailboxes_02.png|center|350px]]
 +
* Customize the [[Email_Archiving_with_MailStore_Basics#Selecting_Folders_for_Archiving|list of folders to be archived]], the filter and the [[Email_Archiving_with_MailStore_Basics#Deleting_Emails_after_Archiving|deletion rules]] as needed. By default, no emails will be deleted from the mailbox. The timeout value only has to be adjusted if necessary (e.g. with very slow servers). Please keep in mind that these settings apply to all mailboxes to be archived.
 +
* Click on ''Next'' to continue.
 +
{{Archiving_Multiple_Mailboxes_Centrally_Options|Kerio_mailboxes_03.png|Kerio}}
  
= Archiving Incoming and Outgoing Emails Directly =
+
<p class="msnote">'''Hint:''' If MailStore Server is configured to automatically delete successfully archived emails from the mailboxes and you do not want these emails moved to the "Deleted Items" folder by Kerio Connect, follow the instructions under [[Archiving_Emails_from_Kerio_Connect#Step_2:_Permanently_Deleting_Successfully_Archived_Emails|Permanently Deleting Successfully Archived Emails]] in the [[Archiving_Emails_from_Kerio_Connect#Archiving_Incoming_and_Outgoing_Emails_Directly|Archiving Incoming and Outgoing Emails Directly]] section of this document.</p>
Kerio offers an easy way to send copies of all incomming and outgoing emails to a dedicated archiving mailbox. This mailbox can be used as an archiving source for MailStore's "IMAP Multidrop" archiving profile.
 
  
== Step 1: Set up archiving ==
+
== Archiving Incoming and Outgoing Emails Directly ==
 +
The Kerio Connect server offers an easy way to deliver all emails to a Kerio Connect specific archiving mailbox. MailStore Server archives this mailbox by means of an archiving task of type [[Archiving IMAP and POP3 Multidrop Mailboxes]].
  
* Go to '''Configuration | Archiving and Backup'''
+
=== Step 1: Setting up a Kerio Connect Archiving Mailbox ===
* Open the tab '''Archiving'''
+
* Click on ''Accounts'' and then on ''Users''.
* Activate ''Enable mail archiving'' by selecting the appropriate option
+
* Click on ''Add...'' and create a new mailbox that is used for archiving.
* Enable the "Archive to remote email address" function and enter the email address of the archiving mailbox, e.g. <tt>mailstore@mydomain.tld</tt>
+
* Click on ''Configuration'' and then on ''Archiving and Backup''.
* Enable all four options in the archiving section (Local messages, Incoming messages, Outgoing messages, Relayed messages)
+
* Open the ''Archiving'' tab.
 +
*:[[File:Kerio_multidrop_01.png|center|550px]]
 +
* Select the checkbox ''Enable email archiving''.
 +
* Select the checkbox ''Archive to the remote email address'' and enter the email address of the archive mailbox (e.g. ''journal@mydomain.tld'') that has been created previously into the text field.  Please note, that this email address must not be assigned to any MailStore user.
 +
* Select all four options under ''Archive'':
 +
** ''Local messages''
 +
** ''Incoming messages ''
 +
** ''Outgoing messages''
 +
** ''Relayed messages''
  
:[[File:kerio_en_1.png|center|550px]]
+
=== Step 2: Permanently Deleting Successfully Archived Emails ===
 +
By default, Kerio Connect moves emails marked as deleted via IMAP to the ''Deleted Items'' folder. As a result, the next time that the same mailbox is archived, MailStore will detect this move of messages in the mailbox, and then move those messages to the ''Deleted Items'' folder in the archive as well. The previously existing folder structure in the archive is lost.
  
== Step 2: Deleting successfully archived emails ==
+
This behavior may be undesirable.
  
By default Kerio's IMAP server moves all emails marked as deleted into the sub folder "Deletes Objects". This means, that all emails successfully archived and marked for deletion by MailStore Server will also be moved into the "Deletes Objects" subfolder. To prevent this behavior and really purge all succesfully archived mails from the archiving mailbox, follow these few steps:
+
There are two options to prevent this behavior. First, the ''Deleted Items'' folder could be completely excluded from archiving. Then MailStore will no longer detect moving messages to this folder and will be unable to move the messages in the archive. As a result, however, messages that were not visible in folders other than ''Deleted Items'' during archiving that was previously in progress are no longer archived at all.
  
* open your webbrowser and navigate to the webmail client of your Kerio server
+
Second, the behavior of the Kerio Connect Server can be customized. The Kerio Connect Server can be configured so that messages marked as deleted are no longer moved to the ''Deleted Items'' folder, but only marked as deleted as intended by the IMAP standard.
* log on to the user of the archive mailbox
 
* open the settings section
 
* choose the general tab
 
* enable the option "Delete messages permanently (don't move them to the Deleted Items folder)"
 
  
:[[File:kerio_en_2.png|center|550px]]
+
To enforce the IMAP default behavior, you must modify the ''mailserver.cfg'' file as described below. The changes affect all IMAP clients:
  
= Weblinks =
+
* Stop the Kerio Connect Service
 +
* Navigate to the install directory and locate the ''mailserver.cfg'' file
 +
* Open the file in a text editor and search for the string ''AutoExpungeOnDelete''
 +
* Change the value from ''1'' to ''0''
 +
* Once Kerio Connect is completely stopped, save your changes to the file
 +
* Start the Kerio Connect Service
  
 +
=== Step 3: Configuration of MailStore Server ===
 +
{{Archiving Multidrop_Mailbox|Kerio Connect|Kerio_catchall_00.png|Kerio_catchall_01.png|[[#Synchronizing_Users|directory synchronization]]}}
 +
 +
== Weblinks ==
 +
* {{MailStore Support}}
 
* [http://www.kerio.com Kerio Homepage]
 
* [http://www.kerio.com Kerio Homepage]
* [[Wikipedia:en:Kerio Connect|Wikipedia: Kerio Connect]]
 
  
 
[[de:E-Mail-Archivierung von Kerio Connect]]
 
[[de:E-Mail-Archivierung von Kerio Connect]]
 +
[[en:Archiving Emails from Kerio Connect]]

Latest revision as of 16:17, 7 December 2020

This implementation guide covers the specifics of archiving Kerio Connect Server mailboxes. It is assumed that you already have a MailStore Server installation or test installation and are familiar with the fundamentals of MailStore Server. Please refer to the Manual or the Quick Start Guide for more information.

MailStore Server offers several ways to archive emails from Kerio Connect Server mailboxes, which are described below. If you are not sure which archiving method best suits your company, please refer to the chapter Choosing the Right Archiving Strategy.


Synchronizing Users

MailStore Server offers special support for synchronizing users with an Kerio Connect server. Information about setup is available in chapter Kerio Connect Integration of the manual.

Archiving Individual Mailboxes

In MailStore Server Kerio Connect Server archiving tasks are stored in archiving profiles. By following the procedure described here you can archive a single Kerio Connect Server mailbox for a specific MailStore user. The archiving process can be executed manually or automatically. You can find further information about executing archiving profiles in chapter Email Archiving with MailStore Basics.

  • Users can only archive their own mailboxes to their personal user archive. To archive the emails of other users, you have to be logged on to MailStore Client as MailStore administrator. Only MailStore administrators can archive the emails of other users.
  • In MailStore, click on Archive Email.
  • To create a new archiving profile, select Kerio Connect from the Email Servers list in the Create Profile area of the application window.
  • A wizard opens guiding you through the setup process.
    Kerio mailbox 00.png
  • Select Single Mailbox and click on OK.
  • Fill out the fields Email Address, Host, Access via, User Name and Password. The Email Address is used to label the folder that is created in the archive by this profile. Click on Test to verify the data entered.
    For the IMAP-TLS and IMAP-SSL protocols only: If the certificate provided by the remote host cannot be verified (e.g. self-signed or signed by an unknown certificate authority), enable the option Accept all certificates to allow MailStore to establish a connection. As this option leads to an insecure configuration, warnings may appear in the summary and/or the dashboard.
    Kerio mailbox 01.png
  • Click on Next.
  • Customize the list of folders to be archived, the filter and the deletion rules. By default, no emails will be deleted from a mailbox. The timeout value only has to be adjusted as needed (e.g. with very slow servers).
    Kerio mailbox 02.png
  • Click on Next.
  • If logged on to MailStore Server as administrator, the target archive can be specified at the next step. Select the archive of the user for whom the mailbox is to be archived.
    Kerio mailbox 03.png
  • At the last step, a name for the new archiving profile can be specified. After clicking on Finish, the archiving profile will be listed under Saved Profiles and can be run immediately, if desired.


Hint: If MailStore Server is configured to automatically delete successfully archived emails from the mailboxes and you do not want these emails moved to the "Deleted Items" folder by Kerio Connect, follow the instructions under Permanently Deleting Successfully Archived Emails in the Archiving Incoming and Outgoing Emails Directly section of this document.

Archiving Multiple Mailboxes in One Step

Kerio Connect allows to access the mailboxes of other users via IMAP by using a master password.

Step 1: Defining a Master Password

  • Log on to Kerio Connect Administration with an administrative user.
  • Click on Configuration > Advanced Options and open the Master Authentication tab.
    Kerio masterauth 00.png
  • Set the Enable master authentication on this server option.
  • Adjust the Allow master authentication only from IP address group to your needs.
  • Enter a complex password in the field Master password and confirm the password by entering it again in the Confirm password field.
  • Click on Apply to save changes.

Step 2: Configuration of MailStore Server

  • Log on to MailStore Client as MailStore administrator.
  • Click on Archive Email.
  • From the list E-Mail-Server under Create Profile select Kerio Connect to create a new archiving profile.
  • A wizard opens to help specify the archiving settings.
    Keio mailboxes 00.png
  • Select Multiple Mailboxes.
    Please note: To be able to archive multiple mailboxes, MailStore Server users along with their email addresses must exist in the MailStore Server user management. If this is not the case, MailStore Server will offer to set up and run the directory synchronization at this point. Once completed, the wizard will resume.
    Alternatively, you can cancel the wizard and create users manually as described the in chapter User Management.
    Kerio mailboxes 01.png
  • Under Server Name enter the name of your Kerio Connect server.
  • Under Access via select the protocol to be used to access the Kerio Connect server. Wherever possible, you should always choose IMAP-TLS or IMAP-SSL.
    Please note: If the certificate provided by the remote host cannot be verified (e.g. self-signed or signed by an unknown certificate authority), enable the option Accept all certificates to allow MailStore to establish a connection. As this option leads to an insecure configuration, warnings may appear in the summary and/or the dashboard.
  • Under Password enter the master password defined in step one.
  • Click on Next to continue.
    Kerio mailboxes 02.png
  • Customize the list of folders to be archived, the filter and the deletion rules as needed. By default, no emails will be deleted from the mailbox. The timeout value only has to be adjusted if necessary (e.g. with very slow servers). Please keep in mind that these settings apply to all mailboxes to be archived.
  • Click on Next to continue.
  • Select the users whose mailboxes are to be archived.
    Kerio mailboxes 03.png
    The following options are available:
    • All users with configured email address
      Choose this option to archive the mailboxes of all users who are set up, along with their email addresses, in MailStore's user management.
    • All users except the following
      Choose this option to exclude individual users (and thereby their Kerio mailboxes) from the archiving process, using the list of users below.
    • Only the following users
      Choose this option to include individual users (and thereby their Kerio mailboxes) in the archiving process, using the list of users below. Only the mailboxes of those users explicitly specified will be archived.
    • Synchronize with Directory Services before archiving
      If selected, the MailStore user list will be synchronized with the configured directory service before any archiving process is executed. This has the advantage that, for example, new employees will be created as MailStore users before archiving, so once the archiving process is executed, their Kerio mailbox is archived automatically as well. This option is especially recommended when the archiving process is to be executed automatically.
  • Click on Next.
  • In the last step, a name for the archiving profile can be specified. After clicking Finish, the archiving profile will be listed under Saved Profiles and can be run immediately or automatically, if desired.


Hint: If MailStore Server is configured to automatically delete successfully archived emails from the mailboxes and you do not want these emails moved to the "Deleted Items" folder by Kerio Connect, follow the instructions under Permanently Deleting Successfully Archived Emails in the Archiving Incoming and Outgoing Emails Directly section of this document.

Archiving Incoming and Outgoing Emails Directly

The Kerio Connect server offers an easy way to deliver all emails to a Kerio Connect specific archiving mailbox. MailStore Server archives this mailbox by means of an archiving task of type Archiving IMAP and POP3 Multidrop Mailboxes.

Step 1: Setting up a Kerio Connect Archiving Mailbox

  • Click on Accounts and then on Users.
  • Click on Add... and create a new mailbox that is used for archiving.
  • Click on Configuration and then on Archiving and Backup.
  • Open the Archiving tab.
    Kerio multidrop 01.png
  • Select the checkbox Enable email archiving.
  • Select the checkbox Archive to the remote email address and enter the email address of the archive mailbox (e.g. [email protected]) that has been created previously into the text field. Please note, that this email address must not be assigned to any MailStore user.
  • Select all four options under Archive:
    • Local messages
    • Incoming messages
    • Outgoing messages
    • Relayed messages

Step 2: Permanently Deleting Successfully Archived Emails

By default, Kerio Connect moves emails marked as deleted via IMAP to the Deleted Items folder. As a result, the next time that the same mailbox is archived, MailStore will detect this move of messages in the mailbox, and then move those messages to the Deleted Items folder in the archive as well. The previously existing folder structure in the archive is lost.

This behavior may be undesirable.

There are two options to prevent this behavior. First, the Deleted Items folder could be completely excluded from archiving. Then MailStore will no longer detect moving messages to this folder and will be unable to move the messages in the archive. As a result, however, messages that were not visible in folders other than Deleted Items during archiving that was previously in progress are no longer archived at all.

Second, the behavior of the Kerio Connect Server can be customized. The Kerio Connect Server can be configured so that messages marked as deleted are no longer moved to the Deleted Items folder, but only marked as deleted as intended by the IMAP standard.

To enforce the IMAP default behavior, you must modify the mailserver.cfg file as described below. The changes affect all IMAP clients:

  • Stop the Kerio Connect Service
  • Navigate to the install directory and locate the mailserver.cfg file
  • Open the file in a text editor and search for the string AutoExpungeOnDelete
  • Change the value from 1 to 0
  • Once Kerio Connect is completely stopped, save your changes to the file
  • Start the Kerio Connect Service

Step 3: Configuration of MailStore Server

Setting up archiving processes for multidrop mailboxes is done using archiving profiles. General information about archiving profiles is available in chapter Working with Archiving Profiles.

Please proceed as follows:

  • Log on as MailStore administrator using MailStore Client.
  • In MailStore, click on Archive Email.
  • To create a new archiving profile, select Kerio Connect from the Email Server list in the Create Profile area of the application window.
  • A wizard opens guiding you through the setup process.
    Kerio catchall 00.png
  • Select Multidrop Mailbox and click OK.
    Please note: To be able to archive a multidrop mailbox, MailStore Server users along with their email addresses must exist in the MailStore Server user management. If this is not the case, MailStore Server will offer to set up and run the directory synchronization at this point. Once completed, the wizard will resume.
    Alternatively, you can cancel the wizard and create users manually as described the in chapter User Management.
  • Fill out the fields Access via, Host, Username and Password. Click on Test to verify the data entered.

    For the TLS and SSL protocols only: If the certificate provided by the remote host cannot be verified (e.g. self-signed or signed by an unknown certificate authority), enable the option Accept all certificates to allow MailStore to establish a connection. As this option leads to an insecure configuration, warnings may appear in the summary and/or the dashboard.
    Kerio catchall 01.png
  • Adjust any further settings such as how to handle emails with unknown addresses or asking MailStore to delete emails after they have been archived. The latter option is especially sensible when dealing with mailboxes that are exclusively used for archiving.
  • The placeholders {u-email} or {h-email} can be used under Target Folders. {u-email} represents a user's primary email address and {h-email} is the email address found in the email header. Should a user have multiple aliases, using {h-email} will result in emails sent to different aliases of a user being archived in different folders, while using {u-email} will file all emails below the primary email address.

    Notice: If you are additionally archiving messages from the users mailboxes, you have to set the target folder names here to the folder names that match the names that were created by the user mailbox archiving profiles. Otherwise, additional or similar folders could be created in the users' archives. The folder names are case-sensitive.
  • If the option Synchronize with Directory Services before archiving is enabled, the MailStore user list will be synchronized with configured directory service before the archiving process actually runs. This has the advantage that, for example, new employees will be created as MailStore users before archiving which enables MailStore to sort their emails into the correct archives.
  • Click on Next.
  • The timeout value only has to be adjusted on a case-by-case basis (e.g. with very slow servers).
  • Click on Next.
  • At the last step, select a name for the new archiving profile. After clicking on Finish, the archiving profile will be listed under Saved Profiles and can be run immediately or automatically, if desired.


Weblinks