Install a Sitecore XP pre-release using SIF

Since Sitecore XP 10.1.0, Sitecore distributes pre-releases of the next update release to provide customers with fixes for their hotfix requests. The pre-releases are cumulative, and each pre-release contains all the changes that were implemented in the earlier pre-releases in that series. These pre-releases are then all rolled into the next update release, for example, Sitecore XP 10.1 Update 2.

Every pre-release is based on the latest Sitecore XP release.

For example, if a customer is on Sitecore XP 10.1.0, and we have released Sitecore XP 10.1.1. If the customer requests a hotfix, it is delivered in a pre-release for Sitecore XP 10.1.2. To get this hotfix, the customer must update to Sitecore XP 10.1.1 and then apply the Sitecore XP 10.1.2 pre-release that contains the hotfix.

The pre-releases are available on request from Sitecore Customer Support.

The Sitecore Installation Framework (SIF) is a fully extensible Microsoft® PowerShell module that supports local and remote installations of Sitecore. You can download the templates for a remote deployment from the Sitecore downloads portal.

Since Sitecore XP 10.1.0, you can use SIF to deploy Web Deployment Packages (WDPs). To deploy the WDPs, you must use the same SIF templates that you used to deploy your Sitecore XP solution.

You can use SIF to deploy the pre-releases locally and in distributed solutions.

Deploy a pre-release locally

To deploy a pre-release locally with the <Your topology>-SingleDeveloper.json file:

  1. Download the pre-release and store the WDPs in the same folder as your SIF templates.

  2. Edit the <Your topology>-SingleDeveloper.json file and set the Update parameter to true.

  3. Launch PowerShell as an administrator and in the folder that contains your configuration run the following cmdlet:

    Install-SitecoreConfiguration -Path .\<Your topology>-SingleDeveloper.json
    

To deploy a pre-release locally with the <Your topology>-SingleDeveloper.ps1 deployment script:

  1. Download the pre-release and store the WDPs in the same folder as your SIF templates and the deployment script.

  2. Edit the <Your topology>-SingleDeveloper.ps1 deployment script and set the Update parameter to true.

  3. Launch PowerShell as an administrator and in the folder that contains your configuration run the following cmdlet:

    .\<Your topology>-SingleDeveloper.ps1

Deploy a pre-release remotely

To deploy the WDPs remotely with the <Your topology>-Distributed.json file:

  1. Download the pre-release and store the WDPs in the same folder as your SIF templates.

  2. Edit the <Your topology>-Distributed.json file and set the Update parameter to true.

  3. Launch PowerShell as an administrator and in the folder that contains your configuration run the following cmdlet:

    Install-SitecoreConfiguration -Path .\<Your topology>-Distributed.json

To deploy the WDPs remotely with the Install-<Your topology>-Distributed.ps1 deployment script:

  1. Download the pre-release and store the WDPs in the same folder as your SIF templates and the deployment script.

  2. Edit the Install-<Your topology>-Distributed.ps1 deployment script and set the Update parameter to true.

  3. Launch PowerShell as an administrator and in the folder that contains your configuration run the following cmdlet:

    .\Install-<Your topology>-Distributed.ps1

Deploy a Sitecore XP pre-release WDP for an individual server role

You can use individual templates to deploy the WDPs for each server role separately. You can deploy the WDPs from the pre-release to deploy all the server roles. However, some server roles may require you to pass some extra parameters, such as, Skipdatabases.

To deploy the WDPs to the CM server role:

  1. Edit the template for the CM role - Sitecore-xp1-cm.json, and set the Update parameter to true.

  2. Open PowerShell as an administrator and in the folder that contains your configuration run the following cmdlet:

    Install-SitecoreConfiguration -Path .\<Your topology>-Sitecore-<Your topology>-cm.json