PMDF User's Guide
UNIX Edition


Previous Contents Index


migrate

Copy folders of messages from one system running an IMAP server to another system running an IMAP server.

Syntax

migrate -fromhost source-IMAP-host -fromuser source-username -frompass source-password -tohost destination-IMAP-host -touser destination-username -topass destination-password [-fromprefix source-folder-prefix] [-toprefix destination-folder-prefix]

Qualifiers Defaults
-batch Move in batch mode without prompting; see text
-debug n Specify level of debugging
-fromport port Specify a non-default port number
-fromprefix folder-prefix See text
-h Print help message
-log file-spec Log operations to specified file
-lower Destination folder names will be lowercased
-maxerr n Maximum number of errors to allow before aborting
-noskip Do not skip INBOX and WASTEBASKET on source host
-toport port Specify a non-default port number
-toprefix folder-prefix See text

prompts

Enter TCP/IP name of host to move from: source-IMAP-host
Enter TCP/IP name of host to move to: destination-IMAP-host
{source-IMAP-host} username: source-username
{source-IMAP-host} password for username: source-password
{destination-IMAP-host} username: destination-username
{destination-IMAP-host} password for username: destination-password
Move n messages in source-folder to which folder: destination-folder

Parameters

source-IMAP-host

The fully qualified TCP/IP name of the system from which to copy messages. The system must be running an IMAP server.

source-username

The username of the account on the source system.

source-password

The password of the account on the source system.

destination-IMAP-host

The fully qualified TCP/IP name of the system to which to copy messages. The system must be running an IMAP server.

destination-username

The username of the account on the destination system.

destination-password

The password of the account on the destination system.

source-folder-prefix

A string specifying what folders to copy from.

destination-folder-prefix

A string specifying what folders to copy to.

Description

migrate is a utility for copying folders of messages from one system to another. Each system must have an IMAP server running.

You can run migrate interactively or in batch mode. To run it interactively, you will be prompted for the names of the systems to move from and to, as well as the usernames and passwords. If all the required arguments are specified, then migrate will run in automatic or batch mode, moving all messages from all folders to the destination system, using the same name for destination folders. With the optional -batch qualifier, you can skip the interactive confirmation prompt before each folder is copied. With the -fromprefix qualifier, you can specify a folder prefix for the source system; with the -toprefix qualifier, you can specify a folder prefix for the destination system. And with the -lower qualifier you can specify that the destination folder names should be lowercased. Assuming that the source system is VMS, the folders INBOX and WASTEBASKET are skipped, unless you override with the -noskip qualifier.


Qualifiers

-batch

Do not prompt for confirmation of what folders to move.

-debug n

This qualifier enables debug output. n is a bit-encoded integer, with bits:
1 prints out progress/delay/login/logout messages
2 prints certain responses received, but not full message text
4 prints responses received, including full message text
8 prints commands sent

-fromport port

Specify the IMAP port on the source system. The default is -fromport 143, the standard IMAP port.

-fromprefix folder-prefix

Specify the folder prefix for the source mailbox, if not the default mail file. For instance, if migrating from a PMDF IMAP server on OpenVMS system, the folder prefix would typically have the form #disk:[dir]mailfile.mai# or if migrating from an IMAP server on a UNIX system, the folder prefix would be a UNIX file specification (the UNIX default typically being mail/).

-h

Print help text.

-log file-spec

Specify a file in which to log operations.

-lower

Lowercase the folder names for the destination system.

-maxerr n

Specify the maximum number of errors that may be encountered before aborting. The default, if this qualifier is not specified, is to continue after all errors.

-noskip

By default, the INBOX folder and the WASTEBASKET folder are skipped when copying folders; the -noskip qualifier instructs PMDF to copy those folders as well.

-toport port

Specify the IMAP port on the destination system. The default is -toport 143, the standard IMAP port.

-toprefix folder-prefix

Specify the folder prefix for the destination mailbox, if not the default mail file. For instance, if migrating to a PMDF IMAP server on OpenVMS system, the folder prefix would typically have the form #disk:[dir]mailfile.mai# or if migrating to an IMAP server on a UNIX system, the folder prefix would be a UNIX file specification (the UNIX default typically being mail/).

EXAMPLES


% /pmdf/bin/migrate
From which host: admin.example.com 
Username on admin.example.com: alonso 
Password for alonso on admin.example.com:
To which host: hq.example.com 
Username on hq.example.com: alonso 
Password for alonso on hq.example.com:
Move 15 messages in sentmail to which folder (CR to skip): SENTMAIL 
Move 4 messages in mail to which folder (CR to skip): [RETURN]
... Skipping mail
      

In this example user alonso on admin.example.com also has an account on hq.example.com with two folders, mail and sentmail, and is copying the messages in the sentmail folder on admin.example.com to the SENTMAIL folder on hq.example.com.


Previous Next Contents Index