Migration	<<	>>

Command-Line Options for the Migration Wizard

You can use the Migration Wizard or a combination of command-line options and a control file to perform migration. The command-line options are as follows.

Option Description

/C:<control file> Specifies the control file.

/A:<account name> The administrator account name for either a Microsoft Mail (PC) or Novell GroupWise postoffice. Not needed for migration file import, Lotus cc:Mail or Collabra Share migration.

/P:<password> The password for the administrator account on the Microsoft Mail (PC) or Lotus cc:Mail postoffice, or the password for the Novell GroupWise migration ID. Not needed for migration file import.

/S Silent mode. No error dialogs are displayed. All errors are written to the Event Log.

/? Displays Help text.

Option	Description
/C:<control file>	Specifies the control file.
/A:<account name>	The administrator account name for either a Microsoft Mail (PC) or Novell GroupWise postoffice. Not needed for migration file import, Lotus cc:Mail or Collabra Share migration.
/P:<password>	The password for the administrator account on the Microsoft Mail (PC) or Lotus cc:Mail postoffice, or the password for the Novell GroupWise migration ID. Not needed for migration file import.
/S	Silent mode. No error dialogs are displayed. All errors are written to the Event Log.
/?	Displays Help text.

Note If you are using the Migration Wizard in batch mode, the code page of the control file and the account file must be the Windows Default code page. Use the code page for the language you are migrating.

Example

mailmig /C:d:\migrate\po72195.txt 
mailmig /C:salespo.txt /A:admin /P:katmandu

When run in a batch mode, mailmig returns result codes depending on the success of the processing:

0=success: no errors or warnings
1=warnings, no errors
2=errors, possible warnings

The control file is a text file that has the following options:

Option Description

Mode (Required.) The mode for this migration. Valid options are FILE, MSMAILPC, CCMAIL, COLLABRA and GRPWISE. If included, it must be the first line in the control file.

Function (Optional; ignored unless Mode option is set to MSMAILPC, CCMAIL, COLLABRA, or GRPWISE.) The migration function to perform. Valid options are FULL, EXTRACT, and IMPORT. FULL means to perform a full migration (extract and import). EXTRACT means to extract a userlist file (MS Mail PC) or to extract migration files (Lotus cc:Mail, Novell GroupWise, and Collabra Share). IMPORT means to perform an MS Mail (PC) import from a userlist file. Defaults to FULL.

File (Required when Mode option is set to FILE, or Function option is set to EXTRACT or IMPORT, or the Mode option is set to CCMAIL, COLLABRA or GRPWISE.) Specify the path and file name of the packing list or userlist file, or for CCMAIL, COLLABRA or GRPWISE specify the path to the temporary directory for migration files.

Accounts (Required and only used when Mode is set to CCMAIL, GRPWISE or MSMAILPC when a userlist file is not specified by the File option.) A userlist file with a listing of accounts to be migrated. Defaults to all accounts in the postoffice. The format of the names in the accounts file must match the name format as it appears in the Migration Wizard account selection dialog box. Each name is on one line, followed by a carriage return and line feed.

Mailbox (Optional.) Whether to extract mailbox creation information and create the mailbox on Microsoft Exchange Server. If this is set to TRUE, mailboxes are created and messages are imported. If this is set to FALSE, messages are imported to existing mailboxes or mailboxes that are converted from custom recipients. Valid options are TRUE and FALSE. Defaults to TRUE.

Email (Optional; ignored unless Mode option is set to MSMAILPC, CCMAIL or GRPWISE.) Whether to extract personal e-mail messages. Valid options are TRUE and FALSE. Defaults to TRUE.

Public (Optional; ignored unless Mode option is set to MSMAILPC, CCMAIL, or COLLABRA.) Whether to extract shared folders, bulletin board or forum information. Valid options are TRUE and FALSE. Defaults to TRUE.

PAB (Optional, ignored unless Mode option is set to MSMAILPC) Whether to extract personal address book (PAB) entries and PAB distribution lists. Valid options are TRUE and FALSE. Defaults to TRUE.

