Chatta subito con l'assistenza
Chat con il supporto

Migrator for Notes to Exchange 4.16.3 - SSDM User Guide

About the Migrator for Notes to Exchange documentation Scenarios overview Migration to a proprietary Exchange
Migration to a proprietary Exchange target Pre-migration preparations Batch migration process Post-migration activities
Migration to Microsoft 365
Pre-migration preparations Batch migration process Post-migration activities
SSDM (per-desktop) migration

Command-line switches for running the desktop migrator in silent mode

When the SSDM runs in a silent mode, the program can obtain some entry values from the operating environment—from the Windows Registry and Outlook initialization files—and some values can be obtained from parameters in the notesdtapp.ini file. Some values can also be provided by command-line switches appended to the program command when the Desktop Migrator is run. For example:

In this list of available switches for the notesdtapp command, the /silent switch is the only one that does not have an argument:

/silent: Enforces a true "silent" run of the program—no screens at all. The program logs errors in the log file and can end the process if it requires input data that is not available through other switches or INI-file parameters, or that cannot be obtained from the operating environment.
/notesid <UserID>: Full path and file name of user Notes UserID.
/notespass <NotesPassword>: Password associated with the UserID.
/tgtprofile <ProfileName>: Outlook profile that you want to migrate — the one into which your Notes server data, archive and/or personal address books should be placed.
/tgtpass <OutlookPassword>: Password associated with the target Outlook profile.
/tgtdomain <DomainName>: Domain name of the target Exchange mail server.
/tgtuser <ADUserName>: AD user name associated with the Outlook profile.
/tgtmsgstore <MailboxName>: Name of the target Outlook mailbox (if the Outlook profile contains more than one mailbox).

Configuration of silent mode in notesdtapp.ini

When Silent Mode is configured, the migration team configures the application in advance within the notesdtapp.ini file to determine what will migrate, the target for each migrated data type, and the filters and other configuration elements for the migration. For example:

... tells SSDM to migrate only archives when launched by the end user and to place the migrated data in the user server-based personal archive.

Various degrees of the silent mode option can be configured depending on the flexibility and control you want to provide to the users. However, the mode is commonly configured to run as "silently" as possible, which means users are able to complete their migrations by entering their Notes passwords.

Providing program entry values in notesdtapp.ini

If the Self-Service Desktop Migrator (SSDM) is configured to skip certain screens, the program must have an alternate method to obtain the information that would be collected from fields on those screens. The program can obtain some values from the operating environment—from the Windows Registry and the Outlook initialization files—but some values can be provided by parameters in the notesdtapp.ini file.

When an value is specified in the INI file, the value appears as the default if the corresponding screen and option appear in the program run, or will be the prevailing value if the screen and option do not appear.

Migration choices in the Specify Data for Migration screen

Any of the migration choices in the Specify Data for Migration screen can be specified in notesdtapp.ini using these parameters:

[ArchiveData]

MigrateArchives=1
MigrateTrashFolder=1
MigrateServerMail=1
MigratePAB=1

[ServerData]

MigrateTrashFolder=1

A value of 1 sets the option to "yes" (the data type is migrated if the screen does not appear), or sets the check box to be selected by default. A value of 0 sets the option to "no," or sets the check box to be empty by default. If a feature is disabled by AppDoesXxxx=0 (see Hiding certain user choices on the Specify Data for Migration screen), the corresponding INI-file parameter is ignored.

Usually these parameters are used provide the necessary values when the program is configured to skip the Specify Data screen using MigrateWhat=skip or MigrateWhat=silent (see Hiding entire screens from the user).

Outlook profile in the Select Profile screen

If the program finds more than one eligible Outlook profile on the user computer, or does not find a profile, the program displays a Select Profile screen to prompt the user to specify the profile. If one eligible Outlook profile is found, the program assumes it is the correct profile and the Select Profile screen does not appear.

You can configure the end-user program to skip the Select Profile screen but the program must be able to determine the correct Outlook profile. You can specify the user Outlook profile in notesdtapp.ini using:

