Chat now with support
Chat with Support

Migrator for GroupWise 4.7 - Program Parameters Reference Guide

Introduction Parameters for Administrator Components Parameters for the SSDM

gwmigapp.ini [ActiveDirectory] section

Determines whether the Admin-Driven Batch Migrator will keep the Alias/Mailnickname stamped onto an object in AD, rather than replacing it with a value from GroupWise, when mailbox-enabling:
This example tells the program to keep the value set in AD. By default (AlwaysUseOldAlias=0) the program will let the MFG value overwrite the existing AD value.
gwmigapp.ini [ActiveDirectory] AlwaysUseOldExchDn=<#>
This AlwaysUseOldExchDn parameter must be set to 1 in the [ActiveDirectory] sections of both gwmigapp.ini and adobjmerge.ini, and
The RemoveSrcAddresses parameter (in gwmigapp.ini [ActiveDirectory]) must be set to 1.
The feature is on (1) by default, but can be disabled by AlwaysUseOldExchDn=0 — which is the appropriate choice if objects were synched into AD by some method other than CMG's Directory Connector or Microsoft's Connector, or if you don't care about free/ busy lookups for Outlook 2003 users, or if you will simply force all Outlook 2003 clients to refresh their caches, or if you prefer the shorter “friendlier” names in Outlook 2003's auto-complete feature.
When the Admin-Driven Batch Migrator creates an AD mailbox from an existing contact (when MboxFromContact=1), this parameter determines whether the contact's attribute values (phone numbers, fax numbers, departments, titles, etc.) will be preserved in the new mailbox-enabled object (AttrFromContact=1, the default), or will be replaced by the attribute values in MFG's csv file, from the GroupWise source (AttrFromContact=0).
gwmigapp.ini [ActiveDirectory] CanAddGroupMembers=<#>
Tells the program whether to define a new AD contact for any group member not found in AD, and add the contact as a new member to the corresponding AD group, in the container specified by the GroupContactsContainer parameter (also in this [ActiveDirectory] section, and mandatory if CanAddGroupMembers=1). By default (0), the program does not define new contacts.
gwmigapp.ini [ActiveDirectory] CanDeleteGroupMembers=<#>
gwmigapp.ini [ActiveDirectory] CmgExcludeFromDirSync=extensionAttribute<##>
The parameter defaults to extensionAttribute15, which is suitable as long as your organization is not already using extensionAttribute15 for some other purpose. If you are already using extensionAttribute15 (and are using the CMG Directory Connector), change the parameter value to some other unused AD attribute (within the range 1–14).
This parameter can be set only if SetCmgExcludeAttr=1 (see notes for SetCmgExcludeAttr, also in this [ActiveDirectory] section).
gwmigapp.ini [ActiveDirectory] CreateMailboxDelay=<######>
If the program is mailbox-enabling and finds the primary SMTP address of an Active Directory entry to be different from the expected SMTP address, this ForceAddress parameter determines whether the program should change the AD entry to the primary SMTP address specified in the targetAddress column of the exported object data csv files. For example, ForceAddress=0 tells the program to not change the AD address entry to the expected SMTP address. The feature is enabled (ForceAddress=1) by default.
gwmigapp.ini [ActiveDirectory] GroupContactsContainer=<ContainerRDN>
Specifies a relative domain name (relative to [ActiveDirectory] GroupsRDN, which in turn is relative to the default naming context of the domain) to identify the sub OU in AD where new contacts will be created if CanAddGroupMembers=1. For example: GroupContactsContainer=OU=Groups
Determines the value the Admin-Driven Batch Migrator will assign to the AD MapiRecipient property, when mailbox-enabling, if UseMapiRecipientFlag=1 (elsewhere in this same [ActiveDirectory] section). If UseMapiRecipientFlag=0, the program will ignore this MapiRecipientFlag parameter and leave the AD property at its <not set> default. For example, MapiRecipientFlag=1 (the default) tells the program to set the AD MapiRecipient property to TRUE, while a value of 0 tells the program to set the property to FALSE. See the UseMapiRecipientFlag parameter below for more information about this feature.
IMPORTANT: The same two parameters must also be set to the same values in the [ActiveDirectory] section of the adobjmerge.ini file, so that the Batch Migrator can correctly set the MapiRecipient property to match the value set by the AD Object Merge Tool.
When merging, the default setting (MergeGrpMembership=1) tells the Admin-Driven Batch Migrator to add a user to a group if the corresponding Contact is a member of the group. The alternate setting (MergeGrpMembership=0) disables this feature.
Note that these PSRetry parameters can also be set in adobjmerge.ini.
Sets the interval (in seconds) between retry attempts when the program will retry data transmissions to the Exchange environment due to errors in prior attempts. This PSRetryWait parameter is used in conjunction with PSRetry­Attempts to control retries of transmissions to Exchange, as described above for the PSRetryAttempts parameter. The default is 15 seconds for migration to a proprietary Exchange, or 40 seconds for migration to Office 365.
gwmigapp.ini [ActiveDirectory] RemoveSrcAddresses=<#>
Tells the program whether to remove all GroupWise source addresses (gwise: proxy-Addresses) so that mailbox-enabled accounts in Active Directory can be synchronized back to GroupWise as external users. If RemoveSrcAddresses=0 (default), only the gwise:uid- address is removed. An object’s gwise:uid- address must be removed once the object has been mailbox-enabled. Other GroupWise addresses are used to route mail via CMG's Mail Connector or Microsoft’s Connector, if either is used, but are harmless to leave in place if neither connector is used.
gwmigapp.ini [ActiveDirectory] SetCmgExcludeAttr=<#>
Determines whether the Batch Migrator program will populate the extension attribute designated by the CmgExcludeFromDirSync parameter (also in this [Active Directory] section), which in turn specifies the AD attribute that will determine when merged and mailbox-enabled objects should synchronize back into GroupWise. This SetCmgExcludeAttr parameter is set to 1 (on) by default, but you can set SetCmgExcludeAttr=0 to tell the program to not set (to ignore) the CmgExcludeFromDirSync parameter.
gwmigapp.ini [ActiveDirectory] UseMapiRecipientFlag=<#>
Determines whether the Admin-Driven Batch Migrator, when mailbox-enabling, will set the AD mAPIRecipient property according to the MapiRecipientFlag parameter value (also in this [ActiveDirectory] section). If UseMapiRecipientFlag=0, the program will leave the AD property at its <not set> default. But UseMapiRecipientFlag=1 (the default) tells the program to set the AD property according to the MapiRecipientFlag parameter value. See the MapiRecipientFlag parameter above for more information about this feature.
IMPORTANT: The same two parameters must also be set to the same values in the [ActiveDirectory] section of adobjmerge.ini, so the Batch Migrator can correctly set the mAPIRecipient property to match the value set by the AD Object Merge Tool.

