Batch-archiving IMAP Mailboxes

Revision as of 21:59, 29 April 2012 by Vivian (talk | contribs)

This chapter describes how multiple IMAP mailboxes can be archived in one step.

Important: This article describes the general procedure independent from the e-mail server used. Please find e-mail server specific information in our Implementation Guides.

Multiple IMAP Mailboxes (Master Password)

MailStore supports archiving multiple IMAP mailboxes by means of a privileged user and the procedure to log in to an IMAP server as specified in RFC 4616 - The PLAIN SASL Mechanism. In addition to the privileged user's user name and password, the primary email address (as mailbox name) of the user whose emails are to be archived is passed on in the process as well.

You can learn from your email server's manufacturer if your email server supports this type of login and what the prerequisites are.

Setting up the Archiving Process

Archiving processes for IMAP or POP3 mailboxes are set up 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.
  • From the list of email servers under Create Profile, select Other Server via IMAP/POP3.
  • A wizard opens to assist in specifying the archiving settings.
    Arch imap multi mp 01.png
    Hint: The Online Help gives you direct access to the respective Implementation Guides.
  • Select Multiple IMAP Mailboxes (Master Password) and click on OK.
    Arch imap multi mp 02.png
  • Fill out the fields Server Name and Access via and enter the login data of the privileged user under User Name and Password.
    Only with IMAP-TLS and IMAP-SSL: If you are using an unofficial certificate on the email server, select the option to Ignore SSL Security Warnings .
  • In the Sent Items field you can enter the name of the folder containing sent emails.
  • Click on Next.
    Arch imap multi mp 03.png
  • If needed, customize the list of folders to be archived, the deletion rules, the filters, the timeout value in seconds and the maximum number of archiving jobs to be executed simultaneously. The timeout value only has to be adjusted if needed (e.g. when using a very slow server).
  • Click on Next.
    Arch imap multi mp 04.png
  • Now you can choose the users whose mailboxes are to be archived. The following options are available:
    All users with a configured email address
    Choose this option to archive the mailboxes of all users who are set up in MailStore's user management along with an email address.
    All users except the following
    With this feature, individual users (and their Exchange mailboxes) can be excluded from the archiving process using the list of users below.
    The following users only
    With this feature, individual users (and their Exchange mailboxes) can be included in the archiving process using the list of users below.

Only the mailboxes of users explicitly specified are archived.

  • Synchronize with directory services before archiving
    If this option is activated, the list of MailStore users is synchronized with the configured directory service before each archiving process. This has the advantage that a new coworker, for example, is set up as MailStore user automatically so that MailStore archives his or her mailbox automatically as well. This option is especially recommended if mailboxes are archived regularly according to a schedule.
  • Finally, you can choose a name for the archiving profile. When you click on Finish, the archiving profile is listed under Saved Profiles and can be executed, if desired.

Multiple IMAP Mailboxes (CSV File)

Archiving multiple IMAP mailboxes based on a CSV file is described below. Use this procedure if your IMAP server does not support any of the authentication methods described under Multiple IMAP Mailboxes (Master Password)

Preparation: Creating a CSV File

In order to set up batch archiving of multiple IMAP mailboxes, first, a CSV file needs to be created. For this, a Microsoft Excel spreadsheet can be used, for example:

Arch impbatch 01.png

Set up the columns as shown above. Please keep in mind that the headings (e.g."IMAP user name") must be in place but their notation may differ. Beneath the headings, enter a row for each mailbox to be archived:

IMAP user name and IMAP password
These entries are mandatory for MailStore to be able to access the mailbox.

Email address (optional)
If entered, MailStore will label the folder for the respective mailbox in the tree structure of the archive with the email address specified.

MailStore user name (optional)
If entered, MailStore will archive the respective mailbox for each MailStore user specified (store the emails in the appropriate user archive). If the user does not yet exist, a user will be created automatically. If this field is left blank, a new MailStore user is created automatically and labeled with the IMAP user name specified.

This way, any number of mailboxes of an email server may be entered. When finished, save the file in .csv format (if Microsoft Excel is used via the Save As function).

Setting Up the Archiving Process

Setting up archiving processes for IMAP or POP3 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 Other Server via IMAP/POP3 from the Email Servers list in Create Profile area of the application window.
  • A wizard opens guiding you through the setup process.
    Arch imap multi 01.png
  • Select Multiple Mailboxes and click on OK.
  • Fill out the fields Host and Access via, and under CSV File enter the path of the new CSV file (created as described above). This file contains the access information for the mailboxes to be archived. Under Special Folder (optional) you may enter the name of the IMAP folder containing sent messages.
    For the IMAP-TLS and IMAP-SSL protocols only: You have the option to ignore SSL security warnings. Generally, these warnings appear if an unofficial certificate is used on the server.
    Arch imap multi 02.png
  • Click on Next.
  • If needed, adjust the list of folders to be archived, the deletion rules, the filter and the timeout value in seconds. The timeout value only has to be adjusted in specific cases (e.g. with very slow servers).
    Arch imap multi 03.png
  • Click on Next.
  • 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 Settings (Profiles) and can be run immediately, if desired.

Includes:Starting the Archiving Process