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 [General] section

gwmigapp.ini [General] ACLRootVisibleOnly=<#>
Tells the program whether to migrate the ACLs of shared-access folders when MigrateEmptyFolders=0 (in the [GroupWise] section, telling the program to not migrate empty folders). If MigrateEmptyFolders=1, the ACLs are migrated and any ACLRootVisibleOnly parameter is ignored. The program will migrate shared-folder ACLs by default (ACLRootVisibleOnly=1), but you can disable the feature by ACLRootVisibleOnly=0.
ACLs=0 tells the program to not copy ACL information to Exchange during the migration. By default (1) the program will copy ACL information and will set folder permissions in Exchange.
gwmigapp.ini [General] ArchiveFolderName=<alphanum>
gwmigapp.ini [General] AttachmentRetryCount=<##>
Specifies the number of additional times the program should attempt to migrate an attachment if the first attempt fails. Valid values are integers in the range 0–99 inclusive. For example, AttachmentRetryCount=3 tells the program that, if an attachment fails to migrate, the program should retry the migration three more times before giving up.
gwmigapp.ini [General] CommandLine=<alphanum>
gwmigapp.ini [General] DoInactivityTimer=<#>
Determines whether the Batch Migrator program's inactivity timer is enabled or disabled. For example, DoInactivityTimer=1 tells the program to abort a process if it receives no response from the destination server for longer than a specified number of minutes following a data transmission. The timeout limit is 40 minutes by default, or you can specify some other value by the InactivityTimeoutMinutes parameter (also in this [General] section). To disable this feature, set DoInactivityTimer=0.
gwmigapp.ini [General] DoMigrateNotesOfContacts=<#>
EnableBPOS=1 enables the BPOS features in the Batch Migrator, and adds BPOS-D to the drop-down list of eligible migration targets. This feature is off (0) by default.
gwmigapp.ini [General] ForwardingMethod=<#>
gwmigapp.ini [General] InactivityTimeoutMinutes=<##>
Sets the inactivity timeout limit, by number of minutes, if the timeout feature is enabled by DoInactivityTimer=1 (see separate parameter above in this same [General] section). The inactivity timeout feature tells the program to abort a process if it receives no response from the destination server for longer than a specified number of minutes following a data transmission. For example, InactivityTimeoutMinutes=60 tells the program to set the timeout threshold at 60 minutes (1 hour).
gwmigapp.ini [General]MaxPstSize=<#######>
gwmigapp.ini [General] MergeAddressBookFolder=<alphanum>
This parameter is ignored if MergeAddressBooks=0 and no address-book value is specified for the MergeAddressBookList parameter (see below).
gwmigapp.ini [General] MergeAddressBookList=<Name1; Name2; …>
Tells the program to merge the contents of the named address book(s) into the single Contacts folder, or into a single folder as named by the MergeAddressBookFolder parameter (see above). Address-book name values are both case- sensitive and space-sensitive, and you may specify two or more by using semicolons to separate the folder names in the list. This parameter is ignored if MergeAddressBooks=1 (see below), which tells the program to migrate all address books into a single folder. By default the program migrates different address books to different folders, one folder per address book.
gwmigapp.ini [General] MergeAddressBooks=<#>
MergeAddressBooks=1 tells the program to merge the contents of all migrated address books into the single Contacts folder, or into a single folder as named by the MergeAddressBookFolder parameter (see above). By default the program migrates different address books to different folders, one folder per address book.
gwmigapp.ini [General] MaxDiscrepancyThreshold=<####>
When the migration program exits due to an unexpected error or exception, RetryMax controls the maximum retry count. RetryMax=0 tells the program to disable retries.
boolean; default = 0
SkipIncomingSharedFolder=1 tells the program to skip the incoming shared folder during the migration.
Silent=1 tells the program to run in Silent mode — to use the configuration options provided during a previous session and run without user input.
gwmigapp.ini [General] UseSeparatePSTS=<#>
UseSeparatePSTS=0 tells the program to migrate all data into a single pst file per user. The default is 1, so data is migrated into multiple pst files.
gwmigapp.ini [General] DoCategories=<#>
Determines whether the Admin-Driven Batch Migrator will migrate message Categories—color differentiation of messages within a folder, at the user's designation. The feature is enabled (DoCategories=1) by default, but can be disabled by DoCategories=0. If the GroupWise source Category color does not exactly match one of Outlook's 25 standard colors, MFG will assign it to the closest matching color.
Note: This feature requires GroupWise 6.5.7 or later on the admin's migration workstation.

