Current Document and Section   Other Documents     Documentation     Howtos   User Guide DNS and Domains Gateway Services Guide Release Notes

Howtos - Migrating mail to ClarkConnect 4.0

[edit] Overview

This howto provides information on how to migrate mailboxes to ClarkConnect 4.x or later.

[edit] Upgrading from ClarkConnect 2.x

Upgrade is not yet available.

[edit] Upgrading from ClarkConnect 3.x

• Before starting the upgrade from ClarkConnect 3.x to 4.x, disable the SMTP Mail Server. This step will prevent inbound mail from disrupting the upgrade process.

• Upgrade the ClarkConnect system

• On first boot, login to the system either from an attached keyboard/monitor or via a secure shell (SSH).

• To start the mailbox conversion run the following command: imap2cyrus --dovecot

• If you have large number of IMAP folders, the process can take a few hours.

• Restart the SMTP Mail Server.

[edit] Migrating from a Remote IMAP Server

Here are the required steps for migrating mail to ClarkConnect.

• Create the User Accounts on the ClarkConnect system. During this process, create a corresponding username/password text file on the ClarkConnect system. This file is only used for migrating mail and can be deleted once migration is complete. The username/password file has the following format:

 username1|password1
 username2|password2
 username3|password3

• Make sure the IMAP mail server is up and running!

• Run the imap2cyrus command with the following flags:
  • --host: the hostname or IP of the old mail server
  • --port: the port for the mail server (defaults to 143)
  • --file: the name of the username/password file created earlier