Adaptiva Blog

Using Unified Update Platform (UUP) with Adaptiva OneSite

Written by Tom Gibson, Senior Director, Customer Success at Adaptiva | Apr 25, 2023 8:00:52 PM

Unified Update Platform (UUP) became available Tuesday, March 28, 2023. Microsoft has changed how Windows 11, version 22H2 updates will be delivered to use this new Platform. This includes both monthly cumulative updates as well as the feature pack to upgrade devices to Windows 11, version 22H2.

If you do not have the Product Windows 11 enabled, then you can disregard this article. You can check in the ConfigMgr Console by selecting the Administration workspace, Site Configuration, Sites, select the top-most site, on the ribbon, select Configure Site Components, Software Update Point. Select the Products tab and scroll down to Windows or enter the filter Windows 11.

If Windows 11 is checked you will start receiving updates enabled with UUP.

The Cumulative Update for Windows 11 Version 22H2 (KB5023706) will be the first update enabled with UUP. It will be updated and the March 14th update will be superseded.

If you have ADRs, your Software Update Groups and Software Update Deployment Package will be automatically updated at their next scheduled update.

The update will download approximately 10GB. Because you are using OneSite, Adaptiva will also publish this update as a .content file.

KNOWN ISSUES

 
Issue 1:

If you have enabled Byte-Level Patching using this article: Office M365 Byte Level Patching – Adaptiva Support Portal, downloads of UUP-enabled updates will fail for Adaptiva versions prior to 8.1.937.0.

The adaptiva.err log on a targeted device with the Adaptiva Client will show the following:

If you have DP Fallback configured to fallback to the DP when Adaptiva cancels the download AND there is only ONE DP in the PERSISTED_LOCATIONS returned for this update, then Adaptiva will fail the download, the ConfigMgr client will switch the Content Provider from the Alternate Content Provider to the Default provider and download the update from the Distribution Point. It will only download what is needed to update the device. If you have multiple locations returned, the ConfigMgr client will cycle through each of them, asking Adaptiva to perform the download, Adaptiva will continue to fail, until it gets to the end of the list. Only then will it switch to the Default download provider.

Issue 2:

When a client requests a Windows 11 22H2 monthly cumulative update or feature pack with Byte-Level Patching disabled, Adaptiva OneSite will download the entire update. Installation of the monthly cumulative update may succeed after several retry attempts. In our testing, we have seen the installation of the monthly cumulative update succeed if the .content file is downloaded and unpacked in 30 minutes. If that process exceeds 30 minutes, the update will fail. Feature Pack updates will always fail. 

The monthly cumulative update can be staged to targeted clients using a content push policy. 

RESOLUTION

Full support for Microsoft's UUP functionality requires both a server and a client update to version 8.1.937.0 or later. After upgrading the Adaptiva server, update Windows 11 22H2 machines first, then devices that are to be updated to Windows 11 22H2 using the Feature Pack (see the example below). 

Once the server is updated, reference this article: Office M365 Byte Level Patching – Adaptiva Support Portal to enable Byte-Level Patching. Once updated, clients will download approximately 360MB of Blob files from a peer instead of the 10GB content file to apply the monthly Windows 11 22H2 cumulative update. This is equivalent to what the ConfigMgr client would download from a Distribution Point. When deploying the Feature Pack update, clients will download approximately 3.5GB of the 10GB content.

Delta Content Download

This is a ConfigMgr Client Setting and can be found under Software Updates.

There is NO requirement to change this setting, but with Byte Level Patching enabled and the clients updated with 8.1.937.0 or later, this CAN be set to Yes. By setting this to Yes, other Software Updates will create Blobs on request and less content will be downloaded across the WAN and between peers.

NOTE: According to Microsoft, if you are not using ConfigMgr 2203 or later, then this setting must set to Yes.

Blobs

When a ConfigMgr client requests to download a Software Update package, the request given to the Adaptiva client will include a manifest request which will trigger the blob creation. Blobs are 10MB chunks of the Software Update package and are created in the ContentLibrary\Blobs folder and then compressed with an xml file with the hash as a .content file in the ContentLibrary folder. Since the Windows 11 22H2 source update is about 10GB, there will be approx. 1100 blob files created. In my lab this took approx. 35 minutes. It is recommended to use the workflow referenced in the Office 365 Byte Level Patching article.

The fix can be downloaded here: Adaptiva_8.1.937.0.zip

This file is password protected. Please raise a ticket to ticket@adaptiva.com to request the password.

Please upgrade the Server, then upgrade the clients that will be receiving the Windows 11 22H2 updates.

For more information about UUP from Microsoft, please reference these articles:

What’s UUP? New update style coming next week! - Microsoft Community Hub

Unified update platform (UUP) FAQ's - Microsoft Community Hub

As a customer, you can browse over 100 other technical articles in the Customer Support Portal including this article, Using Unified Update Platform (UUP) with Adaptiva OneSite.

To request a login, go to https://adaptiva.com/customers.