gwmigapp.ini [GroupWise] section

gwmigapp.ini [GroupWise] AdminApiLockWaitSecs=<###>
Number of seconds the program will wait before attempting (again) to set a user password, if the first or previous attempt was unsuccessful. For example, AdminApiLockWaitSecs=300 (the default) tells the program to wait five minutes (300 seconds) before each retry to set a user password.
gwmigapp.ini [GroupWise] AdminApiRetries=<##>
Number of times the program will attempt to set a user password before giving up (if all attempts are unsuccessful). For example, AdminApiRetries=6 tells the program to retry setting a user password up to six times before giving up. The default setting of 0 tells the program to never retry; if the first attempt is unsuccessful, the program will simply log the error and move on to the next user.
gwmigapp.ini [GroupWise] AlwaysExpandRecips=<#>
Determines whether the program, when migrating a message sent to a distribution list, will migrate only the name of the list as the recipient, or will preserve the original GroupWise recipients by expanding the list prior to migration—to record all list members as of the Send date. For example, AlwaysExpandRecips=1 tells the program to expand distribution lists prior to migration. If this feature is off (0), the program migrates only the name of a list, and a later expansion of the list name (in Outlook) will yield an inaccurate list of recipients if list membership had changed after the message was originally sent.
The size of an expanded recipient list may be limited by the MaxExpandedRecips parameter (see separate listing below), also in this [GroupWise] section.
gwmigapp.ini [GroupWise] DebugFolder=<FolderName>
ExportHTML=0 tells the program to not migrate HTML message bodies. By default (ExportHTML=1) the program will migrate HTML message bodies.
ExportRTF=1 tells the program to migrate RTF message bodies. By default (ExportRTF=0) the program will not migrate RTF message bodies.
gwmigapp.ini [GroupWise] ForwardLockWaitSecs=<###>
Number of seconds the program will wait before attempting (again) to set mail-forwarding for a particular user, if the first or previous attempt was unsuccessful. For example, ForwardLockWaitSecs=300 (the default) tells the program to wait five minutes (300 seconds) before each retry to set a user's mail-forwarding.
gwmigapp.ini [GroupWise] ForwardRetries=<##>
Number of times the program will attempt to set a user's mail-forwarding before giving up (if all attempts are unsuccessful). For example, ForwardRetries=6 tells the program to retry setting a user's mail-forwarding up to six times. The default (0) tells the program to never retry; if the first attempt is unsuccessful, the program simply logs the error and moves on to the next user.
This parameter corresponds to a GUI element in the Directory Exporter: the GroupWise Soap Server URL field in the GroupWise System Information screen. The value specifies the location of the GroupWise SOAP web service. This parameter is optional, but will help resolve a duplicate-meetings issue that can occur in some scenarios in some environments where Quest CMG coexistence product is also deployed. When a GroupWise user creates a meeting in GroupWise, and then changes it (or changes one instance of a recurring series) after he/she is migrated, the invitees' calendars may show duplicate instances unless the SOAP service is enabled and its URL is specified. This solution works only for GroupWise 8 and later (not for GroupWise 7).
These four Login parameters let you delay the program’s login to GroupWise:
In the event of a login failure, number of times (0 ≤ x ≤ 9999) to retry. For example: LoginAttempts=3
Number of seconds (0 ≤ x ≤ 9999) to delay before logging in. For example: LoginDelay=10
Number of seconds (0 ≤ x ≤ 9999) to wait between login attempts, if LoginAttempts > 1. For example: LoginRetryWait=10
Number of seconds (0 ≤ x ≤ 9999) to wait for the login mutex. For example: LoginWait=600
gwmigapp.ini [GroupWise] MaxExpandedRecips=<####>
Specifies the maximum number of recipients that MFG will expand from a recipient list, when AlwaysExpandRecips=1 (see “gwmigapp.ini [GroupWise] AlwaysExpandRecips=<#>” on page 42.). That is, if the full list is longer than the specified max, MFG will truncate the expanded list at this specified limit. The value may be set to any positive 32-bit integer, and defaults to 500, and should always match the maximum recipient list size in Exchange (which is 500 by default).
gwmigapp.ini [GroupWise] MigrateDocRefs=<#>
MigrateDocRefs=1 tells the program to migrate documents and document references as attachments. By default, documents and document references do not migrate. Note that if any of these documents are GroupWise hidden messages, you must also set [GroupWise] MigrateHiddenMsg=1 (see below) if you want to migrate the hidden messages.
gwmigapp.ini [GroupWise] MigrateEmptyFolders=<#>
MigrateEmptyFolders=0 tells the program to not migrate empty folders. By default, the program will migrate all folders regardless of whether they contain any items. Note: If MigrateEmptyFolders=0, the program migrates ACLs by default unless AclRootVisibleOnly=0 (in the [General] section).
gwmigapp.ini [GroupWise] MigrateEmptySharedFolders=<#>
MigrateEmptySharedFolders=1 tells the program to migrate empty shared folders, if MigrateEmptyFolders=0 (which tells the program to not migrate other empty folders). For example:
... tells the program to migrate empty shared folders, but to not migrate other (non-shared) empty folders. By default (MigrateEmptySharedFolders=0), empty shared folders are not migrated. If MigrateEmptyFolders=1 (the default), the program ignores this MigrateEmptySharedFolders parameter and migrates all empty folders.
gwmigapp.ini [GroupWise] MigrateHiddenMsg=<#>
MigrateHiddenMsg=1 tells the program to migrate GroupWise hidden messages that occur as Document References in mail folders. This feature is associated with a check box (Migrate Document References in mail folders by migrating a copy of the document) on the Specify Data for Migration screen of the program. If that check box is marked, and if the documents to be migrated are GroupWise hidden messages, the hidden messages will be migrated only if MigrateHiddenMsg=1.
MigrateMySubjectAppointments=1 tells the program to migrate the My Subject field of an appointment from GroupWise, and use it as the appointment subject in the target.
MigrateMySubjectDocs=1 tells the program to migrate the My Subject field of a document from GroupWise, and use it as the document subject in the target.
MigrateMySubjectEmails=1 tells the program to migrate the My Subject field of an email from GroupWise, and use it as the email subject in the target.
MigrateMySubjectPhoneMsgs=1 tells the program to migrate the My Subject field of a note from GroupWise, and use it as the note subject in the target.
MigrateMySubjectPhoneMsgs=1 tells the program to migrate the My Subject field of a phone message from GroupWise, and use it as the message subject in the target.
MigrateMySubjectTasks=1 tells the program to migrate the My Subject field of a task from GroupWise, and use it as the task subject in the target.
gwmigapp.ini [GroupWise] MigrateNotesAs=<#>
If MigrateNotesAs=2, the program looks at the due-date property to determine whether it is an all-day event (due-date property is set to 0), or a task (due-date property is set to anything other than 0).
gwmigapp.ini [GroupWise] MigrateSharedFolders=<#>
MigrateSharedFolders=1 tells the program to migrate an independent copy of each shared folder to each user to whom the source folder was shared. By default the program migrates only a single copy of each shared folder to the user who owned it in GroupWise, and sets ACL permissions on that folder for other users to whom the GroupWise folder was shared.
gwmigapp.ini [GroupWise] MigrateSharedPABs=<#>
MigrateSharedPABs=1 tells the program to migrate an independent copy of each shared PAB to each user to whom the source PAB was shared. By default the program migrates only a single copy of each shared PAB to the user who owned it in GroupWise, and sets ACL permissions on that PAB for other users to whom the GroupWise PAB was shared.
The highest message number you want to migrate (if you want to migrate only messages up to and including a particular message number. For example, MsgIdxEnd=6108 tells the program to migrate messages up to and including message index #6108. To migrate all messages up to the latest message number, simply omit this item from the INI file. Valid values are 0 up to the number of messages in the message store.
gwmigapp.ini [GroupWise] MsgIdxStart=<###>
gwmigapp.ini [GroupWise] PabsToIgnore=<PABName>
gwmigapp.ini [GroupWise] <PostOffice>.<Domain>=<<IP>:<Port>>
Associates a particular GroupWise Post Office/domain with its corresponding IPaddress:port. These parameters support unambiguous GroupWise-to-Exchange mail forwarding for two users sharing the same name and Object ID, but residing in different Post Offices and different domains. You can configure as many of these parameters as necessary to associate a unique IPaddress:port with each GW Post Office/domain. For example, if:
gwmigapp.ini [GroupWise] ProxyAccountRights=<#>
ProxyAccountRights=1 tells the program to migrate users' proxy rights along with the users' other account information. Prior to version 3.1, the program migrated proxy rights by default. As of version 3.1, the default is to not migrate proxy rights (ProxyAccountRights=0).
... tells the program to retry 5 times (6 total tries), at intervals of 60 seconds, and then give up if still unsuccessful. The RetryCount tells the program how many times to retry to migrate a message (if not successful on the first attempt), at intervals specified by the RetryDelay parameter, before giving up the attempts. The defaults are RetryCount=3 and RetryDelay=30. If a message fails again on the last attempt, the program notes the failure in its log and resumes processing with the next message.
(The WriteMessageTryCount parameter, in the [Exchange] section, does the same thing for errors that occur between MFG and Exchange.)
gwmigapp.ini [GroupWise] SetDelSentItemsRule=<#>
Determines whether the Batch Migrator will purge the GroupWise Sent Items folder of forwarded items. For example, if the Batch Migrator is set to forward mail, then
tells the program to set an additional rule to delete forwarded items from the GroupWise Sent Items folder, and to automatically remove the rule when GroupWise forwarding is removed. The feature is enabled (SetDelSentItemsRule=1) by default.
gwmigapp.ini [GroupWise] SkipCountByFolder=<#>
SkipCountByFolder=1 tells the program to not try to count messages by folder, but instead just count all messages. If SkipCountByFolder=0 the program counts by folder and then by message to work around a bug in the GroupWise API that limits the folder count to 8191 messages. If a folder contains more than 8191 messages, then the program will automatically switch methods. If the program crashes when estimating the number of messages to be migrated, setting this parameter value to 1 will probably preempt the crash.
gwmigapp.ini [GroupWise] UseTrustedAPI=<#>
UseTrustedAPI=0 tells the program to not use Novell's Trusted Application API feature to automatically register itself as a trusted application, so it can migrate GroupWise user data without user passwords or proxy authorization. By default, the program will use the Trusted Application API feature (UseTrustedAPI=1).

gwmigapp.ini [Outlook] section

gwmigapp.ini [PowerShell] section

gwmigapp.ini [PowerShell] IdleConnectionTimeoutSeconds=<##>
Specifies how long (in seconds) MFG will hold open an idle remote PowerShell connection before closing it. The default IdleConnectionTimeoutSeconds=30 will be suitable for most environments. Note that this feature applies only to the duration of an idle state during a connection. Each command execution resets this timer to zero, so a series of commands with only short idle periods between commands could keep the connection open indefinitely. IdleConnectionTimeoutSeconds=0 would tell MFG to not wait (wait 0 seconds) for a second command after a first, so every PowerShell connection would close immediately after only one command.
gwmigapp.ini [PowerShell] MaxPowerShellConnections=<#>
... where R is the number of simultaneous runspaces allowed by your tenant (typically 9), and S is the number of migration servers you will use. For example, if your limit is 9 runspaces and you intend to use one migration server, then MaxPowerShellConnections=8 = (9-1)/1. Or for a 9-runspace limit with 2 migration machines: MaxPowerShellConnections=4 = (9-1)/2. The default MaxPowerShellConnections=0 is interpreted as “no limit”, effectively turning off this limiting feature.
gwmigapp.ini [PowerShell] PropagationDelay=<##>
Determines how long (in seconds) the Admin-Driven Batch Migrator will wait after setting admin permissions on an Office 365 mailbox before proceeding with the migration. For example, the default PropagationDelay=40 tells the program to wait 40 seconds before proceeding. This can be helpful to resolve permissions issues resulting from an O365 Powershell-Exchange propagation delay.
Related Documents