Upgrading Content Manager to a new environment
Upgrade Content Manager to a new environment if your existing environment is no longer supported, or because you want to upgrade your environment along with Content Manager.
About this task
This is a broad outline of the upgrade procedure. For a more detailed analysis, contact SDL Professional Services, or one of SDL's partners, to have an upgrade scan performed for you.
Procedure
- Run a pre-upgrade check to discover any and all content in the Content Manager database and Topology Manager database that is no longer supported, by accessing the installation media and running the PowerShell script \Database\DBMS\Pre-Upgrade check Content Manager Database for not supported content.ps1.
- Remove all content reported by that script from the Content Manager database and Topology Manager database. SDL Tridion Sites 9.1 no longer supports legacy content.
- Upgrade your existing Content Manager database and Topology Manager database to an SDL Tridion Sites 9.1 Content Manager database and Topology Manager database.
- Referring to the installation section, perform a fresh SDL Tridion Sites 9.1 Content Manager server and Topology Manager installation on the new machine. As part of running the installer, set up connections to the upgraded Content Manager database and Topology Manager database in the process.
- If you had configured integrated authentication for the Topology Manager database in your old setup, repeat that configuring now.
- On your existing Content Manager server machine, decrypt the encrypted sections of the following files:
- Tridion.ContentManager.config
- The Web.config file of Topology Manager, if modified
- From your existing Content Manager server machine, back up, or make a note of, all non-legacy customizations you have made to Content Manager, specifically:
- Event System code (custom Event Handler DLLs)
- GUI extensions
- Custom Pages
- Custom Multimedia Type icons
- Custom resolvers
- Custom renderers
- Custom transport extensions
- Any custom software that interacts with the Core Service
- Customized PowerShell Modules
- Custom ECL providers
- The ECL configuration file, if modified
- Translation Manager extensions or customizations
- Experience Optimization custom triggers or Cartridges
- The file Tridion.ContentManager.config
- The web application definition file, Web.config, for Topology Manager, if modified
- All changes you have made in the MMC Snap-in
Note that any legacy extensions are not supported in SDL Tridion Sites 9.1, so you cannot migrate these to the new environment.
- Reapply the custom configurations you made in the various configuration files, by comparing each old customized configuration file against its new, out-of-the-box equivalent, and copy-pasting only the customized parts from the old configuration file into the new one. Note that the MMC Snap-in is now a deprecated feature, therefore SDL recommends to reapply any changes you made to its settings directly in the Tridion.ContentManager.config file instead.
- Re-encrypt the sections you had previously decrypted in Tridion.ContentManager.config and Topology Manager's Web.config.
- Restore or reapply the other backed-up customizations on your new Content Manager servers, taking care to check if your code still points to valid URLs (say, of the Core Service). If your Core Service runs on a different host in your new setup, obviously you need to update your custom code URLs as well.
- If your customizations included Custom Pages, do the following:
- On your Content Manager server, go to the subfolder web\WebUI\Editors\CME\Configuration\ of %TRIDION_HOME%.
- Open CME.config for editing.
- Within the
<customconfiguration>element, add the following line:<custompagesfolder xmlns="">Preferences</custompagesfolder> - Save and close CME.config.
- On your SDL Tridion Sites 9.1 installation media folder, go to the folder \Content Manager\Additional Tools\Upgrade Support\.
- Run the Custom Pages migration tool, CustomPagesMigrationTool.exe.
- If your customizations included Custom Multimedia Type icons, run the Multimedia Type Icons migration tool, MultimediaTypeIconsMigrationTool.exe from your SDL Tridion Sites 9.1 installation media folder \Content Manager\Additional Tools\Upgrade Support\.