Walkthrough: Upgrading DCRM on Docker

Download the SXP container deployment 10.3 package from the Sitecore download page. Extract it to a new folder on your local workstation with the folder structure intact. Name the new folder, for example, DCRM8.

Download the DCRM container deployment 8.0 package from the Sitecore download page. Extract it to your local workstation with the folder structure intact. Copy the files in the dcrm\compose\<windows version>\<topology> folder and paste them into the \compose\<windows version>\<topology> folder in the SXP 10.3 deployment structure.

Navigate to your Sitecore 10.2 container deployment folder. Copy the databases from the mssql-data folder and paste them in the Sitecore 10.3 container deployment mssql-data folder.

To deploy Sitecore 10.3, open a PowerShell window with administrator rights, navigate to the SC 10.3 Container deployment folder, and run the following commands:

docker-compose build
docker-compose up

Verify that Sitecore Container 10.3 is up and running successfully.

From the Resource files for Modules 1.0.0 section on the Sitecore download page, download the Dynamics CRM Connect Upgrade resources 1.0.0 package. Extract it to a folder on your local machine.

From the upgrade resources, copy the Dynamics CRM Connect Upgrade resources 1.0.0\7.0.0\Data folder and paste it into the upgrade folder for the Windows version and topology you are using, for example, ltsc2019\upgrade\xp1.

In the DCRM Connect Upgrade resources 1.0.0\7.0.0 folder, create a docker file and name it Dockerfile. In the file, add instructions to point its base image to the 10.2 mssql-upgrade image. The file will look, for example, like this:

ARG BASE_IMAGE= ${SITECORE_DOCKER_REGISTRY} /sxp/sitecore-xp1-mssql-upgrade : tag
FROM ${BASE_IMAGE}
SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]
# Add ? DCRM?  module
COPY <Data folder local path> "C:\data\ResourceItems\10.2\modules"

To build the mssql-upgrade image, open a PowerShell window, navigate to the folder where you placed the Dockerfile, and run the following command:

docker build . -t "<imageName>:<available port number>”

Verify that Docker has created an image with the name you specified.

On your local machine, in a PowerShell window, navigate to the Sitecore Container Deployment 10.3 folder. Navigate to the upgrade folder for the Windows version and topology you are using, for example, ltsc2019\upgrade\xp1.

In the topology folder, run the compose-init.ps1 script. This script updates the environment configuration file with the appropriate values for all the environment variables including the SQL username, SQL password, SQL Server address, and the Sitecore license file.

In the upgrade folder, verify that the upgrade.env file has the correct details. For more details, see the Upgrade Container Deployment Guide for SXP 10.3.0.

In the docker-compose.upgrade.yml file, update the image setting with the mssql-upgrade image you created previously.

Open a new PowerShell window with administrator rights. Navigate to the upgrade directory.

Verify that the mssql container is up and running.

To start the upgrade, run this command:

docker-compose.exe -f .\docker-compose.upgrade.yml --env-file .\upgrade.env up

To check the status of the upgrade, run this command:

docker-compose.exe -f .\docker-compose.upgrade.yml --env-file .\upgrade.env ps

When the upgrade process is completed, you can clean up your environment.

If you ran the upgrade container in Docker Compose, from the Docker Compose folder for the topology that you upgraded, for example, sitecore-xp1, run the following PowerShell cmdlet:

docker-compose.exe -f .\docker-compose.upgrade.yml --env-file .\upgrade.env down