Schedule (Optional; ignored unless Mode option is set to MSMAILPC or GRPWISE.) Whether to extract schedule information. Valid options are TRUE and FALSE. Defaults to TRUE.

EmailStart (Optional; ignored unless Mode option is set to MSMAILPC, CCMAIL, or GRPWISE.) The earliest (start) date for filtering which e-mail messages are moved. It is in the date/time format (YYYYMMDDHHMMSS). Defaults to Jan 01, 1601. Messages without dates are always migrated.

EmailEnd (Optional; ignored unless Mode option is set to MSMAILPC, CCMAIL or GRPWISE.) The end date for filtering which e-mail messages are moved. It is in the date/time format (YYYYMMDDHHMMSS). Messages without dates are always migrated. Defaults to the current date.

Home-Server (Required when Mailbox option is set to TRUE.) The Microsoft Exchange Server computer where information is to be migrated. Defaults to the server that was used last.

Container (Optional; ignored unless Mailbox option is set to TRUE.) The container and path on the specified home server where new mailboxes are to be migrated. The path is formatted as follows:
Recipients/cn=users/cn=accnting

where users is a subcontainer of Recipients and accnting is a subcontainer of users. Defaults to the Recipients container. The directory name is visible on the property page of the Recipients container and can be different from the display name. For example, the display name of the default Recipients container on a French Microsoft Exchange Server computer is "Destinataires," but the directory name is "Recipients."

Template (Optional; ignored unless Mailbox option is set to TRUE or mailboxes are created.) The Microsoft Exchange Server alias for the template mailbox to be used in creating new mailboxes. If the template mailbox is in a different Recipients container from the new mailbox, the template must be specified with the full distinguished name. Defaults to null. To find the distinguished name of a mailbox, you can use Directory Export and set the header line of the export file to: obj-class,common-name,obj-dist-name.

NTAccounts (Optional; ignored unless Mailbox option is set to TRUE.) Whether to create Windows NT accounts for new users and which value to use as the Windows NT account password. Valid options are RANDOM, ALIAS, and NO. RANDOM creates Windows NT accounts and generate random passwords. ALIAS creates Windows NT accounts and uses the Microsoft Exchange Server e-mail alias as the initial password. NO does not create Windows NT accounts. Defaults to NO.

NTDomain (Optional; ignored unless Mailbox option is set to TRUE.) The Windows NT domain where new Windows NT accounts are to be created. Defaults to the domain that the user running migration is logged on to.

Postoffice (Required if Mode option is set to MSMAILPC, CCMAIL, or GRPWISE.) The full path to the postoffice.

POName (Required if Mode option is set to CCMAIL.) The full name of a cc:Mail postoffice.

DefFldPerms (Optional if Public is set to TRUE.) Used to assign default access permissions to all users for migrated shared information. Valid options are None, Author, and PubEditor. Defaults to none.

FldOwner (Required if Public is set to TRUE.) Distinguished name of the account that will own the public folder.

ImportDestination (Optional; ignored unless MODE is set to MSMAILPC, CCMAIL, GRPWISE, or FILE.) Specifies the destination store for migrated data. Valid options are SERVER and PST. SERVER migrates information to the Microsoft Exchange Server information store. PST migrates information to personal folder (.PST) files and personal address books (.PAB). Default is SERVER.

PSTPath (Required when ImportDestination is set to PST.) The fully qualified path to the directory where personal folder (.PST) and personal address book (.PAB) files will be created.

GWUserGRPName (Required if MODE is set to GRPWISE.) The name of the Novell GroupWise group whose members are to be migrated.

SchdStart (Optional; ignored unless MODE is set to GRPWISE.) The earliest (start) date for filtering which calendar data is moved. It is in the date/time format (YYYYMMDDHHMMSS). Defaults to Jan 01, 1601. Information without dates is always migrated.

SchdEnd (Optional; ignored unless Mode option is set to GRPWISE.) The end date for filtering which calendar data is moved. It is in the date/time format (YYYYMMDDHHMMSS). Messages without dates are always migrated. Defaults to the current date.

Phone (Optional; ignored unless MODE option is set to GRPWISE.) Whether to migrate phone messages. Valid options are TRUE and FALSE. Defaults to TRUE.

