DC 6.0 Upgrade checklist

This page is only relevant when upgrading a customer from a 5.X version to 6.0. Thus, this page is not relevant for new-installs.

Before upgrading existing customers to 6.0, please take a look at the following checklist.

1. Insights migration

   1. When 6.0 is installed, it is no longer possible to migrate data from the old insights system to the new insights system. If data from the old insights system needs to be migrated, this must happen on a 5.X version before upgrading, using the program that can be found here: https://digizuite.atlassian.net/wiki/x/TQHA2.

2. Transcode system migration

   1. In 5.10, a new transcode system was introduced, but the old transcode system could still be used. As described in https://digizuite.atlassian.net/wiki/x/XQDG4g, the old transcode system is completely removed in 6.0.

   2. Existing customers must be upgraded to 5.10 before upgrading to 6.0. The purpose of this is to ensure that the old transcode system is properly migrated to the new transcode system before the old transcode system is removed in the 6.0 update. This is meant as a help for consultants since the data from the old transcode system is then still available. Consequently, it is not necessarily relevant for customers to know about this intermediate step.

   3. The main things to be aware of in relation to the transcode system migration are:

      1. Formats that can not be automatically generated (DC 5.10 Formats - Migration | Manual migration).

      2. Removal of profiles: Renditions are no longer generated based on profiles. Thus, if renditions of the old media format were previously being generated when an asset was published to a specific channel folder, this is no longer the case. Pre-generation can be set up for the new format. However, please carefully consider if this is necessary now that the transcode system supports on-demand transcoding.

      3. Format visibility: In the new transcode system, a format is indicated as downloadable for an asset if it can be generated. In the old transcode system, a format was only indicated as downloadable for an asset if it had already been generated. Please see DC 6.0 Formats | Format visibility for more information on how to control the format visibility.

3. Automation migration

   1. Some automations might reference catalog folders. Since catalog folders are no longer supported in 6.0, these automations must be either deleted or re-written manually before upgrading to 6.0.

      1. Find relevant automations: Catalog folders are typically referenced via the “Move Asset To Folder” action or the “Asset Folder Updated Trigger”. For “Move Asset To Folder”, a catalog folder is referenced if folder = "1,<id>", where 1 indicates a catalog folder. Similarly, for “Asset Folder Updated Trigger”, a catalog folder is referenced if to_folder = "1,<id>".

      2. Automatic cleanup: All OOBE automations that use catalog folders are removed in the 6.0 base layers automatically. Consequently, no manual actions are required for OOBE automations.

      3. If you try to export an automation that references a catalog folder after upgrading to 6.0, you will get an error similar to: Internal error: System.ArgumentOutOfRangeException: Folder with repositorytype 1 was not defined in the custom property serializer (Parameter 'folder').

   2. The “Asset Profile Published” trigger is no longer supported as we no longer have profiles in the system. Automations utilizing this trigger must have a new trigger assigned or simply be deleted before upgrading to 6.0. The new trigger “Asset renditions available” can be used to react to the successful generation of renditions.

4. Configuration Management

   1. As usual, it is highly recommended to ensure that all configuration changes have been exported into a configuration management layer. This is in particular important before upgrading to 6.0, since a lot of unsupported resources have been removed from the base layers.

5. YouTube Service migration

   1. If you have a configured YouTube Client where the GetYoutubeInformation search has been configured to use different metafields than the defaults for “Title” and “Description”, the YouTube client must be re-configured manually after upgrading to 6.0. Please refer to DC 6.0 YouTube Service | YouTube client creation for more information on how to do this.

After upgrading existing customers to 6.0, please take a look at the following checklist.

1. Configuration Management

   1. When calculating a diff, all formats that were previously mapped to a media format will have an update action. These update actions must be exported before applying the desired state to ensure that the formats can still be requested with the old media format ids. This is very important for customers that use connectors such as DAM for Optimizely, DAM for Sitecore, and the Adobe Creative Cloud Connector since links and images embedded before upgrading to 6.0 will otherwise not work. On update, we change the existing mapped media format ids to invalid ids in custom Configuration Management layers (the maximum integer value 2147483647) to force you to remember to do this. The update will fail if you forget to export the format update actions and you have at least one format in a custom layer. The update actions will look something like this:

Open