Name

imapcp — migrate existing IMAP mailboxes to Messaging Server

Synopsis

/opt/lsb-caldera.com-volution/msg/bin/imapcp [-v] [-s] < migration_file

Description

The imapcp utility migrates mailboxes from an existing mail server to the Caldera Volution Messaging Server. Migration is supported from any IMAP-compatible mail server, including Microsoft Exchange and the University of Washington (UW) IMAP server provided with most popular versions of UNIX and Linux operating systems.

Any OpenLinux system user can run the imapcp utility. However, we recommend that there not be system accounts for Messaging Server users and that only the Messaging Server admin user run the utility as admin.

The following options are supported:

-v

Verbose; displays additional information about the mailbox migration process.

-s

Migrate only mailboxes to which a user is subscribed. This is useful for some IMAP systems where the default offers the entire contents of the user's home directory via IMAP.

The migration file is created by the administrator performing the migration process. It must contain information about the users being migrated, one per line. The format of each user line is:

servera usera passworda roota serverb userb passwordb rootb

where the field names are:

servera

The name of the mail server from which you are migrating.

usera

The user name of the mail account that you are migrating.

passworda

The user's mail account password on the server from which they are migrating.

roota

The root of the IMAP directory; for Exchange servers, this value should be set to "".

serverb

The name of the mail server to which you are migrating

userb

The user name of the mail account on the new server.

passwordb

The user's new mail account password.

rootb

The root of the IMAP directory; for the Messaging Server, this value must always be set to INBOX.

Examples

Here is a migration file sample entry for migrating an account from Microsoft Exchange 5.5 to the Messaging Server:

exchange.microsoft.com bgates domination "" vmsg.caldera.com bgates CaLm INBOX

Here is a multi-line sample entry for migrating accounts from one Messaging Server to another:

vmsg.caldera.com ransom lOVe INBOX vmsg.caldera.uk ransom lOVe INBOX
vmsg.caldera.com romney gOLd INBOX vmsg.caldera.uk romney gOLd INBOX

Note

When migrating from legacy UNIX or Linux servers using the University of Washington IMAP server, we recommend using the -s option to migrate only subscribed mailboxes.

Files

/opt/lsb-caldera.com-volution/msg/bin/imapcp

the imapcp Python script

/opt/lsb-caldera.com-volution/msg/bin/ imapcplib.py

the imapcp library

See also

ldap(3), ldif(5), Cyrus documentation

Acknowledgements

This software is based on imapcp software created by Jean-Philippe Langlois. imapcp software is released under the GNU GPL; see the license file for details. Copyright© 2001 by Jean-Philippe Langlois (jpl@iname.com).