gwmigapp.ini [ArchiveData] section

gwmigapp.ini [ArchiveData] MigrateJunkFolder=<#>
Determines whether the program will migrate the contents of the archived junk mail folder. MigrateJunkFolder=0 tells the program to not migrate the junk folder. By default (MigrateJunkeFolder=1), the junk folder will be migrated.
Determines whether the program will migrate archives to the primary Outlook mailbox (the main root) rather than to subfolders under a pseudo root. For example, UsePseudoRoot=0 tells the program to migrate archives to the top-level mailbox (without a pseudo-root folder). By default (1), the program migrates archives to subfolders under a pseudo root.

gwmigapp.ini [ErrorsToIgnore] section

gwmigapp.ini [ErrorsToIgnore] Error[#]=<[####-###-###-########]>
Each Error[#] parameter specifies a single particular runtime error that the program should ignore when documenting its activities and outcomes in its log file. Each parameter value:
The digit(s) appended to an Error[#] key name arbitrarily differentiate the parameters from one another. Multiple Error[#] parameters need not appear in numerical order, need not form an uninterrupted numerical sequence, and need not begin at 0. But the program will read only Error[#] parameters whose differentiating digits are within the range 0–99 inclusive.

gwmigapp.ini [ErrorsToWarn] section

gwmigapp.ini [ErrorsToWarn] Error[#]=<[####-###-###-########]>
Each Error[#] parameter specifies a single particular runtime error that the program should change to a warning when documenting its activities and outcomes in its log file. Each parameter value:
The digit(s) appended to an Error[#] key name arbitrarily differentiate one parameter from another. Multiple Error[#] parameters need not appear in numerical order, need not form an uninterrupted numerical sequence, and need not begin at 0. But the program will read only Error[#] parameters whose differentiating digits are within the range 0–99 inclusive.
Related Documents