Appointments (Optional; ignored unless MODE option is set to GRPWISE) Whether to migrate appointments. Valid options are TRUE and FALSE. Defaults to TRUE.

Notes (Optional; ignored unless MODE option is set to GRPWISE.) Whether to migrate notes. Valid options are TRUE and FALSE. Defaults to TRUE.

Tasks (Optional; ignored unless MODE option is set to GRPWISE.) Whether to migrate tasks. Valid options are TRUE and FALSE. Defaults to TRUE.

GWRTF (Optional; ignored unless MODE option is set to GRPWISE.) Indicates whether messages are migrated in Rich Text Format (RTF). If set to FALSE, messages are migrated in ANSI format. Valid options are TRUE and FALSE. Defaults to TRUE.

! (Optional.) A comment delimiter. Must be the first value in the line.

Option	Description
Mode	(Required.) The mode for this migration. Valid options are FILE, MSMAILPC, CCMAIL, COLLABRA and GRPWISE. If included, it must be the first line in the control file.
Function	(Optional; ignored unless Mode option is set to MSMAILPC, CCMAIL, COLLABRA, or GRPWISE.) The migration function to perform. Valid options are FULL, EXTRACT, and IMPORT. FULL means to perform a full migration (extract and import). EXTRACT means to extract a userlist file (MS Mail PC) or to extract migration files (Lotus cc:Mail, Novell GroupWise, and Collabra Share). IMPORT means to perform an MS Mail (PC) import from a userlist file. Defaults to FULL.
File	(Required when Mode option is set to FILE, or Function option is set to EXTRACT or IMPORT, or the Mode option is set to CCMAIL, COLLABRA or GRPWISE.) Specify the path and file name of the packing list or userlist file, or for CCMAIL, COLLABRA or GRPWISE specify the path to the temporary directory for migration files.
Accounts	(Required and only used when Mode is set to CCMAIL, GRPWISE or MSMAILPC when a userlist file is not specified by the File option.) A userlist file with a listing of accounts to be migrated. Defaults to all accounts in the postoffice. The format of the names in the accounts file must match the name format as it appears in the Migration Wizard account selection dialog box. Each name is on one line, followed by a carriage return and line feed.
Mailbox	(Optional.) Whether to extract mailbox creation information and create the mailbox on Microsoft Exchange Server. If this is set to TRUE, mailboxes are created and messages are imported. If this is set to FALSE, messages are imported to existing mailboxes or mailboxes that are converted from custom recipients. Valid options are TRUE and FALSE. Defaults to TRUE.
Email	(Optional; ignored unless Mode option is set to MSMAILPC, CCMAIL or GRPWISE.) Whether to extract personal e-mail messages. Valid options are TRUE and FALSE. Defaults to TRUE.
Public	(Optional; ignored unless Mode option is set to MSMAILPC, CCMAIL, or COLLABRA.) Whether to extract shared folders, bulletin board or forum information. Valid options are TRUE and FALSE. Defaults to TRUE.
PAB	(Optional, ignored unless Mode option is set to MSMAILPC) Whether to extract personal address book (PAB) entries and PAB distribution lists. Valid options are TRUE and FALSE. Defaults to TRUE.
Schedule	(Optional; ignored unless Mode option is set to MSMAILPC or GRPWISE.) Whether to extract schedule information. Valid options are TRUE and FALSE. Defaults to TRUE.
EmailStart	(Optional; ignored unless Mode option is set to MSMAILPC, CCMAIL, or GRPWISE.) The earliest (start) date for filtering which e-mail messages are moved. It is in the date/time format (YYYYMMDDHHMMSS). Defaults to Jan 01, 1601. Messages without dates are always migrated.
EmailEnd	(Optional; ignored unless Mode option is set to MSMAILPC, CCMAIL or GRPWISE.) The end date for filtering which e-mail messages are moved. It is in the date/time format (YYYYMMDDHHMMSS). Messages without dates are always migrated. Defaults to the current date.
Home-Server	(Required when Mailbox option is set to TRUE.) The Microsoft Exchange Server computer where information is to be migrated. Defaults to the server that was used last.
Container	(Optional; ignored unless Mailbox option is set to TRUE.) The container and path on the specified home server where new mailboxes are to be migrated. The path is formatted as follows: Recipients/cn=users/cn=accnting where users is a subcontainer of Recipients and accnting is a subcontainer of users. Defaults to the Recipients container. The directory name is visible on the property page of the Recipients container and can be different from the display name. For example, the display name of the default Recipients container on a French Microsoft Exchange Server computer is "Destinataires," but the directory name is "Recipients."
Template	(Optional; ignored unless Mailbox option is set to TRUE or mailboxes are created.) The Microsoft Exchange Server alias for the template mailbox to be used in creating new mailboxes. If the template mailbox is in a different Recipients container from the new mailbox, the template must be specified with the full distinguished name. Defaults to null. To find the distinguished name of a mailbox, you can use Directory Export and set the header line of the export file to: obj-class,common-name,obj-dist-name.
NTAccounts	(Optional; ignored unless Mailbox option is set to TRUE.) Whether to create Windows NT accounts for new users and which value to use as the Windows NT account password. Valid options are RANDOM, ALIAS, and NO. RANDOM creates Windows NT accounts and generate random passwords. ALIAS creates Windows NT accounts and uses the Microsoft Exchange Server e-mail alias as the initial password. NO does not create Windows NT accounts. Defaults to NO.
NTDomain	(Optional; ignored unless Mailbox option is set to TRUE.) The Windows NT domain where new Windows NT accounts are to be created. Defaults to the domain that the user running migration is logged on to.
Postoffice	(Required if Mode option is set to MSMAILPC, CCMAIL, or GRPWISE.) The full path to the postoffice.
POName	(Required if Mode option is set to CCMAIL.) The full name of a cc:Mail postoffice.
DefFldPerms	(Optional if Public is set to TRUE.) Used to assign default access permissions to all users for migrated shared information. Valid options are None, Author, and PubEditor. Defaults to none.
FldOwner	(Required if Public is set to TRUE.) Distinguished name of the account that will own the public folder.
ImportDestination	(Optional; ignored unless MODE is set to MSMAILPC, CCMAIL, GRPWISE, or FILE.) Specifies the destination store for migrated data. Valid options are SERVER and PST. SERVER migrates information to the Microsoft Exchange Server information store. PST migrates information to personal folder (.PST) files and personal address books (.PAB). Default is SERVER.
PSTPath	(Required when ImportDestination is set to PST.) The fully qualified path to the directory where personal folder (.PST) and personal address book (.PAB) files will be created.
GWUserGRPName	(Required if MODE is set to GRPWISE.) The name of the Novell GroupWise group whose members are to be migrated.
SchdStart	(Optional; ignored unless MODE is set to GRPWISE.) The earliest (start) date for filtering which calendar data is moved. It is in the date/time format (YYYYMMDDHHMMSS). Defaults to Jan 01, 1601. Information without dates is always migrated.
SchdEnd	(Optional; ignored unless Mode option is set to GRPWISE.) The end date for filtering which calendar data is moved. It is in the date/time format (YYYYMMDDHHMMSS). Messages without dates are always migrated. Defaults to the current date.
Phone	(Optional; ignored unless MODE option is set to GRPWISE.) Whether to migrate phone messages. Valid options are TRUE and FALSE. Defaults to TRUE.
Appointments	(Optional; ignored unless MODE option is set to GRPWISE) Whether to migrate appointments. Valid options are TRUE and FALSE. Defaults to TRUE.
Notes	(Optional; ignored unless MODE option is set to GRPWISE.) Whether to migrate notes. Valid options are TRUE and FALSE. Defaults to TRUE.
Tasks	(Optional; ignored unless MODE option is set to GRPWISE.) Whether to migrate tasks. Valid options are TRUE and FALSE. Defaults to TRUE.
GWRTF	(Optional; ignored unless MODE option is set to GRPWISE.) Indicates whether messages are migrated in Rich Text Format (RTF). If set to FALSE, messages are migrated in ANSI format. Valid options are TRUE and FALSE. Defaults to TRUE.
!	(Optional.) A comment delimiter. Must be the first value in the line.

