Export (0) Print
Expand All

Batch File and Command Line Migrations

 

Topic Last Modified: 2006-09-15

Because the Exchange Migration Wizard for Lotus Notes is a single-threaded application, to increase the performance and speed of your migration, you can run your migration using a batch file process to migrate your data. This option is available only if you run the Exchange Migration Wizard for Lotus Notes from the command line. You can use the command line reference and the batch files to increase the performance of your migration.

Use the following switches, available in the Exchange Migration Wizard for Lotus Notes, to run your migration from the command line.

Notesmig [/C:File [/A:Account] [/P:Password] [/S] [/?/h/help]

Command line switches

Switch Description

/C:File

The location of the control file. The control file is a text file containing parameters and their values, which are separated by commas.

/A:Account

Account is the path to the Notes ID file used for migration. This switch is not necessary for migration file import.

/P:Password

The password for the Notes ID file used for migration. The password is not necessary for migration file import.

/S:Silent mode

Silent mode. No error messages are displayed. All errors are written to the event log.

/?/h/help

Displays Help text.

Notesmig /C:notescontrolfile.txt /A:NotesAdmin.id /P:katmanduKatmandu

Depending on the success, the command line returns the following result codes:

  • 0 = Success. No errors or warnings

  • 1 = Warnings. No errors

  • 2 = Errors. Possible warnings

Parameters used to set values in the control file

Parameter Use Description

Mode

No default

Required when using the control file.

Valid settings:

FILE, NOTES.

The mode for this migration. It must be the first line in the control file.

noteNote:
Set Mode to FILE when importing migration files.

ForcePwdChange

Default: FALSE

Optional

Valid settings:

TRUE means that users must change their passwords.

FALSE means that users do not have to change their passwords.

Whether to force users whose accounts were migrated to change their passwords.

Function

Default: FULL

Optional

Valid settings:

FULL to perform a full migration (extract and import).

EXTRACT to extract migration files.

The migration function to perform.

File

No default

Required.

Function is set to EXTRACT, IMPORT, or FULL.

Valid settings:

For IMPORT, specify the path and file name of the packing list or user list file.

For EXTRACT or FULL, specify the path to the temporary directory to which migration files should be written.

The path and file name of the packing list or user list file, or the path to the temporary directory to which migration files should be written.

Accounts

No default

Required. If the Accounts keyword is not used, the Exchange Migration Wizard for Lotus Notes will migrate all accounts from the specified post office.

Valid setting is a user list file.

A user list file with a listing of accounts to be migrated. For an alias list, the format of each entry must match the name format as it appears in the Full Name column of the Exchange Migration Wizard for Lotus Notes Account Migration page. Each name is on one line and is followed by a carriage return and line feed.

Mailbox

Default: TRUE

Optional

Valid settings:

TRUE means mailboxes are created and messages are imported.

FALSE means messages are imported to existing mailboxes but new mailboxes are not created.

Whether to extract mailbox creation information and create the mailbox on Exchange.

Email

Default: TRUE

Optional

TRUE | FALSE

Whether to extract personal e-mail messages.

Schedule

Default: TRUE

Optional

TRUE | FALSE

Whether to extract schedule (calendar) information.

EmailStart

Default: Jan 01, 1601

Optional

Valid Setting:

Must be in the following date and time format: YYYYMMDDHHMMSS.

The start date of the date range that specifies which messages should be included in the migration. Messages without dates are always included. The Exchange Migration Wizard for Lotus Notes cannot determine whether messages without dates are within the specified date range, and therefore assumes that they are within the specified date range.

EmailEnd

No default

Optional

Valid Setting:

Must be in the following date and time format: YYYYMMDDHHMMSS.

The end date of the date range that specifies which messages should be included in the migration. Messages without dates are always included. The Exchange Migration Wizard for Lotus Notes cannot determine whether or not messages without dates are within the specified date range, and therefore assumes that they are within the specified date range.

SchedStart

Default: Jan 01, 1601

Optional

Valid Setting:

Must be in the following date and time format: YYYYMMDDHHMMSS.

The start date of the date range that specifies which calendar items should be included in the migration.

SchedEnd

No default

Optional

Valid Setting:

Must be in the following date and time format: YYYYMMDDHHMMSS.

The end date of the date range that specifies which calendar items should be included in the migration.

ExchStoreDN

No default

Required when Function is not set to EXTRACT.

Valid setting is a distinguished name.

The distinguished name of the Exchange mailbox store in which user mailbox stores are to be created.

Container

No default

Required when Function is not set to EXTRACT.

Valid Setting:

Must be formatted as follows:

OU=New Users,DC=MyDomain, DC=microsoft,DC=com New Users is a subcontainer of MyDomain.

The distinguished name of the organizational unit (container) in which new Microsoft Windows® accounts are to be created. You can get the full distinguished name from an LDAP viewer such as Ldp.exe or Adsivw.exe.

NTAccounts

Default: RANDOM

Optional

Ignored unless Mailbox is set to TRUE.

Valid settings:

RANDOM creates Windows accounts and generate random passwords.

ALIAS creates Windows accounts and uses the Exchange e-mail alias as the initial password.

Whether to create Windows user accounts for new users, and which value to use as the user account password.

POName

No default

Required

The hierarchical name of the bridgehead Notes Server/Organization.

ImportDestination

Default: SERVER

Optional

Valid settings:

SERVER migrates information to the Microsoft Exchange Information Store service.

PST migrates information to personal folder (.pst) files and personal address book (.pab) files.

Specifies the destination store for migrated data.

PSTPath

noteNote:
If you use the keyword ImportDestination, you can select the location where the .pst file will be placed. If you don't specify the location, the .pst file will be placed in the root directory of the drive where Exchange is installed.

Required if ImportDestination is set to PST.

Valid setting is path name.

The fully qualified path to the directory where personal folder (.pst) files are created.

IniFile

Default: The default installation directory that the installed Lotus Notes client version suggests during setup.

Optional

The path to the Notes client's Notes.ini file.

DocLinkConversion

Default: RTF

Optional

Valid settings:

URL to convert document links to URL shortcuts within the message.

OLE to convert document links to OLE attachments within the message.

RTF to convert document links to RTF attachments within the message.

How Lotus Notes document links are converted within the messages being migrated.

!

Optional

A comment delimiter. Must be the first value in the line.

InetOrgPerson

Default: FALSE

Optional

If InetOrgPerson equals TRUE, Exchange Migration Wizard for Lotus Notes creates an Active Directory object with an object class that equals InetOrgPerson.

By default, object class is OrganizationalPerson

You can use the following sample control files with the /C switch of the migration command-line utility.

noteNote:
The following is a sample control file for Lotus Notes migrations.

Lotus Notes one-step migration to a server (all users in a post office)

Mode,Notes
File,c:\temp
ExchStoreDN,CN=NotesUsers,CN=First Storage Group,CN=InformationStore,CN=Exchange6,CN=Servers,CN=First Administrative Group,CN=Administrative Groups,CN=First Organization,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=DomainXYZ,DC=CompanyXYZ,DC=com
Container,OU=NotesFolks,DC=DomainXYZ,DC=CompanyXYZ,DC=com
INIFile,C:\Lotus\Notes\notes.ini
POName,LocalPostOffice/Topeka/US
SchdStart,19980101000000
EmailStart,19980101000000
DocLinkConversion,OLE
NTAccounts,Random
 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft