Chat now with support
Chat with Support

Migrator for GroupWise 4.7 - Scenarios Guide

About this guide Scenarios overview Migration to a proprietary Exchange target
Pre-migration preparations Batch migration process Post-migration activities
Migration to Office 365
Migration to Office 365 Pre-migration preparations Batch migration process Post-migration activities
SSDM (per-desktop) migration

Archive Destination Folder in the Specify Directory for Migrated Archive screen

Archive Destination Folder in the Specify Directory for Migrated Archive screen

The destination folder (path) for the user’s migrated archive can be specified in the [General] section of gwdtapp.ini by:

... where <path> is the full UNC or mapped-drive path (without filename) relative to the user’s 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 its operating environment. This parameter is therefore necessary only if you want users’ migrated archives to go somewhere other than the Outlook Default Directory.

Filter conditions in the Select Date and Size Filters screen

Filter conditions in the Select Date and Size Filters screen

The SSDM lets you specify date limits and ranges for messages to be migrated— to migrate only messages timestamped on or after (or before) a certain date, or within a particular range of dates. You can also specify a maximum size limit for attachments. These date and size filters can be specified during a program run on the Select Date and Size Filters screen, but that screen is hidden by default (see the AskFilter= parameter in the next section below) and the filters may instead be defined by these parameter settings in the [Filter] section of gwdtapp.ini:

The AttachSize value is numeric, in kilobytes. Date filters for mail and calendar items are set independently, as shown above (two different pairs of parameters). For either the mail or calendar filter, the two date parameter values must be entered in the eight-digit, slash-separated form shown above, with a zero preceding any single-digit month or day. The defaults for all four parameters are null, so no filtering will occur.

Hiding entire screens from the user

The SSDM program can be customized to make some of its screen displays "silent"—that is, invisible to the end user—or to skip a screen conditionally, making it visible only if the program cannot find the information it needs either from the operating environment or elsewhere in the gwdtapp.ini file. The display option for each screen can be set to one of these three parameter values in the [Screens] section of the gwdtapp.ini file:

show: The screen will appear in every program run.
skip: The screen will appear only if the program cannot read or infer the associated information either from the operating environment, or from other parameters within the gwdtapp.ini file.
silent: The screen will not appear in any program run. The information that would otherwise be collected by the screen can instead be provided by other parameters in gwdtapp.ini, and/or can be read or inferred from the operating environment. But if the program cannot determine the necessary information, the function will fail and the user’s data will not be fully migrated. (This is a likely cause of any failed or incomplete single-user migration if the INI file has been modified to make one or more screens "silent.")

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

Parameter

[Screens] Welcome=
[Screens] MigrateWhat=
[Screens] Profile=
[Screens] PstDir=
[Screens] Summary=
[Screens] Progress=
[Screens] Finished=

Screen Name (in Title Bar)

Welcome
Specify Data for Migration
Select Profile
Specify Directory for Migrated Archive
Selection Summary
Migrating Data
Migration Report

Default

show
show
skip
show
show
show
show

The visibility of the Select Date and Size Filters screen is set by a boolean parameter in a different section:

The default (AskFilter=0) tells the SSDM to not show the Select Date and Size Filters screen. To use date filters with the SSDM, you may need to register the mscal.ocx file.

The visibility of two other screens cannot be set or changed in gwdtapp.ini:

Login to Your GroupWise Account (occurs between the Specify Data and Select Profile screens): The GroupWise Login screen cannot be skipped or silent, because no migration is possible without the user’s login credentials.
Enter Password (occurs between the Selection Summary and Migrating Data screens): This Microsoft prompt for the user’s Exchange login credentials may appear if the Outlook profile is configured to require login credentials.

Both of these values can, however, be specified by command-line switches when the Desktop Migrator program is executed. See Command-line switches for running the SSDM in silent mode near the end of this chapter for more information about these and other command-line switches.

Hiding certain user choices on the Specify Data for Migration screen

Hiding certain user choices on the Specify Data for Migration screen

The default display of the Specify Data for Migration screen lets the user migrate any combination of three types of user data: server mail, archives and personal address books (PABs). But some administrators prefer to offer only one or two of these options. Three boolean parameters in gwdtapp.ini, in the [General] section, control whether these options will appear in the screen:

For each parameter, the default value 1:

Sets the corresponding MigrateXxxx= parameter to 1 (see Choices in the Specify Data for Migration screen above) when in silent mode—that is, if MigrateWhat=silent. Although if MigrateWhat=show or =skip, the AppDoesXxxx= setting has no effect on the corresponding MigrateXxxx= parameter.

A setting of AppDoesXxxx=0:

Masks the portions of the Welcome and Migration Report screens that pertain to the hidden option.

If a parameter is left unspecified in the INI file, the corresponding option will appear on the screen.

Note that these parameters do not set the marked-vs-unmarked status of the corresponding checkboxes, although those status settings can be controlled by other parameters (see Providing program entry values in gwdtapp.ini above).

When the program is configured to display only one of the three options in Specify Data for Migration, the lone option will appear without a checkbox, so a user cannot turn off the associated function by deselecting the checkbox.

Related Documents