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

For example: to migrate archives only

In the introduction to this section we mentioned the example of migrating users’ server mail and address books in batches, and then using the SSDM to migrate user archives (only). Since the per-desktop program will be used to migrate archives only, the admin wants to hide the other migration options (server mail and PABs) from the user, and moreover wants to streamline the rest of the user interface to minimize its demands on the users’ attention.

To accomplish this in the gwdtapp.ini file:

[General]
AppDoesMail=0
AppDoesPabs=0
MigrateArchives=1

[ArchiveData]
MigrateTrashFolder=1

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

These parameters will configure the Desktop Migrator to run like this:

Welcome Screen: Will not appear, because Welcome=skip and no user entires are requested on this screen.
Specify Data for Migration: Will not appear, because MigrateWhat=skip, and AppDoesMail=0 and AppDoesPabs=0, and the program will obtain its necessary archive-migration orders from MigrateArchives=1 and MigrateTrashFolder=1.
Login to Your GroupWise Account: Will appear in every program run.
Select Profile Screen: Will not appear if the program finds one and only one eligible Outlook profile on the user’s workstation. Otherwise, will be necessary to prompt the user to designate the profile.
Specify Directory for Migrated Archive: Will not appear, assuming the Outlook Default Directory is the preferred archive destination folder for every user. (If not, then specify a valid path for SelectedPstDir= under [General], or change PstDir=skip to PstDir=show.)
Selection Summary: Will not appear, because Summary=skip and no user entires are requested on this screen.
Enter Password (for Exchange): May or may not appear, per user, depending on whether the user’s profile is configured to require these credentials.
Migrating Data: Will not appear, because Progress=skip and no user entires are requested on this screen.
Migration Report: Will appear in every program run, since Finished=show.

So, omitting the skipped screens, and assuming that each user will have one and only one Outlook profile, and that we want user archives migrated to their Outlook Default Directories, the program’s screen sequence will be:

1
Login to Your GroupWise Account: Will appear in every program run.
2
Enter Password (for Exchange): May or may not appear, per user, depending on whether the user’s profile is configured to require these credentials.
3
Migration Report: Will appear in every program run, since Finished=show.

Command-line switches for running the SSDM in silent mode

The SSDM can be customized to skip certain screens, or even to hide all screens—to run in a true "silent mode," requiring no entries or other intervention from the end user. Whenever the program is configured to skip a screen display, the program must have some alternate method of obtaining the information it would otherwise collect from fields on the screen.

The program can read or infer some entry values from the operating environment—from the Windows Registry and Outlook’s initialization files—and some values can be specified by parameters in the gwdtapp.ini file. But some values can also be provided by command-line switches appended to the program command when the SSDM is executed. For example:

In the below list of all available switches for the gwdtapp command, note that the /silent switch is the only one that does not carry an argument:

/silent: Enforces a true "silent" run of the program—for no screen displays at all. The program will note errors in its log and may abort if it requires input data that is not made available via other switches (see below) or INI-file parameters, and that cannot be inferred from the operating environment.
/userid <UserID>: The user’s GroupWise UserID.
/pass <GWPassword>: The password associated with the UserID cited above.
/tgtprofile <ProfileName>: The Outlook profile that you want to migrate—the one into which your GroupWise server data, archive and/or personal address books should be placed.
/tgtpass <OutlookPassword>: The password associated with the target Outlook profile cited above.
/tgtdomain <DomainName>: The domain name of the target Exchange mail server.
/tgtuser <ADUserName>: The AD user name associated with the Outlook profile cited above.
Related Documents