Specifying the user Outlook profile in the INI file is useful only if:

The program does not need the ProfileName value if only one eligible profile is found on each user workstation.

Outlook mailbox in the Select Mailbox screen

If MNE finds more than one mailbox in the selected Outlook profile, MNE displays a Select Mailbox screen to prompt the user to designate the target mailbox. If only one mailbox is found for the selected profile, MNE assumes it is the correct mailbox and the Select Mailbox screen does not appear.

You can configure the SSDM to skip the Select Mailbox screen, but in that case (or if more than one mailbox is associated with the Outlook profile) the program must be able to determine the correct mailbox. You can specify the user target mailbox in notesdtapp.ini using:

Specifying the target mailbox in the INI file is useful only if:

The SSDM does not need this MailboxName value if one and only one mailbox will be found in the user’s Outlook profile.

Archive destination folder in the Specify Directory for Migrated Archive screen

You can specify the destination folder (path) for the user migrated archive in the [General] section of notesdtapp.ini using:

... where <path> is the full UNC path relative to the user computer.

This value, if necessary in a particular program run, would otherwise be specified in the Specify Directory screen.

The default for this parameter is the Outlook Default Directory which the program can determine from the operating environment. This parameter is necessary only if you want user migrated archives to go to a location other than the Outlook Default Directory.

Filter conditions in the Select Date and Size Filters screen

The Self-Service Desktop Migrator (SSDM) lets you specify date limits and ranges for messages to be migrated—to migrate only messages timestamped on, after, or before a certain date, or within a particular date range. You can also specify a maximum size limit for attachments. The date and size filters can be specified during a program run on the Select Date and Size Filters screen, However, the screen is hidden by default (see next section) and the filters can be defined by these parameter settings in the [Filter] section of notesdtapp.ini:

The AttachSize value is numeric in kilobytes. You must enter the date parameter values in an eight-digit, slash-separated format as shown, with a zero preceding any single-digit month or day. The defaults for the parameters are null so no filtering occurs.

Hiding entire screens from the user

You can customize the Self-Service Desktop Migrator (SSDM) program to make some of its screens "silent" (invisible to the end user) or to conditionally skip a screen, making it visible only if the program cannot find information from the operating environment or in the notesdtapp.ini file. The display option for each screen can be set to one of three parameter values in the notesdtapp.ini file:

show: The screen appears in every program run.
skip: The screen appears only if the program cannot obtain the required information from the operating environment or from parameters in the notesdtapp.ini file.
silent: The screen does not appear in any program run. The information that would be collected by the screen is provided by notesdtapp.ini parameters or obtained from the operating environment. If the program cannot determine the necessary information, the function fails and the user is not migrated.

The show, skip or silent mode can be applied to each of ten program screens by setting parameter values in the [Screens] section of notesdtapp.ini for the following:

Welcome=

Welcome

show

MigrateWhat=

Specify Data for Migration

show

SelectAddrBook=

Select Notes Address Books to Migrate

show

SelectArchive=

Select Notes Archive Files to Migrate

show

SelectMailFile=

Select Notes Local Mail File Replica

show

Filter=

Select Date and Size Filters

no-op*

Profile=

Select Profile

skip

Mailbox=

Select Mailbox

skip

PstDir=

Specify Directory for Migrated Archive

show

Summary=

Selection Summary

show

Progress=

Migrating Data

show

Finished=

Migration Report

show

*no-op: Functionally equivalent to "silent", but signifies that the parameter value is unassigned—in which case the screen will not appear in a program run.

The visibility of the Enter Password screen (occurs between the Selection Summary and Migrating Data screens) cannot be set or changed in the notesdtapp.ini file. This Microsoft prompt for the user Exchange login credentials can appear if the Outlook profile is configured to require login credentials. If this screen is mandatory, a completely "silent" run of the program may not be possible. Even if you set the other screens to silent mode, the program might still prompt the user for Exchange login credentials.

Related Documents

The document was helpful.

Seleziona valutazione

I easily found the information I needed.

Seleziona valutazione