Client Profile Updating Utility 5.8.1 - Release Notes

Release Notes

Quest® Client Profile Updating Utility 5.8.1

Release Notes

May 2019

These release notes provide information about the Quest® Client Profile Updating Utility release.

Topics:

New features and resolved issues

Known issues

System requirementsSystem requirements

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 2010/2013/2016/2019. It can be used only in conjunction with the following products:

  • Migration Manager 8.14 or later
  • On Demand Migration for Email

Refer to the Supported Configurations for details

Supported Configurations

Supported Configurations

Mail Clients
  • Microsoft Outlook 2010
  • Microsoft Outlook 2013
  • Microsoft Outlook 2016
  • Microsoft Outlook 2019

NOTE: Outlook installed as a part of Office 365 ProPlus suite is supported.

Operating Systems
  • Microsoft Windows 7
  • Microsoft Windows 8
  • Microsoft Windows 8.1
  • Microsoft Windows 10
Additional Software Requirements
  • The Client Profile Updating Utility Configuration wizard requires Microsoft .NET Framework 2.0, 3.0, or 3.5 to be installed.
Important Considerations
  • Processing profiles for Microsoft Virtual Desktop Infrastructure (VDI) environments is not supported.
  • CPUU does not support Outlook installed using application virtualization systems such as Microsoft App-V.
  • Outdated versions of Outlook 2010/2013 which do not support MAPI Over HTTP (KB3085604 and KB3114349) should be updated for migration to Office 365 or to Exchange 2016/2019

New Features

New features and resolved issues

IMPORTANT: After this update is installed, CPUU.ini must be recreated for existing projects due to format changes.

This release introduces the following enhancements for CPUU:

Defect ID Issue Description
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:

Defect ID Issue Description
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 2010 and 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.

Release History

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 2010/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 2010/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:

Defect ID Issue Description

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.
Defect ID Issue Description
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.

セルフ・サービス・ツール
ナレッジベース
通知および警告
製品別サポート
ソフトウェアのダウンロード
技術文書
ユーザーフォーラム
ビデオチュートリアル
お問い合わせ
ライセンスアシスタンス の取得
Technical Support
すべて表示
関連ドキュメント