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 executed. 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). |
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:
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.
Any of the migration choices in the Specify Data for Migration screen can be specified in notesdtapp.ini using these parameters:
MigrateArchives=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).
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.
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.
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.
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.
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:
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.
© 2024 Quest Software Inc. ALL RIGHTS RESERVED. Feedback Termini di utilizzo Privacy Cookie Preference Center