DFS 10.0.0 - Upgrade

Owned by Martin Ulisse
Last updated: Feb 11, 2021

You are about to upgrade from a previous version to DAM for Sitecore (DFS). Which requires your attention.

Things to be aware of before upgrading from a previous version

  • The .net version has been upgrade to 4.7.1
  • Change property DynamicMetadata of AssetMetadata to  IDictionary<string, List<string>> from IDictionary<string, string> to support multivalue like combo and tree fields
  • DFSMediaPipelineArgs was changed to DfsMediaPipelineArgs


Before updating to 10.0.0:

  1. If you are upgrading from DFS 8.x follow this step, otherwise continue to the next step.
    We have removed the member- and role providers in this release. Which means that you have to remove them from Sitecore's web.config.
    1. Navigate to the <membership section and remove the node with the name DefaultDigizuiteMembershipProvider.
    2. In the same section, find the node with the name Sitecore and change the realProviderName to sql.
    3. Navigate to the <roleManager section and remove the node with the name DefaultDigizuiteRoleProvider.
    4. In the same section, find the node with the name Sitecore and change the realProviderName to sql.

  2. Before installing DFS 10.0.0, it is very important that your silo item is backed up. The silo is located at sitecore → Media Library → Digizuite. The installation will remove this item, and all content pages will have broken links until you revert the silo item back to your solution. It is very important that the silo ItemId is the same before and after the installation. 

    1. We recommend using the Package Designer to backup the silo item.


    2. Delete the silo with "Leave links" option

    3. Confirm items under Digizuite have disappeared:

    4. Empty data in dfs_assets_master_index and dfs_assets_web_index. Ensure Solr core replication does not interfere with this (if any).


Updating the module to DFS 10.0.0

  1. Install the new DFS 10.0.0 package and overwrite all when asked.


After updating to DFS 10.0.0:

  1. If you are upgrading from DFS 8.x, follow this step otherwise continue to the next step. Since we removed the DFS membership provider. You have to assign the role sitecore\Digizuite DAM for Sitecore Users to the user extranet\Anonymous. If you don't do this, you won't be able to see any DFS assets on the public website as the anonymous user.

  2. Add the silo item through the Installation Wizard again which you packed in step 2a.

    It is important to delete the data of the index dfs_assets_master_index, before doing a full synchronization of the silo. If you don't do this, the full synchronization will fail.

  3. If you're updating from below 10.0.0, then continue to the following page: DFS 10.0.0 - Keeping the Silo Updated. If not, then you can skip this step.


Now you should be fully done with the update.