Examples

Importing migration files created by a source extractor:
   ! This is a control file for 'File' Migrations (ie. Import)
   Mode,File
   File,C:\MIGRATE\CCPO1225.PKL
   Home-Server,HONGKONG01
   Public,TRUE
   DefFldPerms,none
   FldOwner,/o=FAB/ou=AP/cn=Recipients/cn=Administrator
   Container,none
   Template,/o=FAB/ou=AP/cn=Recipients/cn=TemplateMailbox
   NTAccounts,RANDOM
   NTDomain,FAB-MAIN


Microsoft Mail (PC) Extracting a user list:
   ! This is a control file for 'MS Mail' Migrations
   Mode,MSMAILPC
   File,C:\MIGRATE\USERLIST.CSV
   Function,Extract
   Email,FALSE
   PUBLIC,FALSE
   PAB,FALSE
   Schedule,FALSE
   Postoffice,M:\


Microsoft Mail (PC) Importing with a userlist, the template mailbox is in a different recipient container:
   ! This is a control file for 'MS Mail' Migrations
   Mode,MSMAILPC
   ImportDestination,SERVER
   File,C:\MIGRATE\USERLIST.CSV
   Function,IMPORT
   PUBLIC,FALSE
   Postoffice,M:\
   EmailStart,19950101000000
   EmailEnd,19950102000000
   Home-Server,HONGKONG01
   Template,/o=FAB/ou=AP/cn=Recipients /cn=Template/cn=zTemplateMailbox
   NTAccounts,RANDOM
   NTDomain,FAB-MAIN


