Description

The current article contains the latest version of the pre-release (hereinafter referred to as the hotfix) that includes all updates currently available for the Sitecore XP 10.1 version. Be aware that the hotfix was built for Sitecore XP 10.1 and must not be installed on other Sitecore XP versions. The hotfix can be applied both to XM and XP Sitecore Experience Platform topologies.

For more details about known issues fixed, refer to the "Sitecore 10.1.x rev. xxxxxx PRE/Documentation/Sitecore.Platform.Releasenotes 10.1.x rev. xxxxxx PRE.md" file found inside the hotfix package.

The hotfix package for Sitecore XP 10.1 can be downloaded from:

Cumulative Hotfix for Sitecore XP 10.1

Important note: Before applying the hotfix, check the corresponding Release notes in later updates available on https://dev.sitecore.net/ and make sure that your issue has not been fixed in the released updates. When fixed, upgrade your instance to the latest Sitecore XP 10.1.x minor update available.

If you are experiencing problems while upgrading the instance or installing the hotfix, contact Sitecore Support.

Solution

To resolve the issue, use one of the following solutions depending on your deployment:

• For on-prem and PaaS:
  
  • On top of any Sitecore XP updates.
  • On top of the latest Sitecore XP update.
• For сontainers:
  
  • Refer to the instructions described here.

Note that the latest version of a hotfix always includes all changes released in its previous versions. Therefore, the latest version of the hotfix can be installed on top of an earlier version of the pre-release for the same minor version of Sitecore XP. For example, you can safely install the "Sitecore 10.1.1 rev. 22222 PRE" version on top of the "Sitecore 10.1.1 rev. 11111 PRE".

Cumulative hotfix on top of any updates

Sitecore 10.1 is out of the Mainstream Support Phase. For this reason, the cumulative hotfix does not contain a fully cumulative hotfix version. The recommended approach is to upgrade to a newer Sitecore version or at least to the latest update for the current version. Otherwise, some of the changes might be missing compared to release versions of the product.

To install the hotfix use the following approach:

1. Check the current version of your solution:
   • Locate the <your_website>/bin/Sitecore.Kernel.dll assembly and check its version (Properties -> Details -> File version).
   package.
   • If the current version is 16.0.74.0 (Sitecore 10.1.3 rev. 009359 PRE) or later, for example, 16.0.80.0 (Sitecore 10.1.3), then use the instructions from Cumulative Hotfix On Top Of The Latest Update instead. Otherwise, proceed to step 2 below.
2. Download Sitecore 10.1.3 rev. 009359 PRE
3. Check the Sitecore 10.1.3 rev. 009359 PRE/Documentation/Sitecore.Platform.Instructions 10.1.3 rev. 009359 PRE.md file and apply instructions if they are required.
4. Install the package from one of the following package folders depending on your deployment:
   
   • For on-prem, from the Sitecore 10.1.3 rev. 009359 PRE/Platform Patch/OnPremCumulative folder.
   • For PaaS, from the Sitecore 10.1.3 rev. 009359 PRE/Platform Patch/CloudCumulative folder.
5. Download the latest hotfix package for Sitecore XP 10.1.
6. Check the Sitecore 10.1.x rev. xxxxxx PRE/Documentation/Sitecore.Platform.Instructions 10.1.x rev. xxxxxx PRE.md file that can contain specific instructions if they are required.
7. Install the hotfix from one of the following package folders depending on your deployment:
   
   • For on-prem, from the Sitecore 10.1.x rev. xxxxxx PRE/Platform Patch/OnPrem folder.
   • For PaaS, from the Sitecore 10.1.x rev. xxxxxx PRE/Platform Patch/Cloud folder.

 

Cumulative hotfix on top of the latest update

A hotfix is installed on top of the latest update release. Ensure your solution runs on the latest Sitecore XP 10.1.x minor update available for Sitecore XP 10.1 on https://dev.sitecore.net/ To install the hotfix:

1. Download the hotfix package for Sitecore XP 10.1.
2. Check the Sitecore 10.1.x rev. xxxxxx PRE/Documentation/Sitecore.Platform.Instructions 10.1.x rev. xxxxxx PRE.md file that can contain specific instructions if they are required.
3. Install the hotfix from one of the following package folders depending on your deployment:
   
   • For on-prem, from the Sitecore 10.1.x rev. xxxxxx PRE/Platform Patch/OnPrem folder.
   • For PaaS, from the Sitecore 10.1.x rev. xxxxxx PRE/Platform Patch/Cloud folder.

For example:

Note that all release numbers are fictitious and are given as an example only.

If the issue has not been fixed in Sitecore XP updates released on https://dev.sitecore.net/ (let's assume they are Sitecore XP 10.1.0-10.1.2), and at the same time, the issue has been fixed in the latest hotfix "Sitecore 10.1.3 rev. 333333 PRE", installation steps could be the following: Upgrade your instance to Sitecore XP 10.1.2 (the latest available minor update on https://dev.sitecore.net/) if you have not installed it before. Download the hotfix package "Sitecore 10.1.3 rev. 333333 PRE". Check the "Sitecore 10.1.3 rev. 333333 PRE/Documentation/Sitecore.Platform.Instructions 10.1.3 rev. 333333 PRE.md" file that can contain specific instructions if they are required Install the hotfix from "Sitecore 10.1.3 rev. 333333 PRE/Platform Patch/Cloud" in case of PaaS solution.