Howtos - Migrating mail to ClarkConnect 4.0

Overview

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

Upgrading from ClarkConnect 2.x

Upgrade is not yet available.

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.

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