Walkthrough: Upgrading the SFMCCE connector to version 8.0 in Kubernetes

Current version: 8.0

In Kubernetes, you can upgrade the Salesforce Marketing Cloud Content Exchange (SFMCCE) from version 7.0 to version 8.0. SFMCCE 8.0 is compatible with Sitecore 10.3.

Before you upgrade SFMCCE for container 7.0 to SFMCCE for container 8.0 you must:

  • Back up the mssql databases.

This walkthrough describes how to:

  • Build and push the mssql-upgrade image

  • Perform the upgrade

Build and push the mssql-upgrade image

To upgrade SFMCCE you must build an mssql-upgrade image:

  1. Build the images for SFMCCE as explained in the Build the mssql-upgrade image section in Walkthrough: Upgrading the SFMCCE connector to version 8.0 in Docker.

  2. Open the Windows console and use the docker tag command to tag the images. For example:

    RequestResponseshell
    docker tag sitecore-SFMCCE-xp1-cm:<imageVersionTag> $registry/sitecore-sfmcce-xp1-cm:<newTag>
  3. In the console, use the docker push command to push the images to your Azure registry. For example:

    RequestResponseshell
    docker push $registry/sitecore-sfmcce-xp1-cm:<newTag>

Perform the upgrade

To upgrade to SFMCCE 8.0:

  1. Download the Sitecore container deployment package for 10.3 from the Sitecore download page. Extract it to your local workstation with the folder structure intact.

  2. Navigate to the upgrade folder for the Windows version and topology you are using, for example, k8s\ltsc2019\upgrade\xp1. In the kustomization.yaml file, update the images section with newName and newTag of the custom mssql-upgrade image you created and pushed previously.

  3. In the configuration folder, update the secrets files. For more information on the secrets files, please refer to the Installation Guide for Production Environment with Kubernetes guide available on the Sitecore download page.

  4. Download the SFMCCE container deployment package for 8.0 package from the Sitecore download page. Extract it to your local workstation with the folder structure intact. Copy the SFMCBDE\k8s\<windows version>\overrides folder and paste it into the \k8s\<windows version>\ folder in the SXP 10.3 deployment structure.

  5. In the secrets folder in the SXP 10.3 structure, for example, k8s\ltsc2019\overrides\xp1\secrets, update the sitecore-salesforce-content-exchange-connection-string.txt secret file.

  6. Log in to the Azure CLI and set a subscription:

    RequestResponseshell
    az login
    az account set --subscription "Your Subscription"
  7. Get the credentials for the Kubernetes cluster that was created with the AKS cluster by running this command:

    RequestResponseshell
    az aks get-credentials --resource-group <10.3 resource group>--name <10.3 cluster>
  8. Deploy the Sitecore upgrade job by moving to the folder in step 2 where the updated files are and running this command:

    RequestResponseshell
    kubectl apply -k .\
  9. To check if the job has completed, run this command:

    RequestResponseshell
    kubectl get pod
  10. When the upgrade process is completed, you can delete the Kubernetes upgrade job and upgrade secrets. In the console, go to the folder you used in step 2, and run these commands:

    RequestResponseshell
    kubectl delete -f .\
    kubectl delete -k .\
Note

Upgrading with a custom mssql-image includes cleaning up SFMCCE items from the database because SFMCCE 7.0 has moved to using resources files. This requires rebuilding and upgrading the Sitecore role instances cm, xconnect, and xdbsearchworker.

For detailed instructions on how to build and deploy the Sitecore role instances please refer to the Sitecore Upgrade Container Deployment Guide on the Sitecore download page.

Do you have some feedback for us?

If you have suggestions for improving this article,