Upgrading Sitecore Connect for Content Hub to 5.0 on Sitecore 10.2

Abstract

How to upgrade a Sitecore Connect for Sitecore Content Hub installation to version 5.0 while upgrading Sitecore Experience Platform to 10.2.

This topic describes how to upgrade your installation from Sitecore Connect for Content Hub (SCCH) to 5.0, if you intend to upgrade your Sitecore Experience Platform (SXP) installation to 10.2.

Before you can upgrade SCCH and SXP, you must:

  • Install Sitecore Experience Platform 10.1 or earlier.

  • Install Sitecore Connect for Content Hub 4.0 or earlier.

  • Create backups of your current Sitecore databases.

  • Create a backup copy of the Sitecore folders under wwwroot for your current Sitecore instance.

To upgrade Sitecore and SCCH:

  1. Download the Upgrade Guide for Sitecore Experience Platform for SXP 10.2.0 from the Sitecore download page. Follow the Upgrade Guide to prepare the upgrade and set up the Sitecore.UpdateApp tool. When you get to the Clean the content databases section, perform the following instructions before continuing with the Upgrade Guide.

  2. From the Resource files for Modules page, download the Sitecore Connect for Content Hub Upgrade resources package.

  3. Extract the Sitecore Connect for Content Hub Upgrade resources 1.0.0.zip package to a local directory.

  4. Navigate to the Sitecore Connect for Content Hub Upgrade resources 1.0.0\<version>\Data folder (for the version you are upgrading from), and copy the .dat files that are included in the core, master, and web folders, to the corresponding folder paths under \Sitecore.UpdateApp\. For example:

    • Copy the Data\Items\master\items.master.chub.dat files and paste it in the \Sitecore.UpdateApp\Data\Items\master folder.

    • Copy the Data\Items\core\items.core.chub.dat file, and paste it in the \Sitecore.UpdateApp\Data\Items\core folder.

    • Copy the Data\Items\web\items.web.chub.dat file, and paste it in the \Sitecore.UpdateApp\Data\Items\web folder.

    Note

    Each folder under the path \Sitecore.UpdateApp\Data\Items\ now contains two files, that is, the file you just copied and the items.<master/web/core>.dat file.

  5. For the localization files, navigate to the Sitecore Connect for Content Hub Upgrade resources 1.0.0\<version>\Data folder (for the version you are upgrading from), and copy the .dat language files that are included in the localization subfolders to the corresponding folder paths under \Sitecore.UpdateApp\. For example:

    • Navigate to the Items\core\localization folder, copy all the .dat language files, and paste them in the \Sitecore.UpdateApp\Data\Items\core\localization folder.

    • Navigate to the Items\master\localization folder, copy all the .dat language files, and paste them in the \Sitecore.UpdateApp\Data\Items\master\localization folder.

    • Navigate to the Items\web\localization folder, copy all the .dat language files, and paste them in the \Sitecore.UpdateApp\Data\Items\web\localization folder.

    Note

    If you have more than one Web database, you must repeat Step 4 through Step 5 for every Web database.

    You must update the connection string to each Web database as you run the tool, and not change the connection strings to the other databases.

  6. In the Sitecore.UpdateApp\App_config folder, update the ConnectionStrings.config file with the connections to your databases. If you do not have a security database, use the connection to the core database for the security connection string.

  7. Follow the steps in the Upgrade Guide for Sitecore Experience Platform to run the update tool. Check the logs in the Data\logs folder for detailed information about any modified items that were skipped by the clean up. The update tool displays the number of items it removed in the command prompt window. For example:

    Display from the update tool showing how many resource items have been cleaned up