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.
Insights migration
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.
Transcode system migration
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.
Although it is not strictly necessary, we recommend updating existing customers 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.
The main things to be aware of in relation to the transcode system migration are:
Formats that can not be automatically generated (https://digizuite.atlassian.net/wiki/spaces/DD/pages/3710091372/DC+5.10+Formats+-+Migration#Manual-migration).
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.
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 https://digizuite.atlassian.net/wiki/spaces/DD/pages/3804632276/DC+6.0+Formats#Format-visibility for more information on how to control the format visibility.
Automation migration
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.
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>"
, where1
indicates a catalog folder. Similarly, for “Asset Folder Updated Trigger”, a catalog folder is referenced ifto_folder = "1,<id>"
.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.
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')
.
Configuration Management
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.
YouTube Service migration
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 https://digizuite.atlassian.net/wiki/spaces/DD/pages/3804631595/DC+6.0+YouTube+Service#YouTube-client-creation for more information on how to do this.