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.
|
||
|
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. |
||
|
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
|
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.
Note: |
|---|
| 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

Note: