Quest® Client Profile Updating Utility 5.9.0
Quest® Client Profile Updating Utility 5.9.0
Release Notes
September 2022
These release notes provide information about the Quest® Client Profile Updating Utility release.
Topics:
New features and resolved issues
Known issues
System requirements
Product licensing
Upgrade and installation instructions
About this release
The Client Profile Updating Utility (CPUU) is used to update end-user Microsoft Outlook profiles settings, migrate additional features of user mailboxes and finally switch the profiles from the source to the target Exchange server once the user's mailbox is migrated and switched either manually or by the Migration Manager's Mail Agent.
CPUU supports Microsoft Outlook 2013/2016/2019 and Outlook for Office 365. It can be used only in conjunction with the following products:
- Migration Manager 8.15 or later
- On Demand Migration for Email
Refer to the Supported Configurations for details
New features and resolved issues
This release introduces the following new feature:
End of support for Basic Authentication. Previous releases of CPUU supported Modern Authentication, but relied on the Basic Authentication protocols for access to Autodiscover. This version of CPUU replaces this process with use of a modern Microsoft Authentication library. A future release of CPUU will make further changes to this area, as Microsoft continues to make changes and improvements to authentication libraries and processes.
Two new INI file parameters are provided in case the default authentication URLs need to be overridden, see the CPUU Administrator Guide > Technical Reference for details if necessary.
The "Logon Through Outlook" mode, formerly activated by the -LogonThroughOutlook command line parameter, is now the default behavior. Should it be necessary to disable this behavior for any reason, the new -DisableLogonThroughOutlook command line parameter can be used.
New in 5.8.7 version
The following issue is fixed in this release:
New in 5.8.6 version
This release introduces the following enhancement for CPUU:
- The UPN and primary SMTP address do not need to match if the Manually provide credentials option is selected when using the -LogonThroughOutlook command line parameter. The restrictions for the -LogonThroughOutlook parameter have been updated. Refer to Known Issues for details.
New in 5.8.5 version
This release introduces the following new feature:
- Added Microsoft Windows 11 to Supported Configurations.
New in 5.8.4 version
|
IMPORTANT: After this update is installed, CPUU.ini should be recreated for existing projects due to deprecation of the following configuration parameters:
- BypassModernAuthentication
- CleanupCredentialManager
Or the parameters mentioned above should be removed from existing INI file. |
The following known issues are fixed in this release:
CPUU-1541 |
Addresses two cases where CPUU would fail to open the mailbox store even with -LogonThroughOutlook:
- where UPN was not equal to the user's SMTP address
- when admin credentials were used instead of the user's own credentials.
|
CPUU-1529 |
In the ClientProfileUpdatingUtilityConfiguration Wizard, the Help button on the Encryption Modes dialog now opens the Encryption Modes topic in the help file. |
CPUU-226152 -226161 |
Minor optimizations to performance and stability, to handle unusual edge cases identified by static code analysis. |
New in 5.8.3 version
This release introduced the following new feature:
- Support for migration to Microsoft Office 365 tenants with modern authentication enabled and optionally Multi-Factor Authentication (MFA) enabled.
Previously this functionality was partially supported by means of disabling modern authentication in Outlook settings for the time of profile processing, but this method cannot be used now due to recent changes made by Microsoft in updates for Microsoft Outlook for Office 365 / Outlook 2016 and in Outlook 2019. Now authentication process can be delegated to Outlook that allows Client Profile Updating Utility to access target mailbox with modern authentication and MFA. To enable this behavior the -LogonThroughOutlook command line parameter is introduced in this release. If this parameter is specified in Client Profile Updating Utility command line, Client Profile Updating Utility is allowed to initiate start of Outlook for prompting target user credentials and performing authentication process. Some restrictions may apply. Refer to the Workaround 1 specified in Known Issue CPUU-1266 for details.
The following known issues are fixed in this release:
CPUU-1415 |
Source display name may retain in switched profile on the target in the account properties and in From field.
Fix: Now correct target email address is displayed. |
CPUU-1426 |
Profile cannot be processed, when the Prompt for credentials option is selected in case of source and target user passwords does not match.
Fix: Now profile will be processed in the case of source and target user passwords does not match. |
CPUU-1416 |
In case of unsuccessful access to the target in case the Prompt for credentials option is selected, rollback will be started and CPUU asks for source credentials again.
Fix: Now rollback does not require credentials for the case. |
New in 5.8.2 version
This release introduces the following new feature:
- Quest Migration Manager version 8.15 support.
New in 5.8.1 version
This release introduces the following enhancements for CPUU:
CPUU-1360 |
CPUU disables Autodiscover SCP lookup for all Outlooks by default. DoNotModifyExcludeSCPLookup (previously ExcludeScpLookupNewer) parameter can be used to turn off this behavior, if necessary. |
CPUU-1319 |
Now the Switch Message handling procedure has been optimized, and CPUU uses the following parameters retrieved from the message:
- Version of the Switch Message
- Target mailbox DN
- Target mailbox SMTP address
- Parameter that specified whether the target server is the Office 365 server
The rest of the Switch Message data is skipped. |
CPUU-1327 |
If the source and target domain part of SMTP addresses match, CPUU now checks that the UseLocalAutodiscoverXMLs parameter is set to 1. Otherwise CPUU stops and the error is reported. |
CPUU-1287 |
In case of any issues with getting Autodiscover response for the target Public Folders and Additional mailboxes, CPUU now makes three attempt to get Autodiscover response. |
N/A |
SkipPing is now removed from configuration parameters. |
CPUU-1343 |
Switch Message section format in SwitchResMB.ini is now simplified. It is recommended to re-create configuration files from previous versions of the product, but obsolete SwitchResMB.ini is still workable, you can use whatever you want. |
CPUU-1269 |
Client Profile Updating Utility is now enhanced to pre-check if MAPI is disabled on the target to stop profile processing in this case. As a result, time is saved and redundant errors in log are prevented. |
CPUU-1265 |
Client Profile Updating Utility Configuration wizard may not preserve some advanced tuning settings in case these settings were selected and then cleared. Configuration wizard is now enhanced to avoid the issue. |
CPUU-1371 |
If UseLocalAutodiscoverXMLs=1, target user mailbox and public folders SMTP domain part names are not specified in ProcessedDomainsFQDNs, CPUU now stop processing and the error is reported. |
The following known issues are fixed in this release:
CPUU-1379 |
CPUU cannot process more than one profile at a time if it was launched without the SkipAutodiscoverChecking parameter.
Fix: Now CPUU can process several profiles at the same time. |
CPUU-1380 |
CPUU does not update links pointed to any objects in “Outlook contact groups” for Nicks (Autocomplete list) on the target.
Fix: Now CPUU clears links pointed to any objects in “Outlook contact groups” for Nicks (Autocomplete list) on the target. |
CPUU-1321 |
In case CPUU is redirected to another Autodiscover URL, CPUU repeats Autodiscover URL discovery procedure instead of Autodiscover response usage.
Fix: The value of the stored Autodiscover URL now is updated if the CPUU is redirected to another Autodiscover URL using Autodiscover response. |
CPUU-1317 |
CPUU uses target credentials instead of source credentials for sending notification under a default profile after Rollback.
Fix: CPUU chooses credentials for sending notification depending on result of default profile update. |
CPUU-1292 |
In some rare cases CPUU cannot update AutoComplete List for the processed profile. The following error message is reported: Cannot get Nicks from the source. Unspecified exception….
Fix: Now CPUU makes up to 5 attempts to resolve the recipient in the Address Book in case of an error if Exchange limits are exceeded or some user environment prevents Autocomplete list processing. |
CPUU-1251 |
Public Folder processing may fail for Outlook 2013.
Scope:Migration to Office 365 in case MAPI Over HTTP is disabled (MapiHttpDisabled is set to 1) on the client host.
Fix: Public Folder processing now works for all supported configurations. |
CPUU-254 |
In case the DlgHookHandler.dll is not found this results in log on errors only without any record that this module is missing.
Fix: If Prompt for credentials or Manually provide credentials are selected, before profile processing is started, CPUU checks if DlgHookHandler.dll ( or DlgHookHandler_x64.dll for Outlook x64) is located in the CPUU installation folder (ClientProfileUpdatingUtility.exe/ ClientProfileUpdatingUtility_x64.exe). In case this module not found, CPUU stops and the error is reported. |
New in 5.8 version
This release introduces the following new features and enhancements for CPUU:
- Microsoft Outlook 2019 is now supported by CPUU.
- CPUU can now process profiles across Microsoft's cloud offerings, including tenants in Germany and China.
- MAPI over HTTP support for Outlook 2013 for on-premises migration scenarios
-
Validity of provided service account's credentials is now checked by CPUU before attempting to log to the profiles. The validity check result is reported to log file for troubleshooting purposes.
-
CPUU.ini usability is now improved due to extended Autodiscover usage, the following settings are no longer required because CPUU gets necessary data automatically:
RPCOverHTTP section:
ConnectUsingHTTP
ProxyServer
SSLOnly
MutualAuth
PrincipalName
HTTPFirstOnFast
HTTPFirstOnSlow
AuthType
FirstLogonOverTCP
DomainCfg section:
PublicFolderPrimarySmtpAddress
PublicFolderPrimaryMailboxGuid
TargetO365AutodiscoverEndpoint
Domain
Servers
|
IMPORTANT:Configuration files created in previous versions of CPUU are no longer supported and should be re-created. |
- New configuration parameter ProcessedDomainsFQDNs is now used instead the following obsolete parameters:
-
AutodiscoverDomainsFQDNs
- ApprovedSMTPAddressDomainParts
- T2TDomainNamesOfMailboxesAllowedToSwitch
Now profiles with Multiple Exchange accounts can be configured for processing in configuration wizard.For details see Configuration Parameters section of Client Profile Updating Utility Administrator Guide.
- New management parameter -SkipAutodiscoverChecking is now added to prevent CPUU from checking that an autodiscover URL is on a source domain and a target autodiscover URL is on a target domain. For details see Management Parameters section of Client Profile Updating Utility Administrator Guide.
- RPC over HTTP limited support ( Public Folders processing is not supported) for migration to Office 365 in case of Outlook 2013. For details see Known issues.
This release introduces the following new features and enhancements for Switch Resource Mailboxes utility (SwitchResMB):
- Microsoft Outlook 2019 is now supported by SwitchResMB.
- New configuration parameter LeaveTemporaryProfiles is now added for troubleshooting purposes to prevent deleting of MAPI temporary profiles created by SwitchResMB utility for CPUU. For details see Using the Utility section of Client Profile Updating Utility Administrator Guide.
The following known issues are fixed in this release:
CPUU-1234
4397567-1 |
AutoComplete list (formerly Nicks) processing is now enhanced to support migration in rare case of duplicated nick properties. |
CPUU-1058, 4334806-1 |
Tenant to tenant migration scenario with domain name transfer does not work due to incorrect server name handling. |
CPUU-1056, CPUU-1210 |
CPUU does not restore EnableADAL to original value after Cleanup. |
CPUU-1030,
CPUU-1179,
CPUU-1129 |
Failed to access Autodiscover URL if Negotiate and NTLM are not specified as the first entries in the supported authentication method list returned by the Autodiscover service server.
Scope : Scenarios where Use the currently logged in user option is selected |
New in 5.7.9 version
|
IMPORTANT: Henceforth, we terminate the support of Microsoft Outlook 2007 due to the fact that Microsoft does not support Microsoft Office 2007 since October 2017, but we do not limit the use of Client Profile Updating Utility for Microsoft Outlook 2007 profile switching. |
This release introduces the following new features:
- CPUU-867: ApprovedExchangeDomains parameter is now replaced with ApprovedSMTPAddressDomainParts parameter to process profiles containing multiple Exchange accounts. ApprovedSMTPAddressDomainParts parameter contains selected domain parts of source SMTP addresses in space-separated list to specify which primary accounts are allowed to be switched. See Configuration Parameters for details.
- CPUU-1026: Modern Authentication for Outlook 2013 and 2016 is now bypassed by default while Client Profile Updating Utility process Outlook profiles. See BypassModernAuthentication parameter in Configuration Parameters for details.
CPUU-699 |
Though shared folder matching was unsuccessful, Calendar feature can be displayed as OK. Now the case is handled correctly. |
CPUU-431 |
Client Profile Updating Utility may not preserve last logged on account name in case User principal name (UPN) doesn’t match the email address. Now Client Profile Updating Utility preserves the last logged on account name in such user environments. |
CPUU-108 |
Client Profile Updating Utility may hang in case of incorrect credentials for target service account. |
CPUU-1017 |
In rare cases additional mailbox matching may fail and the following message is displayed:
Cannot match the folder. ...
Reason: Source StoreIDS matching failure. |