Microsoft Mail (PC) One step migration:
   ! This is a control file for 'MS Mail' Migrations
   Mode,MSMAILPC
   ImportDestination,SERVER
   Postoffice,\\HONGKONGPO\MAILDATA\
   EmailStart,19950101000000
   EmailEnd,19950102000000
   Home-Server,HONGKONG01
   Template,/o=FAB/ou=AP/cn=Recipients/cn=TemplateMailbox
   NTAccounts,RANDOM
   NTDomain,FAB-MAIN


Lotus cc:Mail Extracting to migration files:
   ! This is a control file for 'cc:Mail' Migrations
   Mode,CCMAIL
   File,C:\MIGRATE\
   Function,EXTRACT	
   Public,FALSE
Postoffice,M:\
   POName,Region1PO


Lotus:cc:Mail Importing migration files
   ! This is a control file for 'cc:Mail' Migrations
   Mode,FILE
   File,C:\MIGRATE\CCPO1225.PKL
   Home-Server,HONGKONG01
   Template,/o=FAB/ou=AP/cn=Recipients/cn=TemplateMailbox
   NTAccounts,RANDOM
   NTDomain,FAB-MAIN


Lotus cc:Mail One step migration
   ! This is a control file for 'cc:Mail' Migrations
   Mode,CCMAIL
   File,C:\MIGRATE\
   Function,FULL
   Public,FALSE
   Postoffice,M:\
   POName,Region1PO
   Home-Server,HONGKONG01
   Template,/o=FAB/ou=AP/cn=Recipients/cn=TemplateMailbox
   NTAccounts,RANDOM
   NTDomain,FAB-MAIN


Novell GroupWise One step migration
   ! This is a control file for 'GroupWise' Migrations
   Mode,GrpWise
   Function,FULL
   PostOffice,M:\
   File,C:\MIGRATE
   Home-Server,HONGKONG01
   Container,/o=FAB/ou=AP/cn=Recipients
   Template,/o=FAB/ou=AP/cn=Recipients/cn=TemplateMailbox
   NTAccounts,alias
   NTDomain,FAB-MAIN
   Accounts,C:\MIGRATE\HK_HQ\MIGUSERS.TXT
   GWRTF,TRUE 


Collabra Share One step migration
   ! This is a control file for 'Collabra' Migrations
   Mode,Collabra
   Function,FULL
   PostOffice,\\CORP_1\SHARED
   File,C:\MIGRATE
   DefFldPerms,none
   FldOwner,/o=FAB/ou=AP/cn=Recipients/cn=FolderAdmin
   Home-Server,BALMAIN