Name

imapcp — migrate existing IMAP mailboxes to SCOoffice Mail Server

Synopsis

/opt/lsb-sco.com/msg/bin/imapcp [-f] [-v] [-s] < migration_file

Description

The imapcp utility migrates mailboxes from an existing mail server to the SCOoffice Mail 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 SCOoffice Mail Server users and that only the SCOoffice Mail Server admin user run the utility as admin.

The following options are supported:

-f

Only copies mail into mailboxes that do not already exist on the target system. Important option for use on systems where shared mailboxes may appear in multiple users name space.

-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; on systems upgrading from Volution Messaging Server 1.1 the SCOoffice Mail Server, this value will need to be set to INBOX. For freshly installed SCOoffice Mail Server systems, the value can be ""

Examples

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

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

Here is a multi-line sample entry for migrating accounts from one SCOoffice Mail 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 ""

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.

Note

When migrating from Microsoft Exchnage servers, we recommend using the -f option to migrate only mailboxes that do not exist on the new server.

Files

/opt/lsb-sco.com/msg/bin/imapcp

the imapcp Python script

/opt/lsb-sco.com/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).